Google オーガニック SERP タスクの設定

ブラウザースクリーンの高さ

任意フィールド

特定のデバイスのピクセルランキングを計算するために、ブラウザースクリーンの高さをカスタマイズできます；

指定可能な範囲：240-9999；

デフォルトでは、このパラメータは次のように設定されています：

desktop の場合：1080；

android の mobile の場合：640；

iOS の mobile の場合：812；

注意：このパラメータを使用するには、calculate_rectangles を true に設定します

ブラウザースクリーンの解像度比

任意フィールド

特定のデバイスのピクセルランキングを計算するために、ブラウザースクリーンの解像度比をカスタマイズできます；

指定可能な範囲：0.5-3；

デフォルトでは、このパラメータは次のように設定されています：

desktop の場合：1；

android の mobile の場合：3；

iOS の mobile の場合：3；

注意：このパラメータを使用するには、calculate_rectangles を true に設定します

ブラウザースクリーンの幅

任意フィールド

特定のデバイスのピクセルランキングを計算するために、ブラウザースクリーンの幅をカスタマイズできます；

指定可能な範囲：240-9999；

デフォルトでは、このパラメータは次のように設定されています：

desktop の場合：1920；

android の mobile の場合：360；

iOS の mobile の場合：375；

注意：このパラメータを使用するには、calculate_rectangles を true に設定します

高度な結果の SERP 要素のピクセルランキングを計算

任意フィールド

ピクセルランキングとは、結果スニペットと画面左上隅との距離です。

ヘルプセンターで詳細を確認する>>

デフォルトでは、このパラメータは false に設定されています

注意：このパラメータを使用すると $0.0006 の追加料金がかかります

解析の深さ

任意フィールド

SERP の結果数

デフォルト値：10

最大値：700

アカウントは、最大 10 件の結果を含む SERP ごとに課金されます。

深さを 10 より大きく設定すると、検索エンジンが 10 件を超える結果を返した場合に追加料金が発生することがあります。

コストは料金ページで計算できます。

デバイスの種類

任意フィールド

特定のデバイスの種類の結果を返します

次のいずれかの値を指定できます：desktop、mobile

デフォルト値：desktop

AI 概要を展開

任意フィールド

ai_overview 項目を展開するには true に設定します；

デフォルト値：false；

注意：このパラメータはHTML タスクの結果にのみ適用されます

ターゲットを確認する SERP 要素の種類

任意フィールド

このパラメータを有効にするには、stop_crawl_on_match も有効にする必要があります

ターゲット一致の確認対象とする SERP 要素の種類を指定します

指定しない場合は、url フィールドと domain フィールドを持つすべての第 1 レベル要素がターゲットの確認対象になります

指定可能な値：organic、paid、local_pack、featured_snippet、events、google_flights、images、jobs、knowledge_graph、local_service、map、scholarly_articles、third_party_reviews、twitter

注意：ignore_targets_in と同じ要素の種類を含めることはできません

例：

"find_targets_in": ["organic", "featured_snippet"]

このパラメータの詳細はヘルプセンターをご覧ください

関連結果を表示

任意フィールド

true に設定すると、レスポンスの related_result 要素は親のオーガニック結果のスニペットとして提供されます；

false に設定すると、related_result 要素は独立したオーガニック結果として提供されます；

デフォルト値：true

ターゲット検索から除外する SERP 要素の種類

任意フィールド

このパラメータを有効にするには、stop_crawl_on_match も有効にする必要があります

ターゲット一致を検索するときに除外する SERP 要素の種類を指定します

指定可能な値：organic、paid、local_pack、featured_snippet、events、google_flights、images、jobs、knowledge_graph、local_service、map、scholarly_articles、third_party_reviews、twitter

注意：find_targets_in と同じ要素の種類を含めることはできません

例：

"ignore_targets_in": ["paid", "images"]

このパラメータの詳細はヘルプセンターをご覧ください

キーワード

必須フィールド

keyword フィールドには最大 700 文字を指定できます

すべての %## はデコードされます（また、文字「+」はスペース文字にデコードされます）

keyword に「%」文字を使用する必要がある場合は、「%25」として指定してください；

keyword に「+」文字を使用する必要がある場合は、「%2B」として指定してください；

このフィールドに 「allinanchor:」、「allintext:」、「allintitle:」、「allinurl:」、「cache:」、「define:」、「filetype:」、「id:」、「inanchor:」、「info:」、「intext:」、「intitle:」、「inurl:」、「link:」、「site:」、タスクごとの料金は 5 倍になります

DataForSEO API における keyword および keywords フィールドのルールと制限については、こちらのヘルプセンター記事を参照してください

検索エンジンの言語コード

language_name を指定しない場合は必須フィールド

このフィールドを使用する場合、language_name を指定する必要はありません

https://api.dataforseo.com/v3/serp/google/languages に個別にリクエストすると、検索エンジンで利用可能な言語とその language_code の一覧を取得できます

例：

en

検索エンジンの言語の正式名称

language_code を指定しない場合は必須フィールド

このフィールドを使用する場合、language_code を指定する必要はありません

https://api.dataforseo.com/v3/serp/google/languages に個別にリクエストすると、検索エンジンで利用可能な言語とその language_name の一覧を取得できます

例：

English

AI 概要を非同期で読み込む

任意フィールド

非同期で読み込まれる場合でも、SERP で ai_overview 項目を取得するには true に設定します；

false に設定すると、キャッシュからのみ ai_overview 項目を取得します；

デフォルト値：false

注意：このパラメータを使用すると $0.0006 の追加料金がかかります；

要素が存在しない場合、または "asynchronous_ai_overview": false が含まれる場合、追加料金はすべてアカウント残高に返金されます

検索エンジンのロケーションコード

location_name または location_coordinate を指定しない場合は必須フィールド

このフィールドを使用する場合、location_name または location_coordinate を指定する必要はありません

https://api.dataforseo.com/v3/serp/google/locations に個別にリクエストすると、検索エンジンで利用可能なロケーションとその location_code の一覧を取得できます

例：

2840

ロケーションの GPS 座標

location_name または location_code を指定しない場合は必須フィールド

このフィールドを使用する場合、location_name または location_code を指定する必要はありません

location_coordinate パラメーターは "latitude,longitude,radius" 形式で指定する必要があります

"latitude" と "longitude" の最大小数桁数: 7

"radius" の最小値: 199（mm）

"radius" の最大値: 199999（mm）

例:

53.476225,-2.243572,200

検索エンジンのロケーションの正式名称

location_code または location_coordinate を指定しない場合は必須フィールド

このフィールドを使用する場合、location_code または location_coordinate を指定する必要はありません

https://api.dataforseo.com/v3/serp/google/locations に個別にリクエストすると、検索エンジンで利用可能なロケーションとその location_name の一覧を取得できます

例：

London,England,United Kingdom

ターゲット一致タイプ

stop_crawl_on_match を指定する場合は必須フィールド

match_value の一致タイプ

指定可能な値：

domain – 特定のドメインまたはサブドメイン

with_subdomains – メインドメインとサブドメイン

wildcard – ワイルドカードパターン

ターゲットのドメイン、サブドメイン、またはワイルドカード値

stop_crawl_on_match を指定する場合は必須フィールド

ターゲットのドメイン、サブドメイン、またはワイルドカード値を指定します；

注意：ドメインまたはサブドメインはリクエストプロトコルを付けずに指定してください；

例："match_value": "dataforseo.com"、

"match_value": "/blog/post-*"

ページクロール上限

任意フィールド

クロールする検索結果ページ数

最大値：100

注意：クロールしたページごとに課金されます（1 ページあたり 10 件のオーガニック結果）；

料金の詳細は料金ページをご覧ください；

注意#2：max_crawl_pages と depth パラメータは互いに補完し合います。

詳細はヘルプセンターをご覧ください

デバイスのオペレーティングシステム

任意フィールド

device フィールドに desktop を指定した場合は、次の値から選択します：windows、macos

デフォルト値：windows

device フィールドに mobile を指定した場合は、次の値から選択します：android、ios

デフォルト値：android

対応する要素のクリック数

任意フィールド

追加の people_also_ask_element 項目を取得するには、people_also_ask 要素のクリック深度を指定します；

注意：アカウントには、タスクの優先度に関係なく、クリックごとに $0.00015 の追加料金が請求されます；

要素が存在しない場合、または指定した回数より少ないクリックしか実行されなかった場合、追加料金はすべてアカウント残高に返金されます

指定可能な値：1 から 4

完了したタスクの通知 URL

任意フィールド

タスクが完了すると、指定した URL に GET リクエストを送信して通知します

‘$id’ 文字列を $id 変数として、‘$tag’ を URL エンコードされた $tag 変数として使用できます。リクエストを送信する前に必要な値を設定します。

例：

http://your-server.com/pingscript?id=$id

http://your-server.com/pingscript?id=$id&tag=$tag

注意：pingback_url の特殊文字は URL エンコードされます；

たとえば、# 文字は %23 にエンコードされます

詳細はヘルプセンターをご覧ください

postback_url のデータ型

postback_url を指定する場合は必須フィールド

サーバーに送信されるデータ型に対応します

指定可能な値：

regular、advanced、html

タスク結果送信用の URL

任意フィールド

タスクが完了すると、結果を gzip 形式で圧縮し、指定した postback_url に POST リクエストを送信します

‘$id’ 文字列を $id 変数として、‘$tag’ を URL エンコードされた $tag 変数として使用できます。リクエストの送信前に必要な値を設定します

例:

http://your-server.com/postbackscript?id=$id

http://your-server.com/postbackscript?id=$id&tag=$tag

注意: postback_url 内の特殊文字は URL エンコードされます

たとえば、# 文字は %23 にエンコードされます

詳細については、ヘルプセンターを参照してください

タスクの優先度

任意フィールド

次の値を指定できます:

1 – 通常の実行優先度（デフォルトで設定）;

2 – 高い実行優先度

実行優先度の高いタスクには追加料金がかかります。

コストは料金ページで計算できます。

URL から特定のパラメータを削除

任意フィールド

このフィールドを使用すると、結果の URL から削除するパラメータを最大 10 個指定できます

例:

"remove_from_url": ["srsltid"]

検索エンジンのドメイン

任意フィールド

指定したロケーションと言語に応じて、関連する検索エンジンのドメインが自動的に選択されます

ただし、このフィールドでカスタムの検索エンジンドメインを設定できます

例:

google.co.uk, google.com.au, google.de など。

検索クエリの追加パラメータ

任意フィールド

使用可能なパラメータの一覧と詳細はこちら

注意: 次の検索エンジンパラメータはサポートされておらず、指定すると自動的に解除されます: lr、cr、as_qdr、as_sitesearch、as_occt、as_filetype。

クロールを停止するターゲットの配列 任意フィールド 指定した場合、レスポンスには指定した match_value までの SERP 結果が含まれます。 この配列には最大 10 個のターゲット値を指定できます 例: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] このパラメータの詳細については、ヘルプセンターをご覧ください - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api アカウントには、指定したターゲットを通じてクロールされた SERP ごとに課金されます

ユーザー定義のタスク識別子

任意フィールド

文字数上限は 255 です

このパラメータを使ってタスクを識別し、結果と照合できます

指定した tag の値は、レスポンスの data オブジェクトに含まれます

ターゲットのマッチングモード

任意フィールド

このパラメータを有効にするには、stop_crawl_on_match も有効にする必要があります

stop_crawl_on_match で複数のターゲットを指定した場合に、クロールをどのように停止するかを定義します

可能な値: all、any

all – 指定したすべてのターゲットが見つかった場合にのみクロールを停止します

any – いずれか 1 つのターゲットが見つかった時点でクロールを停止します

デフォルト値: any

このパラメータの詳細については、ヘルプセンターをご覧ください

検索クエリの直接 URL

任意フィールド

直接 URL を指定すると、必要なフィールドに解析されます。この方法は当社の API にとって処理が最も難しく、URL に正確な言語とロケーションを指定する必要があることに注意してください。ほとんどの場合、この方法はお勧めしません。

例:

https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS

注意: 次の検索エンジンパラメータはサポートされておらず、URL に指定すると自動的に解除されます: lr、cr、as_qdr、as_sitesearch、as_occt、as_filetype。