검색 결과 페이지의 모든 것을 구조화된 데이터로
4개 엔드포인트를 갖춘 하나의 REST API. 같은 인증, 같은 응답 구조, 같은 크레딧 모델.
GET /api/v1/search
제목, URL, 표시 링크, 스니펫, 출처, 날짜가 포함된 자연 검색 결과. 호출당 최대 100개 결과와 연관 검색어를 제공합니다.
GET /api/v1/images
원본 이미지 URL, 썸네일, 출처 페이지, 픽셀 크기. 호출당 최대 150개.
GET /api/v1/autocomplete
원하는 언어와 시장에서 임의의 접두어에 대한 실시간 검색어 추천.
GET /api/v1/rank
키워드와 도메인을 전달하면 상위 100위 내 순위와 해당 도메인에서 순위에 오른 모든 URL을 반환합니다.
타기팅과 페이지네이션
모든 요청에서 시장, 언어, 깊이, 최신성을 제어하세요.
| q | 검색어, 최대 400자. 따옴표와 site: 같은 연산자를 사용할 수 있습니다. |
| gl | 2자리 국가 코드. 기본값은 US입니다. |
| hl | 인터페이스 및 결과 언어. 기본값은 해당 국가의 주 언어입니다. |
| num | 호출당 결과 수, 10~100. 결과 10개마다 1크레딧이 차감됩니다. |
| page | 결과를 페이지 단위로 넘기기 위한 페이지 번호. |
| time | 기간 필터: 지난 1일, 1주, 1개월, 1년. |
응답 필드
모든 자연 검색 결과에는 다음이 포함됩니다:
organic_results[0]
{
"position": 1,
"title": "The 15 Best Running Shoes of 2026, Tested by Runner’s World",
"link": "https://www.runnersworld.com/gear/a19663621/best-running-shoes/",
"displayed_link": "https://www.runnersworld.com › gear › best-running-shoes",
"source": "runnersworld.com",
"snippet": "Find the best running shoes of 2026, including Runner’s World-tested picks from Adidas, Brooks, New Balance, Nike, …",
"date": "Aug 3, 2026"
}기본으로 갖춘 안정성
- 검색 엔진은 자동화된 트래픽에 오류 대신 관련 없는 결과를 반환하기도 합니다. serpfast는 모든 페이지의 관련성을 확인하고, 결과를 전달하기 전에 재시도합니다.
- 원본 단계에서 실패한 요청은 자동으로 환불되며 명확한 오류 코드와 함께 기록됩니다.
- 속도 제한은 API 키별로 적용되므로, 한 연동의 트래픽이 많아도 다른 연동이 느려지지 않습니다.