ISPプロキシAPI

このAPIを使用して、ISPプロキシIPプールを列挙し、送信元IPホワイトリストを管理します。プロトコルレベルのプロキシ利用方法(host:port、認証情報)については、Products → ISP Proxiesを参照してください。

認証

すべてのエンドポイントはapi_tokenクエリパラメータで認証します。トークンはパネルのAccount → API Tokensで生成してください。

?api_token=YOUR_API_TOKEN

{membership}パスパラメータはプランIDで、パネルのプランページに表示されます。

プロキシ一覧の取得

GET https://shifter.io/api/v1/static-residential/{membership}/proxies

プラン内の固定IPすべてを、共有ポートおよび認証情報とともに返します。ポート(1337)とユーザー名/パスワードはプール全体で共通であり、変わるのはIPのみです。

Parameter	In	Required	Description
`membership`	path	yes	プランID
`api_token`	query	yes	アカウントのAPIトークン

例:

curl "https://shifter.io/api/v1/static-residential/MEMBERSHIP_ID/proxies?api_token=YOUR_API_TOKEN"

レスポンス:

{
  "proxies": [
    {
      "ip": "185.199.108.153",
      "port": 1337,
      "username": "pool-xyz",
      "password": "...",
      "country": "us",
      "asn": 7922,
      "isp": "Comcast",
      "assigned_at": "2026-01-15T12:03:44Z"
    },
    {
      "ip": "185.199.108.154",
      "port": 1337,
      "username": "pool-xyz",
      "password": "...",
      "country": "gb",
      "asn": 5089,
      "isp": "Virgin Media",
      "assigned_at": "2026-01-15T12:03:44Z"
    }
  ]
}

countryフィールドは、そのIPが割り当てられた国のISO 3166-1 alpha-2コードです。ISPプロキシはus、gb、fr、de、es、itで利用可能です。IPが属する国は購入時に一度だけ選択され、その後は固定されます。詳細はCountry setupを参照してください。

許可された送信元IP

送信元IPをホワイトリストに登録すると、スクレイパーは各リクエストでHTTP Basic認証を省略できます。ホワイトリスト登録はアカウント単位であり、ホワイトリストに登録された任意の送信元は、プール内の任意の固定IPを使用できます。

許可されたIPの一覧取得

GET https://shifter.io/api/v1/static-residential/{membership}/authorized-ips

Parameter	In	Required	Description
`membership`	path	yes	プランID
`api_token`	query	yes	アカウントのAPIトークン

レスポンス:

{
  "ips": ["198.51.100.10", "203.0.113.42"]
}

許可されたIPの更新

PUT https://shifter.io/api/v1/static-residential/{membership}/authorized-ips

指定された値で許可されたIPのリストを置き換えます。

Parameter	In	Required	Description
`membership`	path	yes	プランID
`api_token`	query	yes	アカウントのAPIトークン
`ips[]`	body	yes	ホワイトリストに登録するIPv4アドレスの配列

例(フォームエンコード、メソッドオーバーライド使用):

curl -X POST "https://shifter.io/api/v1/static-residential/MEMBERSHIP_ID/authorized-ips?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "_method=PUT&ips[]=198.51.100.10&ips[]=203.0.113.42"

始める

プロキシ

API

リソース