DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google イベント SERP タスクの設定
Google でクエリに対して表示されるイベントをキューに登録し、tasks[0].id にタスク id を返します。DataForSEO のエンベロープに包まれます。データは tasks[0].result、結果は tasks[0].status_code に格納され、拒否されたリクエストでも HTTP 200 が返ります。ライブ版は即座に応答するため、単一のクエリならこちらが簡単です。バッチが 1 回のツール呼び出しを超える場合はキューに登録してください。
料金の参考情報
- 計量方式：報告されたレスポンスコスト。
- 参考リクエスト見積もり：0.02 USD。
- 参照用の顧客乗数：1.0。確定済みの顧客金額に再適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array object[]
- keyword型: string必須
検索するキーワード
- language型: string
_code 検索エンジンの言語コード
- language型: string
_name 検索エンジンの言語の正式名称
- location型: integer
_code 検索エンジンのロケーションコード
- location型: string
_coordinate ロケーションの GPS 座標
- location型: string
_name 検索エンジンのロケーションの正式名称
- pingback型: string
_url 完了したタスクの通知 URL
- postback型: string
_data postback のデータ型
- postback型: string
_url タスク結果送信用の URL
- priority型: integer
タスクの優先度
- 型: object200
成功レスポンス
- 型: numbercost
タスクの合計コスト（USD）
- 型: integerstatus
_code 一般的なステータスコード
- 型: stringstatus
_message 一般的な情報メッセージ
- 型: array string[]tasks
タスクオブジェクトの配列
- 型: integertasks
_count tasks 配列内のタスク数
- 型: integertasks
_error エラーで返された tasks 配列内のタスク数
- 型: numbertasks[]
.cost タスクのコスト（USD）
- 型: stringtasks[]
.id UUID 形式のタスク識別子
- 型: integertasks[]
.result _count 結果配列内の要素数
- 型: integertasks[]
.status _code タスクのステータスコード
- 型: stringtasks[]
.status _message タスクのステータスメッセージ
- 型: stringtime
実行時間（秒）
- 型: stringversion
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/google/events/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "",
"location_code": 1,
"location_name": "",
"location_coordinate": "",
"language_code": "",
"language_name": "",
"priority": 1,
"postback_url": "",
"pingback_url": "",
"postback_data": ""
}
]'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks_count": 1,
"tasks_error": 1,
"tasks": [
"string"
],
"tasks[].id": "string",
"tasks[].status_code": 1,
"tasks[].status_message": "string",
"tasks[].cost": 1,
"tasks[].result_count": 1
}