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만 변경됩니다.

매개변수	위치	필수 여부	설명
`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

매개변수	위치	필수 여부	설명
`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 목록을 제공된 값으로 교체합니다.

매개변수	위치	필수 여부	설명
`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

리소스