POST JSON リクエストを送り、X-API-Key ヘッダーで API key を渡します。成功時も失敗時も JSON を返します。
共通レスポンス構造
成功リクエストごとに 1 または 2 クレジット
support trace id
curl -X POST https://test-api.serpbase.dev/google/search \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{"q":"openai realtime api","hl":"en","gl":"us"}'成功レスポンスは同じトップレベルメタデータを返します。エンドポイント固有のデータは organic、images、news、videos、places、place などに入ります。
statusnumber必須
ビジネスステータスコード。0 は成功です。
request_idstring必須
サポート、リトライ、ログ照合に使うリクエスト ID。
elapsed_msnumber必須
ゲートウェイが観測したレイテンシ。単位はミリ秒。
credits_chargednumber必須
返金ロジック適用後に課金されたクレジット数。
search_typestring必須
解決済みタイプ: search、images、news、videos、maps_search、maps_detail。
/google/searchGoogle 形式の自然検索結果とリッチ SERP モジュール。
/google/images画像 URL、サムネイル、参照元ページ、ドメイン。
/google/news配信元、時刻テキスト、スニペット、サムネイル付きニュース記事。
/google/videosソース、長さ、時刻、サムネイル付き動画結果。
/google/maps/search座標、連絡先、カテゴリ、営業時間、写真を含むローカル地点検索。
/google/maps/detailGoogle Maps feature_id による単一地点の詳細。
/google/searchSearch
Google 形式の自然検索結果とリッチ SERP モジュール。
qstring必須
検索クエリ文字列。
hlstring任意
言語コード。デフォルトは en。
glstring任意
国コード。デフォルトは us。
pagenumber任意
1 始まりのページ番号。デフォルトは 1。
querystring必須
リクエストから正規化されたクエリ。
pagenumber必須
現在の 1 始まりのページ番号。
organicOrganicResult[]When organic results are parsed.
Organic search results.
top_storiesTopStory[]When the SERP contains top stories.
Top stories module.
people_also_askPAA[]When People Also Ask is present.
Question, answer, and source links.
knowledge_graphKnowledgeGraphWhen a knowledge panel is parsed.
Entity panel data.
related_searchesstring[]When related search suggestions are found.
Related search queries.
ranknumber必須
このレスポンス内の 1 始まりの順位。
positionnumber利用可能な場合は rank のエイリアス。
position を期待するクライアント向けの正規化順位。
titlestring必須
結果タイトル。
linkstring必須
parser が返す主リンク。
urlstring結果リンクを正規化できる場合に返ります。
正規化されたターゲット URL。通常は link と同じです。
source_urlstringGoogle のリダイレクト元 URL がある場合のみ返ります。
デバッグと出所確認のために保持される元の Google URL。
display_urlstringGoogle の表示テキストまたはドメインを取得できる場合。
表示 URL またはソースドメイン。
display_linkstringWhen Google display text is present.
Raw Google display link text.
snippetstringWhen a snippet is parsed.
Organic result summary.
datestringWhen Google includes a date in the snippet.
Raw date text extracted from snippet.
published_atstringAlias for parsed date when available.
Normalized date alias.
iconstringWhen a favicon/image is exposed.
Result icon URL.
sitelinks{ title, link, url, source_url?, display_url? }[]When sitelinks are present.
Nested sitelinks for the organic result.
curl -X POST https://test-api.serpbase.dev/google/search \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "python asyncio",
"hl": "en",
"gl": "us",
"page": 1
}'検索 grounding、SEO チェック、回答抽出。
Search can also return ai_overview, weather, finance, flight, and result_stats when those modules appear in the SERP.
/google/images画像検索
画像 URL、サムネイル、参照元ページ、ドメイン。
qstring必須
検索クエリ文字列。
hlstring任意
言語コード。デフォルトは en。
glstring任意
国コード。デフォルトは us。
pagenumber任意
1 始まりのページ番号。デフォルトは 1。
querystring必須
リクエストから正規化されたクエリ。
pagenumber必須
現在の 1 始まりのページ番号。
imagesImageResult[]When image results are parsed.
Google Images results.
ranknumber必須
このレスポンス内の 1 始まりの順位。
positionnumber利用可能な場合は rank のエイリアス。
position を期待するクライアント向けの正規化順位。
titlestring画像タイトルまたは alt テキストを解析できる場合。
結果タイトル。
linkstring必須
parser が返す主リンク。
urlstring結果リンクを正規化できる場合に返ります。
正規化されたターゲット URL。通常は link と同じです。
source_urlstringGoogle のリダイレクト元 URL がある場合のみ返ります。
デバッグと出所確認のために保持される元の Google URL。
display_urlstringGoogle の表示テキストまたはドメインを取得できる場合。
表示 URL またはソースドメイン。
image_urlstring必須
Full image URL.
thumbnail_urlstringGoogle がサムネイルを公開している場合。
サムネイル URL。
thumbnailstring利用可能な場合は thumbnail_url のエイリアス。
正規化されたサムネイルエイリアス。
sourcestringWhen source text is parsed.
Image source label.
domainstringWhen source page domain can be derived.
Source page domain.
curl -X POST https://test-api.serpbase.dev/google/images \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "iphone 15 pro blue",
"hl": "en",
"gl": "us",
"page": 1
}'ビジュアル検索、商品監視、画像ソース発見。
Some Google Images payload shapes expose rank/link but not every normalized alias. Treat url, display_url, source_url, position, and thumbnail as optional.
/google/newsニュース検索
配信元、時刻テキスト、スニペット、サムネイル付きニュース記事。
qstring必須
検索クエリ文字列。
hlstring任意
言語コード。デフォルトは en。
glstring任意
国コード。デフォルトは us。
pagenumber任意
1 始まりのページ番号。デフォルトは 1。
querystring必須
リクエストから正規化されたクエリ。
pagenumber必須
現在の 1 始まりのページ番号。
newsNewsResult[]When news results are parsed.
Google News results.
ranknumber必須
このレスポンス内の 1 始まりの順位。
positionnumber利用可能な場合は rank のエイリアス。
position を期待するクライアント向けの正規化順位。
titlestring必須
結果タイトル。
linkstring必須
parser が返す主リンク。
urlstring結果リンクを正規化できる場合に返ります。
正規化されたターゲット URL。通常は link と同じです。
source_urlstringGoogle のリダイレクト元 URL がある場合のみ返ります。
デバッグと出所確認のために保持される元の Google URL。
display_urlstringGoogle の表示テキストまたはドメインを取得できる場合。
表示 URL またはソースドメイン。
sourcestringWhen publisher text is parsed.
Publisher/source label.
timestringWhen Google exposes time text.
Raw published time text.
published_atstringAlias for parsed time when available.
Normalized published time alias.
snippetstringWhen a snippet is parsed.
Article summary snippet.
thumbnail_urlstringGoogle がサムネイルを公開している場合。
サムネイル URL。
thumbnailstring利用可能な場合は thumbnail_url のエイリアス。
正規化されたサムネイルエイリアス。
curl -X POST https://test-api.serpbase.dev/google/news \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "apple event",
"hl": "en",
"gl": "us",
"page": 1
}'ブランド監視、トレンド追跡、メディア発見。
Source and time are parsed from compact Google metadata text, so clients should treat both as optional.
/google/videos動画検索
ソース、長さ、時刻、サムネイル付き動画結果。
qstring必須
検索クエリ文字列。
hlstring任意
言語コード。デフォルトは en。
glstring任意
国コード。デフォルトは us。
pagenumber任意
1 始まりのページ番号。デフォルトは 1。
querystring必須
リクエストから正規化されたクエリ。
pagenumber必須
現在の 1 始まりのページ番号。
videosVideoResult[]When video results are parsed.
Google Videos results.
ranknumber必須
このレスポンス内の 1 始まりの順位。
positionnumber利用可能な場合は rank のエイリアス。
position を期待するクライアント向けの正規化順位。
titlestring必須
結果タイトル。
linkstring必須
parser が返す主リンク。
urlstring結果リンクを正規化できる場合に返ります。
正規化されたターゲット URL。通常は link と同じです。
source_urlstringGoogle のリダイレクト元 URL がある場合のみ返ります。
デバッグと出所確認のために保持される元の Google URL。
display_urlstringGoogle の表示テキストまたはドメインを取得できる場合。
表示 URL またはソースドメイン。
sourcestringWhen source/channel can be parsed.
Video source or channel label.
durationstringWhen duration appears in result text.
Video duration text.
timestringWhen posted time can be parsed.
Raw posted time text.
published_atstringAlias for parsed time when available.
Normalized posted time alias.
thumbnail_urlstringGoogle がサムネイルを公開している場合。
サムネイル URL。
thumbnailstring利用可能な場合は thumbnail_url のエイリアス。
正規化されたサムネイルエイリアス。
curl -X POST https://test-api.serpbase.dev/google/videos \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "python asyncio tutorial",
"hl": "en",
"gl": "us",
"page": 1
}'動画検索、チュートリアル発見、メディア監視。
If no dedicated video cards are parsed, the parser falls back to news-style extraction for compatible Google layouts.
/google/maps/searchMaps 検索
座標、連絡先、カテゴリ、営業時間、写真を含むローカル地点検索。
qstring必須
検索クエリ文字列。
hlstring任意
言語コード。デフォルトは en。
glstring任意
国コード。デフォルトは us。
pagenumber任意
1 始まりのページ番号。デフォルトは 1。
latnumber任意
地図中心の緯度。lng と一緒に送信します。
lngnumber任意
地図中心の経度。lat と一緒に送信します。
zoomnumber任意
地図ズーム。1 から 21。座標指定時のデフォルトは 14。
querystring必須
リクエストから正規化されたクエリ。
pagenumber必須
現在の 1 始まりのページ番号。
placesMapsPlace[]When local places are parsed.
Local place results.
positionnumberMaps Search only.
Place rank in the local result list.
namestring必須
Place name.
titlestring必須
Alias for name.
feature_idstring必須
Google Maps feature id.
place_idstringWhen Google exposes it.
Google place id.
data_idstringAlias for feature_id.
Maps data id.
cidstringDerived from feature_id when possible.
Google CID.
kgmidstringWhen present in Maps payload.
Knowledge graph machine id.
google_maps_urlstringWhen Google exposes a Maps URL.
Google Maps URL.
urlstringgoogle_maps_url or website fallback.
Primary place URL.
ratingnumberWhen rating is present.
Google rating.
typesstring[]When categories are present.
Place type labels.
categoryobjectWhen category block is parsed.
Structured category data.
addressstringWhen address is present.
Formatted address.
address_componentsobjectWhen components are present.
Street, city, postal code, country code.
plus_codeobjectWhen plus code is present.
Global and compound plus codes.
phonestringWhen phone is present.
Local phone number.
phone_internationalstringWhen present.
International phone number.
phone_uristringWhen present.
Telephone URI.
websitestringWhen website is present.
Business website.
website_domainstringWhen website domain is present.
Business website domain.
latitudenumberWhen coordinates are present.
Latitude.
longitudenumberWhen coordinates are present.
Longitude.
imagestringWhen image is present.
Primary place image.
thumbnailstringAlias for image when available.
Primary image alias.
photosMapsPhoto[]When photos are parsed.
Photo id, URL, size, and optional coordinates.
hoursRecord<string,string>When hours are parsed.
Opening hours by day.
open_statusobjectWhen status is present.
Open status text and current hours.
attributesobject[]When attributes are parsed.
Grouped place attributes.
related_placesobject[]When related places are present.
Related places from Maps payload.
short_descriptionstringWhen description block is present.
Short place description.
descriptionstringWhen description block is present.
Longer place description.
snippetstringshort_description or description fallback.
Normalized text summary.
timezonestringWhen present.
Place timezone.
regionstringWhen present.
Region label.
country_codestringWhen present.
Country code.
languagestringWhen present.
Language code from Maps payload.
curl -X POST https://test-api.serpbase.dev/google/maps/search \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "coffee",
"hl": "en",
"gl": "us",
"page": 1,
"lat": 37.7749,
"lng": -122.4194,
"zoom": 14
}'ローカル発見、店舗検索、地域別監査。
lat and lng must be sent together. zoom is valid only with coordinates and defaults to 14.
/google/maps/detailMaps 詳細
Google Maps feature_id による単一地点の詳細。
feature_idstring必須
Google Maps feature id。形式は 0x...:0x...。
hlstring任意
言語コード。デフォルトは en。
glstring任意
国コード。デフォルトは us。
feature_idstring必須
Feature id resolved from the Maps detail request.
pagenumber必須
Always 1 for maps detail.
placeMapsPlaceWhen place details are parsed.
Single place detail object.
positionnumberMaps Search only.
Place rank in the local result list.
namestring必須
Place name.
titlestring必須
Alias for name.
feature_idstring必須
Google Maps feature id.
place_idstringWhen Google exposes it.
Google place id.
data_idstringAlias for feature_id.
Maps data id.
cidstringDerived from feature_id when possible.
Google CID.
kgmidstringWhen present in Maps payload.
Knowledge graph machine id.
google_maps_urlstringWhen Google exposes a Maps URL.
Google Maps URL.
urlstringgoogle_maps_url or website fallback.
Primary place URL.
ratingnumberWhen rating is present.
Google rating.
typesstring[]When categories are present.
Place type labels.
categoryobjectWhen category block is parsed.
Structured category data.
addressstringWhen address is present.
Formatted address.
address_componentsobjectWhen components are present.
Street, city, postal code, country code.
plus_codeobjectWhen plus code is present.
Global and compound plus codes.
phonestringWhen phone is present.
Local phone number.
phone_internationalstringWhen present.
International phone number.
phone_uristringWhen present.
Telephone URI.
websitestringWhen website is present.
Business website.
website_domainstringWhen website domain is present.
Business website domain.
latitudenumberWhen coordinates are present.
Latitude.
longitudenumberWhen coordinates are present.
Longitude.
imagestringWhen image is present.
Primary place image.
thumbnailstringAlias for image when available.
Primary image alias.
photosMapsPhoto[]When photos are parsed.
Photo id, URL, size, and optional coordinates.
hoursRecord<string,string>When hours are parsed.
Opening hours by day.
open_statusobjectWhen status is present.
Open status text and current hours.
attributesobject[]When attributes are parsed.
Grouped place attributes.
related_placesobject[]When related places are present.
Related places from Maps payload.
short_descriptionstringWhen description block is present.
Short place description.
descriptionstringWhen description block is present.
Longer place description.
snippetstringshort_description or description fallback.
Normalized text summary.
timezonestringWhen present.
Place timezone.
regionstringWhen present.
Region label.
country_codestringWhen present.
Country code.
languagestringWhen present.
Language code from Maps payload.
curl -X POST https://test-api.serpbase.dev/google/maps/detail \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"feature_id": "0x8085809c2c6fdc63:0x4b3f2d70e4f5a123",
"hl": "en",
"gl": "us"
}'地点データ拡充、ローカル CRM、詳細ページ。
Use feature_id from Maps Search results to request a detail record.
errorstring必須
人が読めるエラーメッセージ。
Request completed successfully.
Missing or invalid body or parameters.
Missing, invalid, or revoked API key.
Account balance is not enough.
QPS or concurrency limit exceeded.
Unexpected internal server error.
Worker returned an upstream fetch or parse error.
No worker session is available.
Gateway timed out waiting for a worker result.
{
"status": 1001,
"error": "unauthorized",
"request_id": "0f3576b2-6e2e-4f1e-bb0e-8cb0d4a60195",
"elapsed_ms": 0,
"credits_charged": 0
}