IPKite

プロキシAPIドキュメントと接続方法

IPKite住宅用プロキシをコードやツールに接続する方法、および残高・購入履歴・プロキシ一覧を照会する開発者APIを例とともにまとめました。

APIキー取得

居住用プロキシクイックスタート

住宅用プロキシを購入すると、会員画面にプロキシユーザー名とパスワードが表示されます。接続先は1つで、ユーザー名に付加する値で国、都市、セッションを指定します。以下のコマンド1行で接続をすぐに確認できます。

  • 購入: 会員画面で希望のGB数を選んで住宅用プロキシを購入します。
  • 確認: 会員画面でプロキシユーザー名(USERNAME)とパスワード(PASSWORD)を確認します。
  • 接続: gw.ipkite.comアドレスとHTTP 7000番またはSOCKS5 7100番ポートでリクエストを送信します。
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/

プロキシ接続情報形式

全ての住宅用プロキシ接続は同じアドレスを使用します。HTTPとHTTPSリクエストは7000番ポート、SOCKS5接続は7100番ポートで送信します。ユーザー名の後にハイフン(-)でパラメータを連結し、パラメータは必要なものだけ選択して使用します。

項目価格説明
住所gw.ipkite.com全ての住宅用プロキシ接続の接続アドレス
HTTP・HTTPSポート7000HTTPプロキシでHTTPとHTTPSサイトに接続
SOCKS5ポート7100SOCKS5をサポートするツールやアプリで接続
cc2文字の国コード（小文字）例: cc-us, cc-gb, cc-de
city都市名（小文字、スペースなし）例: city-newyork, city-london
sess英数字セッション名同じ値を使用している間は同じIPを維持
ttl1~1,440(分)固定セッションを維持する時間
USERNAME-cc-us-city-newyork-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000

ローテーションプロキシと固定セッション例

ユーザー名にsess値を付けないとリクエストごとに新IPが割り当てられるローテーションプロキシとして動作します。sessとttlを付けるとttlで指定した時間(1～1,440分)同じIPが維持される固定セッションになります。新IPが必要な時はsess値だけ変更します。

curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/

国・都市ターゲティング例

ccパラメータで174カ国・地域の中から1つを選び、cityパラメータで主要都市まで絞り込めます。国・都市ターゲティングは回転と固定セッション両方に一緒に使えます。

curl -x http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000 https://example.com/

Python requestsプロキシ例

Python requestsではproxies値にHTTPとHTTPS両方同じプロキシアドレスを入れます。SOCKS5で接続するにはrequests[socks]を一緒にインストールし、アドレスをsocks5h://に変更します。

import requests

proxy = "http://USERNAME-cc-us-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000"
proxies = {"http": proxy, "https": proxy}

r = requests.get("https://example.com/", proxies=proxies, timeout=30)
print(r.status_code)

Node.jsプロキシ例

Node.jsではundiciのProxyAgentやhttps-proxy-agentパッケージで接続します。どちらの方法もプロキシアドレス1行だけ入れればOKです。

import { ProxyAgent, fetch } from "undici";

const agent = new ProxyAgent("http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000");
const res = await fetch("https://example.com/", { dispatcher: agent });
console.log(res.status);

開発者API認証と基本アドレス

開発者APIはREST方式で、すべてのレスポンスはJSONです。アカウント画面でAPIキーを発行すると、ipk_live_で始まるキーが一度だけ表示されるので、すぐに安全な場所に保存してください。すべてのリクエストのAuthorizationヘッダーにBearerとAPIキーを入れて送信します。

  • 基本アドレス: https://ipkite.com/api/v1
  • 認証ヘッダー: Authorization: Bearer <APIキー>
  • 呼び出し制限: 1分あたり120回
  • 応答形式: JSON、成功時は"ok": true
curl https://ipkite.com/api/v1/balance \
  -H "Authorization: Bearer ipk_live_YOUR_API_KEY"

開発者APIエンドポイント

メソッドパス内容主要応答値
GET/balance現在の残高balance, currency
GET/orders購入履歴一覧code, product, summary, amount, status, created_at
GET/proxies購入したプロキシ一覧住宅用: username, password, host, http_port, socks_port, traffic_gb_left / 固定IP: ip, port, username, password, country, expires_at
{"ok":true,"balance":"25.00","currency":"USD"}

APIエラー応答と呼び出し制限

APIキーがないか、一致しない場合、HTTP 401とともに以下の応答が返されます。ヘッダー名とBearerの後のスペース、キー全体が含まれているか確認してください。呼び出し制限は1分あたり120回で、残高や残りのトラフィックを定期的に確認する際は、1分に1回程度で照会すれば制限内で余裕を持って使用できます。

{"ok":false,"error":"unauthorized"}
プロキシAPIドキュメント、住宅用プロキシ接続方法とコード例のまとめ | IPKite