id で Naver オーガニック SERP の結果を取得（regular）
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
id で Naver オーガニック SERP の結果を取得（regular）
DataForSEO のエンベロープに包まれます。データは tasks[0].result、結果は tasks[0].status_code に格納され、拒否されたリクエストでも HTTP 200 が返ります。
料金の参考情報
- 計測方法：報告されたレスポンスコスト。
- 参考リクエスト見積もり：0.012 USD。
- 参照用の顧客乗数：1.0。確定済みの顧客金額に再適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: object | null · Response36Afe1097B20_SerpNaverOrganicTaskGetRegularResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト（USD）
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_SerpNaverOrganicTaskGetRegularTaskInfo
- cost型: number | null 形式: double
タスクの総コスト（USD）
- data型: object | null
POST リクエストで指定したものと同じパラメーターを含みます
- property型: object | null
Name
- id型: string | null
タスク識別子 当社システム内で UUID 形式の一意のタスク識別子
- path型: array (string | null)[] | null
URL パス
- result型: array (object | null)[] | null
結果の配列
- check型: string | null
_url 検索エンジン結果への直接 URL
正確な結果が提供されていることを確認するために使用できます - datetime型: string | null
結果を受信した日時
UTC 形式：“yyyy-mm-dd hh-mm-ss +00:00”
例：2019-11-15 12:57:46 +00:00 - item型: array (string | null)[] | null
_types SERP で見つかった検索結果タイプ
返された SERP で見つかったすべての検索結果タイプ（items）を含みます
指定可能な項目タイプ：images、local_pack、map、organic、paid、related_searches、videoこの配列には、返された SERP で見つかったすべての検索結果タイプが含まれることに注意してください；
ただし、このエンドポイントが提供するのはorganicとpaidタイプのデータのみです返された SERP で見つかったすべての項目（SERP 機能やリッチスニペットを含む）を取得するには、Naver Organiс Advanced SERP エンドポイントを参照してください
- items型: array (object | null)[] | null
SERP 内の項目
- page型: integer | null
検索結果のページ番号
要素が配置されている SERP のページ番号を示します - position型: string | null
SERP における要素の配置
次の値を取ることができます:left、right - rectangle型: object | null · Response36Afe1097B20_AiModeRectangleInfo
矩形パラメータ
結果のスニペットの SERP におけるデカルト座標とピクセル寸法が含まれますnullになります（POST リクエストのcalculate_rectanglesがtrueに設定されていない場合）- height型: number | null 形式: double
要素の高さ（ピクセル）
- width型: number | null 形式: double
要素の幅（ピクセル）
- x型: number | null 形式: double
x 軸座標 結果スニペットの左上隅の x 軸座標。画面の左上隅を原点とします
- y型: number | null 形式: double
y 軸座標 結果スニペットの左上隅の y 軸座標。画面の左上隅を原点とします
- type型: string | null
要素の種類
- xpath型: string | null
要素の XPath
- items型: integer | null 形式: int64
_count items配列で返された結果数 - keyword型: string | null
POST 配列で受け取ったキーワード
キーワードはデコードされた %## とともに返されます（プラス記号「+」は空白文字にデコードされます） - language型: string | null
_code POST 配列内の言語コード
- location型: integer | null
_code POST 配列内のロケーションコード
- pages型: integer | null 形式: int64
_count 取得した合計ページ数
結果内で取得された SERP の総数 - refinement型: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips 検索絞り込みチップ
nullになります- items型: array (object | null)[] | null
要素の項目
- domain型: string | null
SERP のドメイン
- options型: array (object | null)[] | null
さらなる検索絞り込みオプション
- domain型: string | null
SERP のドメイン
- title型: string | null
要素のタイトル
- type型: string | null
要素の種類
- url型: string | null
絞り込みパラメーター付きの検索 URL
- title型: string | null
要素のタイトル
- type型: string | null
要素の種類
- url型: string | null
絞り込みパラメーター付きの検索 URL
- type型: string | null
要素の種類
- xpath型: string | null
要素の XPath
- se型: string | null
_domain POST 配列内の検索エンジンドメイン
- se型: integer | null 形式: int64
_results _count SERP の結果総数
- spell型: object | null · Response36Afe1097B20_SpellInfo
検索エンジンによる自動修正
修正されたキーワードに対して検索エンジンが結果を返した場合、検索エンジンによって修正されたキーワードと自動修正のタイプを示します- keyword型: string | null
検索エンジンの自動修正によって取得されたキーワード 結果は修正後のキーワードに対して提供されます
- type型: string | null
自動修正のタイプ 指定可能な値： did_you_mean、showing_results_for、no_results_found_for、including_results_for 注意：Yahoo と Yandex がサポートする自動修正タイプは次のとおりです： including_results_for
- type型: string | 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/naver/organic/task_get/regular/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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": [
{
"keyword": null,
"type": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"spell": {
"keyword": null,
"type": null
},
"refinement_chips": {
"type": null,
"xpath": null,
"items": [
"[Max Depth Exceeded]"
]
},
"item_types": [
null
],
"se_results_count": null,
"pages_count": null,
"items_count": null,
"items": [
{
"type": null,
"page": null,
"position": null,
"xpath": null,
"rectangle": "[Max Depth Exceeded]"
}
]
}
]
}
]
}操作成功