クイックスタート

1分以内に最初のプロキシ経由リクエストを送信しましょう。

1. アカウントを作成してプランを選択する

   shifter.io/order でサインアップし、プランを選択してください。

2. 認証情報を取得する

   クライアントダッシュボード を開き、プロキシのユーザー名とパスワード（Scraping/SERP APIの場合はAPIキー）をコピーしてください。以下のような形式です。

   Username: customer-USERNAME
   Password: 5f8a9c2b1d3e4f6g7h8i
   Gateway:  p.shifter.io:443

3. 最初のリクエストを送信する

   任意のHTTP呼び出しをゲートウェイ経由でルーティングします。ユーザー名にターゲティング情報がエンコードされています。

   curl

   curl -x customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443 \
     https://ipinfo.io/json

   Python

   import requests
   
   proxy = "customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443"
   proxies = {"http": proxy, "https": proxy}
   
   r = requests.get("https://ipinfo.io/json", proxies=proxies)
   print(r.text)

   Node.js

   import fetch from 'node-fetch';
   import { HttpsProxyAgent } from 'https-proxy-agent';
   
   const agent = new HttpsProxyAgent(
     'customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443'
   );
   
   const res = await fetch('https://ipinfo.io/json', { agent });
   console.log(await res.text());

   TypeScript

   import axios from 'axios';
   import { HttpsProxyAgent } from 'https-proxy-agent';
   
   const agent = new HttpsProxyAgent(
     'customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443'
   );
   
   const { data } = await axios.get<string>('https://ipinfo.io/json', {
     httpAgent: agent,
     httpsAgent: agent,
   });
   
   console.log(data);

   JavaScript

   const fetch = require('node-fetch');
   const { HttpsProxyAgent } = require('https-proxy-agent');
   
   const agent = new HttpsProxyAgent(
     'customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443'
   );
   
   fetch('https://ipinfo.io/json', { agent })
     .then((r) => r.text())
     .then(console.log);

   Go

   package main
   
   import (
     "fmt"
     "io"
     "net/http"
     "net/url"
   )
   
   func main() {
     proxyURL, _ := url.Parse("customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443")
     client := &http.Client{
       Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)},
     }
   
     resp, _ := client.Get("https://ipinfo.io/json")
     defer resp.Body.Close()
     body, _ := io.ReadAll(resp.Body)
     fmt.Println(string(body))
   }

   Rust

   use reqwest::blocking::Client;
   use reqwest::Proxy;
   
   fn main() -> Result<(), Box<dyn std::error::Error>> {
       let proxy = Proxy::all("http://p.shifter.io:443")?
           .basic_auth("customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600", "PASSWORD");
   
       let client = Client::builder().proxy(proxy).build()?;
       let body = client.get("https://ipinfo.io/json").send()?.text()?;
       println!("{body}");
       Ok(())
   }

   Java

   import java.net.*;
   import java.net.http.*;
   
   public class Main {
       public static void main(String[] args) throws Exception {
           HttpClient client = HttpClient.newBuilder()
               .proxy(ProxySelector.of(new InetSocketAddress("p.shifter.io", 443)))
               .authenticator(new Authenticator() {
                   protected PasswordAuthentication getPasswordAuthentication() {
                       return new PasswordAuthentication(
                           "customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600",
                           "PASSWORD".toCharArray()
                       );
                   }
               })
               .build();
   
           HttpRequest req = HttpRequest.newBuilder(URI.create("https://ipinfo.io/json")).build();
           HttpResponse<String> res = client.send(req, HttpResponse.BodyHandlers.ofString());
           System.out.println(res.body());
       }
   }

   C#

   using System.Net;
   using System.Net.Http;
   
   var handler = new HttpClientHandler
   {
       Proxy = new WebProxy("http://p.shifter.io:443")
       {
           Credentials = new NetworkCredential(
               "customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600",
               "PASSWORD"
           )
       },
       UseProxy = true
   };
   
   using var client = new HttpClient(handler);
   var ip = await client.GetStringAsync("https://ipinfo.io/json");
   Console.WriteLine(ip);

   PHP

   <?php
   require 'vendor/autoload.php';
   
   $client = new GuzzleHttp\Client([
       'proxy' => 'customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443',
   ]);
   
   $res = $client->get('https://ipinfo.io/json');
   echo $res->getBody();

4. 国、セッション、ISPを指定する

   パラメータを使用して、地域、セッション、ルーティングを制御します。

   Parameter	Example	Effect
   country-XX	customer-USERNAME-country-de	ドイツ経由でルーティングする
   region-NAME	customer-USERNAME-region-california	特定の地域/州をターゲットにする
   city-NAME	customer-USERNAME-city-new_york	特定の都市をターゲットにする
   asn-NUMBER	customer-USERNAME-asn-7922	特定のASNをターゲットにする
   sid-ID	customer-USERNAME-sid-abc	スティッキーセッション（デフォルトのTTLである120秒間、同じIPを保持する）
   ttl-SECONDS	customer-USERNAME-sid-abc-ttl-600	スティッキーセッションのTTLを秒単位でカスタム指定する（sidが必要）
   strict-true	customer-USERNAME-country-us-strict-true	より広いプールへのフォールバックを行わず、502で失敗する

次のステップ

• Authentication - APIキーとユーザー名/パスワードの違い
• Choosing a product - 最適なShifter製品の選び方
• API Reference - すべてのRESTエンドポイントとすべてのパラメータ