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 は 2 列目の SerpBase エンドポイントで実行され、料金もそのエンドポイントと同じです。一覧にない engine は 400 で拒否されます。

engine実行先1 回あたりのクレジット
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" です。失敗した検索は課金されません。