ISP 프록시 API

이 API를 사용하여 ISP 프록시 IP 풀을 열람하고 소스 IP 화이트리스트를 관리하세요. 프로토콜 수준의 프록시 사용법(host:port, 자격 증명)은 Products → ISP Proxies를 참조하세요.

인증

모든 엔드포인트는 api_token 쿼리 매개변수로 인증합니다. 패널의 Account → API Tokens에서 토큰을 생성하세요.

?api_token=YOUR_API_TOKEN

{membership} 경로 매개변수는 두 형식을 모두 지원합니다. 플랜의 숫자 ID(패널의 플랜 페이지에 표시되는 번호) 또는 API ID(패널의 플랜 URL 끝에 있는 짧은 코드, 예: https://shifter.io/panel/membership/DeeJ)입니다. 둘 다 같은 플랜을 가리킵니다.

프록시 목록 조회

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

플랜에 고정된 모든 IP를 공유 포트 및 자격 증명과 함께 반환합니다. 동일한 포트(1337)와 동일한 사용자 이름/비밀번호가 풀 전체에 적용되며, IP만 변경됩니다.

매개변수	위치	필수 여부	설명
`membership`	path	yes	플랜 ID(숫자 또는 API ID)
`api_token`	query	yes	계정 API 토큰

예시:

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

응답:

{
  "error": null,
  "code": 200,
  "data": [
    "185.199.108.153:1337",
    "185.199.108.154:1337",
    "185.199.108.155:1337"
  ]
}

각 항목은 ip:port 형식입니다. 포트(1337)와 사용자 이름/비밀번호는 풀의 모든 IP에서 동일하며 IP만 달라집니다. 자격 증명은 패널의 My Plans → ISP Proxies에서 확인할 수 있습니다. ISP 프록시는 미국, 캐나다, 영국, 프랑스, 독일, 스페인, 이탈리아에서 제공됩니다. IP의 국가는 구매 시 한 번 선택되며 이후 고정됩니다. 국가 설정을 참조하세요.

승인된 소스 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 토큰

응답:

{
  "error": null,
  "code": 200,
  "data": [
    "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/YOUR_PLAN_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

리소스