簡潔な回答
SerpCrypto SERP APIのレスポンスには何が含まれますか?
各SerpCryptoレスポンスは1つのJSONオブジェクトです: search_metadata(ステータス、エンジン、使用クレジット)、search_parameters(適用された設定)、search_information、そしてorganic_results、ai_overview、people_also_ask、local_resultsなど検索結果ページの各部分ごとのブロックです。存在しない部分は単に含まれません。1ページのコストは$0.30/1K検索から1クレジット。暗号資産で支払い、KYC不要です。
Googleの完全なレスポンスはどのようなものですか?
以下の例はイギリスでのstanding deskのGoogle検索で、各配列1件に短縮しています。実際のレスポンスには約10件のorganic結果と、その検索クエリ、地域、デバイスに対してページが表示したその他のすべてのブロックが含まれます。
{
"search_metadata": {
"id": "srch_2b81d0c6fa47",
"status": "success",
"engine": "google",
"created_at": "2026-10-22T10:02:31Z",
"credits_used": 1
},
"search_parameters": {
"engine": "google",
"q": "standing desk",
"gl": "gb",
"hl": "en",
"google_domain": "google.co.uk",
"device": "desktop",
"page": 1
},
"search_information": { "total_results": 52400000, "query_displayed": "standing desk" },
"ai_overview": {
"text": "A standing desk lets you work while standing or sitting…",
"references": [
{ "index": 1, "title": "How to choose a standing desk", "link": "https://www.example.co.uk/guide", "source": "Example Guide" }
]
},
"ads": [
{ "position": 1, "block": "top", "title": "Electric Standing Desks", "link": "https://shop.example.com/desks", "displayed_link": "shop.example.com", "description": "Free delivery on…" }
],
"organic_results": [
{
"position": 1,
"title": "Best standing desks 2026, tested",
"link": "https://www.example.co.uk/best-standing-desks",
"displayed_link": "www.example.co.uk › reviews",
"snippet": "We tested 14 electric and manual desks…",
"date": "12 Oct 2026",
"sitelinks": [ { "title": "Budget picks", "link": "https://www.example.co.uk/best-standing-desks#budget" } ]
}
],
"people_also_ask": [
{ "question": "Is it healthy to stand all day at a desk?", "snippet": "…", "title": "Standing at work", "link": "https://www.example.org/standing" }
],
"shopping_results": [
{ "position": 1, "title": "Example Desk Pro 140 cm", "price": "£299.00", "source": "Example Store", "link": "https://shop.example.com/desk-pro" }
],
"related_searches": [ { "query": "standing desk electric" }, { "query": "standing desk converter" } ],
"pagination": { "current": 1, "next_page": 2 }
}レスポンスに一部のブロックが含まれないのはなぜですか?
検索結果ページに表示されなかったからです。広告、AI Overview、local pack、top storiesを表示するかどうかは、検索クエリ、場所、デバイスごとにGoogleが判断します。SerpCryptoはページに表示された内容を返し、それ以外は空のプレースホルダーを送るのではなく省略します。
以下のPythonの行のように、すべてのブロックをデフォルト値付きで読み取ってください。同じルールはブロック内にも当てはまります。dateやsitelinksのような省略可能なフィールドは、それを持つ結果にのみ現れます。
data = response.json()
# A block is present only when the results page shows it: read with a default.
overview = data.get("ai_overview") or {}
organic = data.get("organic_results", [])
questions = [item["question"] for item in data.get("people_also_ask", [])]
if overview:
print("AI Overview sources:", [ref["link"] for ref in overview.get("references", [])])
print(len(organic), "organic results,", len(questions), "questions")search_metadataには何が含まれますか?
| フィールド | 型 | 説明 |
|---|---|---|
id | string | 検索の識別子。サポートに問い合わせる際に引用してください。 |
status | string | 200のレスポンスにおけるsuccess。 |
engine | string | 検索を実行したエンジン。 |
created_at | string | 検索時刻、UTCのISO 8601形式。 |
credits_used | integer | この検索で消費されたクレジット: 成功時は1。 |
search_parametersとsearch_informationとは何ですか?
結果と一緒にsearch_parametersを保存してください。どの国・言語・場所・デバイスからのランキングなのかが正確に記録されます。
| フィールド | 型 | 説明 |
|---|---|---|
search_parameters | object | 適用されたパラメータ(デフォルト値を補完): engine、q、gl、hl、location、google_domain、device、page、および送信したその他のパラメータ。 |
search_information.total_results | integer | エンジンが表示した場合の、表示された結果件数。正確な数値ではなく推定値です。 |
search_information.query_displayed | string | 結果ページに表示された通りの検索クエリ。 |
organic_results にはどのようなフィールドがありますか?
オーガニック結果は広告ではないWeb検索結果です。Bingでは、organic_resultsも同じ形をしています。
| フィールド | 型 | 説明 |
|---|---|---|
position | integer | このページのこのブロック内での結果の順序(1から開始)。 |
title | string | 青いリンクのタイトル。 |
link | string | 結果のURL。 |
displayed_link | string | タイトルの下に表示されるURLまたはパンくずリスト。 |
snippet | string | タイトルの下に表示されるテキスト。 |
date | string | スニペットの横に表示される日付(ページに書かれている通り)。任意。 |
sitelinks | array | 結果の下に表示される追加リンク。それぞれtitleとlinkを持ちます。任意。 |
AI Overview はどのように返されますか?
ai_overview は、その検索クエリと場所に対して Google が AI Overview を表示する場合にのみ存在します。多くの検索クエリでは表示されません。
| フィールド | 型 | 説明 |
|---|---|---|
ai_overview.text | string | ページに表示される通りの AI Overview のテキスト。 |
ai_overview.references[].index | integer | 概要内の引用元の順序。 |
ai_overview.references[].title | string | 引用されたページのタイトル。 |
ai_overview.references[].link | string | 引用されたページのURL。 |
ai_overview.references[].source | string | 表示される通りのサイト名。 |
ads と people_also_ask には何が含まれますか?
| フィールド | 型 | 説明 |
|---|---|---|
ads[].position | integer | そのブロック内での順序。 |
ads[].block | string | ページのtopまたはbottom。 |
ads[].title、link、displayed_link | string | 広告の見出し、ランディングURL、表示URL。 |
ads[].description | string | 広告のテキスト。 |
people_also_ask[].question | string | 表示されているとおりの質問。 |
people_also_ask[].snippet | string | 質問を開いたときに表示される回答テキスト。 |
people_also_ask[].title、link | string | 回答の参照元ページのタイトルとURL。 |
他にどのようなGoogleのブロックが表示されますか?
| ブロック | フィールド | 概要 |
|---|---|---|
local_results | position、title、address、rating、reviews、type | ローカルパック:場所に関する意図を持つ検索クエリに対して、地図上に表示されるビジネス情報。 |
knowledge_graph | title、type、description、source.name、source.link | 人物、場所、企業、事物に関するナレッジパネル。 |
top_stories | title、link、source、date | カルーセルで表示されるニュース記事。 |
inline_videos | title、link、source、duration | Web検索結果内に表示される動画結果。 |
shopping_results | position、title、price、source、link | Web検索結果内に表示される商品リスティング。 |
related_searches | query | ページ下部に表示される検索候補。 |
pagination | current、next_page | 現在のページ番号と、存在する場合は次のページ番号。 |
他のエンジンは何を返しますか?
各バーティカルは同じフレームを保ちつつ、独自の配列を追加します。Googleマップでは、local_resultsはWeb検索のローカルパックよりも情報が豊富です。
engine | メイン配列 | フィールド |
|---|---|---|
google_news | news_results | position、title、link、source、date、snippet、thumbnail |
google_images | images_results | position、title、original、original_width、original_height、thumbnail、source、link |
google_maps | local_results | position、title、place_id、address、phone、website、rating、reviews、type、hours、gps_coordinates.latitude、gps_coordinates.longitude |
google_shopping | shopping_results | position、title、price、extracted_price、currency、source、link、delivery、rating、reviews |
bing | organic_results、related_searches | Googleのオーガニック検索結果と同じフィールド |
価格、評価、日付はどのような型で返されますか?
ページがテキストで書いていた値は、その形式をそのまま保ちます。priceは通貨記号を含む文字列で、たとえば£299.00です。Googleショッピングではextracted_priceが数値、currencyがコードとして追加されます。ratingは数値、reviewsは整数です。dateのような日付は、たとえば12 Oct 2026や3 days agoのようにページに書かれたまま残るので、タイムスタンプが必要ならご自身のコードでパースしてください。
複数ページにまたがる総合順位はどう作ればいいですか?
各結果とともにページ番号を保存してください。positionは1ページ内のブロックでの順序を示し、search_parameters.pageはそれが何ページ目かを示します。1ページあたり約10件のオーガニック結果です。Googleは2025年9月にnum=100を尊重しなくなって以降、この件数を返しています。追加の各ページにはさらに1クレジットが必要です。
順位トラッキングでは、多くのチームがキーワードと日ごとにlink、position、page、gl、location、device、created_atを保持しています。これで順位をグラフ化し、地域やデバイスによる変動を説明できます。詳しい方法は順位トラッキングをご覧ください。
レスポンス形式に関する質問
フィールド名は安定していますか?
バージョン1の範囲では安定しています。新しいブロックやフィールドは追加される可能性があるため、知らないキーは無視してください。フィールドの削除や名前変更は、/api/v2/のようなパスでの新バージョンとして行われます。
ページの生のHTMLは取得できますか?
いいえ。バージョン1はパース済みのJSONのみを返します。パース済みのブロックは、結果、広告、質問、AI Overview、ローカルパック、ナレッジパネルなど、ほとんどのツールが必要とする内容をカバーしています。
total_resultsが自分で数えた数と違うのはなぜですか?
それは実際にページ送りできる結果の件数ではなく、検索エンジンが表示する推定値です。ページはその数よりずっと早く終わります。次のページが存在するかどうかはpagination.next_pageで確認してください。
オーガニック検索結果が無いレスポンスでもクレジットは消費されますか?
はい、検索が成功した場合は消費されます。空のページも結果です。無料なのはエラーのみです。1クレジット = 1回の成功した検索リクエストで、対応するすべてのエンジンで結果の1ページを返します。失敗したリクエストは課金されません。