SerpBase

SerpApi 호환 엔드포인트

SerpApi용으로 작성한 코드는 기본 URL만 바꾸면 동작합니다. engine 이름, 매개변수, 응답 필드는 같고 가격은 SerpBase 기준입니다.

전환 방법

https://serpapi.com/search.json을 아래 URL로 바꾸고 api_key에 SerpBase 키를 넣으세요. SerpApi처럼 GET 요청입니다. 키는 X-API-Key 헤더로도 보낼 수 있어 URL과 로그에 남지 않습니다.

BASH
curl "https://api.serpbase.dev/google/serpapi/search.json?engine=google&q=coffee&gl=us&hl=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.serpbase.dev/google/serpapi/search.json?engine=amazon&k=headphones&amazon_domain=amazon.com" \
  -H "X-API-Key: YOUR_API_KEY"
PYTHON
import requests

res = requests.get(
    "https://api.serpbase.dev/google/serpapi/search.json",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"engine": "google_news", "q": "semiconductors", "gl": "us"},
)
print(res.json()["news_results"][0]["title"])

지원 engine

각 engine은 두 번째 열의 SerpBase 엔드포인트에서 실행되며 가격도 같습니다. 목록에 없는 engine은 400으로 거부됩니다.

engine실행 엔드포인트요청당 크레딧
googleGoogle Web Search1
google_imagesGoogle Images Search1
google_newsGoogle News Search1
google_videosGoogle Videos Search1
google_autocompleteGoogle Search Autocomplete1
google_shoppingGoogle Shopping Search2
google_jobsGoogle Jobs Search2
google_patents_detailsGoogle Patent Details2
google_playGoogle Play Search1
google_play_productGoogle Play App Details1
google_trendsGoogle Trends2
google_trends_autocompleteGoogle Trends Autocomplete2
google_trends_trending_nowGoogle Trends Trending Now2
google_mapsGoogle Maps Search2
google_maps_reviewsGoogle Maps Reviews2
duckduckgoDuckDuckGo Search1
youtubeYouTube Search1
youtube_video_transcriptYouTube Video Transcripts2
amazonAmazon Product Search2
amazon_productAmazon Product Details2
amazon_autocompleteAmazon Search Autocomplete1
walmartWalmart Product Search2
walmart_productWalmart Product Details2
ebayeBay Product Search1
ebay_producteBay Product Details2
apple_productApple Product Details1

SerpApi와 다른 점

  • SerpBase가 추출한 필드를 SerpApi 이름으로 반환합니다. SerpBase에 없는 필드는 추측해 채우지 않고 생략하므로 읽기 전에 키가 있는지 확인하세요.
  • 미지원: output=html(engine=google 제외), google_maps 장소 상세(/google/maps/detail 사용), TIMESERIES 외 google_trends data_type, apps 외 Play 스토어, SerpApi 계정·보관·비동기 API. no_cache, async, json_restrictor는 받지만 효과는 없습니다.
  • 오류는 SerpApi와 같습니다. 거부된 요청은 400, 401, 429와 {"error": …}, 실행했지만 실패한 검색은 200과 search_metadata.status "Error"입니다. 실패한 검색은 과금되지 않습니다.