IPKite

프록시 API 문서와 연결 방법

IPKite 주거용 프록시를 코드와 도구에 연결하는 방법, 그리고 잔액·구매 내역·프록시 목록을 조회하는 개발자 API를 예제와 함께 정리했어요.

API 키 받기

주거용 프록시 빠른 시작

주거용 프록시를 구매하면 회원 화면에 프록시 사용자 이름과 비밀번호가 표시돼요. 접속 주소는 하나이고, 사용자 이름에 붙이는 값으로 나라, 도시, 세션을 정해요. 아래 명령 한 줄로 연결을 바로 확인할 수 있어요.

  • 구매: 회원 화면에서 원하는 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를 지원하는 도구와 앱에서 연결
cc두 글자 나라 코드(소문자)예: 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개 나라·지역 가운데 하나를 고르고, 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 패키지로 연결해요. 두 방법 모두 프록시 주소 한 줄만 넣으면 돼요.

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분에 한 번 정도로 조회하면 한도 안에서 넉넉히 쓸 수 있어요.

{"ok":false,"error":"unauthorized"}
프록시 API 문서, 주거용 프록시 연결 방법과 코드 예제 모음 | IPKite