DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Baidu オーガニック SERP タスクの設定
Baidu でキーワードのランキング結果をキューに登録し、tasks[0].id でタスク id を返します。DataForSEO のエンベロープに包まれます。データは tasks[0].result、結果は tasks[0].status_code に格納され、拒否されたリクエストでも HTTP 200 が返ります。ライブ版は即座に応答するため、単一のクエリにはこちらの方が簡単です。バッチが 1 回のツール呼び出しより長引く場合はキューを使用してください。
料金の参考情報
- 計測方法：報告されたレスポンスコスト。
- 参考リクエスト見積もり：0.02 USD。
- 参照用の顧客乗数：1.0。確定済みの顧客金額に再適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array (object | null)[]
- depth型: integer | null
- device型: string | null
デバイスの種類
任意フィールド
特定のデバイスの種類の結果を返します
次のいずれかの値を指定できます：desktop、mobile、tablet
デフォルト値：desktop - get型: boolean | null
_website _url 各ランキング結果の直接 URL を含める
任意フィールドtrueに設定すると、返される結果にランキングされたウェブサイトの直接 URL が含まれます。
デフォルトでは、Baidu の結果の URL は検索エンジンによってエンコードされています。
例：http://www.baidu.com/link?url=KQt6LSwU5OHnPtB8210R8flBP40grY6lTPxH_0UO7S2kgiZMTmw3ztV0hCo5c1kLデフォルト値：false
注意：trueに設定すると、タスクごとの料金が 10 倍になります。これは、システムがランキングされた各ウェブサイトに対して個別にリクエストを実行し、直接 URL を返すためです - keyword型: string
- language型: string
_code 検索エンジンの言語コード
language_nameを指定しない場合は必須フィールドhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesに個別にリクエストすると、検索エンジンで利用可能な言語とそのlanguage_codeの一覧を取得できます注意：Baidu 検索エンジンでサポートされている言語は、言語コードzh_CNのChinese (Simplified)のみです。ただし、Baidu は他の言語のクエリに対しても結果を返す可能性があるため、keywordを中国語で指定する必要はありません例：
zh_CN - language型: string
_name 検索エンジンの言語の正式名
language_codeを指定しない場合は必須フィールドhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesに個別にリクエストすると、検索エンジンで利用可能な言語とそのlanguage_nameの一覧を取得できます注意：Baidu 検索エンジンでサポートされている言語はChinese (Simplified)のみです。ただし、Baidu は他の言語のクエリに対しても結果を返す可能性があるため、keywordを中国語で指定する必要はありません例：
Chinese (Simplified) - location型: integer
_code 検索エンジンのロケーションコード
location_nameまたはlocation_coordinateを指定しない場合は必須フィールド
このフィールドを使用する場合、location_nameまたはlocation_coordinateを指定する必要はありませんhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsに個別にリクエストすると、検索エンジンで利用可能なロケーションとそのlocation_codeの一覧を取得できます
例：2156 - location型: string
_coordinate ロケーションの GPS 座標
location_nameまたはlocation_codeを指定しない場合は必須フィールド
このフィールドを使用する場合、location_nameまたはlocation_codeを指定する必要はありませんlocation_coordinateパラメータは "latitude,longitude,radius" 形式で指定してください
"latitude" と "longitude" の小数点以下の最大桁数は 7 です
"radius" の最小値：199.9 (mm)
"radius" の最大値：199999 (mm)このフィールドを使用すると、返される結果は座標に最も近い都市に基づきます。そのため、結果が指定した座標に関連しない可能性があるため、このフィールドの使用はお勧めしません
例：53.476225,-2.243572,200 - location型: string
_name 検索エンジンのロケーションの正式名
location_codeまたはlocation_coordinateを指定しない場合は必須フィールド
このフィールドを使用する場合、location_codeまたはlocation_coordinateを指定する必要はありませんhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsに個別にリクエストすると、検索エンジンで利用可能なロケーションとそのlocation_nameの一覧を取得できます
例：New York,New York,United States - max型: integer | null
_crawl _pages - os型: string | null
デバイスのオペレーティングシステム
任意フィールドdeviceフィールドにdesktopを指定した場合は、次の値から選択します：windows、macos
デフォルト値：windowsdeviceフィールドにmobileを指定した場合は、次の値から選択します：android、ios
デフォルト値：androiddeviceフィールドにtabletを指定した場合は、次の値から選択します：android、ios
デフォルト値：android - pingback型: string | null
_url タスク完了通知の URL
任意フィールド
タスクが完了すると、指定した URL に GET リクエストを送信して通知します
‘$id’ 文字列を$id変数として、‘$tag’ を URL エンコードされた$tag変数として使用できます。リクエストの送信前に必要な値を設定します。
例:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
注意:pingback_url内の特殊文字は URL エンコードされます
たとえば、#文字は%23にエンコードされます - postback型: string
_data postback_url のデータタイプ
postback_urlを指定する場合は必須フィールド
サーバーに送信されるデータタイプに対応します
使用可能な値：regular、html - postback型: string | null
_url タスク結果送信用の URL
任意フィールド
タスクが完了すると、結果をgzip形式で圧縮し、指定したpostback_urlに POST リクエストを送信します
‘$id’ 文字列を$id変数として、‘$tag’ を URL エンコードされた$tag変数として使用できます。リクエストの送信前に必要な値を設定します。
例:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
注意:postback_url内の特殊文字は URL エンコードされます
たとえば、#文字は%23にエンコードされます - priority型: integer | null
- stop型: array (object | null)[] | null
_crawl _on _match クロールを停止するターゲットの配列 任意フィールド 指定した場合、レスポンスには指定した 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 ごとに課金されます
- match型: string | null
_type ターゲットのマッチタイプ stop_crawl_on_match を指定する場合は必須フィールドです。 match_value のマッチタイプ 可能な値: domain、with_subdomains、wildcard
- match型: string | null
_value ターゲットのドメインまたはワイルドカード値 stop_crawl_on_match を指定する場合は必須フィールドです。 ターゲットのドメインまたはワイルドカード値を指定します。 注意: ドメイン名はリクエストプロトコルなしで指定する必要があります。 例: dataforseo.com
- tag型: string | null
ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定したtagの値は、レスポンスのdataオブジェクトに含まれます
- 型: object | null · Response36Afe1097B20_SerpBaiduOrganicTaskPostResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト（USD）
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_SerpBaiduOrganicTaskPostTaskInfo
- cost型: number | null 形式: double
タスクの総コスト（USD）
- data型: object | null
POST リクエストで指定したものと同じパラメーターを含みます
- property型: object | null
Name
- id型: string | null
タスク識別子 当社システム内で UUID 形式の一意のタスク識別子
- path型: array (string | null)[] | null
URL パス
- result型: object | null
結果の配列
この場合、値はnullになります - result型: integer | null 形式: int64
_count result 配列内の要素数
- status型: integer | null
_code タスクのステータスコード DataForSEO によって生成され、次の範囲の値になります: 10000-60000 レスポンスコードの完全な一覧はこちらです
- status型: string | null
_message タスクの情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- time型: string | null
実行時間（秒）
- 型: integer | null 形式: int64tasks
_count tasks 配列内のタスク数
- 型: integer | null 形式: int64tasks
_error エラーで返された tasks 配列内のタスク数
- 型: string | nulltime
合計実行時間（秒）
- 型: string | nullversion
API の現在のバージョン
application/json - 400
リクエストを処理できませんでした。リクエストパラメータを確認してください。
- 401
有効な Felo API キーが必要です。
- 402
請求要件が満たされていないため、リクエストを続行できません。
- 403
このアカウントにはこの操作を行う権限がありません。
- 429
リクエストまたは支出の上限に達しました。
- 502
サービスがリクエストを完了できませんでした。
- 503
API または請求サービスが一時的に利用できません。
- 504
リクエストの処理中にサービスがタイムアウトしました。
- default
エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/baidu/organic/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"location_code": 2156,
"keyword": "best iphone ever",
"tag": "some_string_123",
"priority": 2
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": null
}
]
}