DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google 求人タスクの設定
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 | null)[]
- depth型: integer | null
解析深度
任意フィールド
SERP の結果数；
デフォルト値:
10最大値:
200
最大 10 件の結果を含む SERP ごとにアカウントに課金されます；検索エンジンが 10 件を超える結果を返した場合、深度を 10 以上に設定すると追加料金が発生する可能性があります；
指定した深度がレスポンスの結果数より大きい場合、差分はアカウント残高に自動的に返金されます；
コストは料金ページで計算できます。
- employment型: array string[] | null
_type 雇用契約の種類
任意フィールド
検索結果が返される雇用契約の種類；
指定可能な値:
fulltime、partime、contractor、intern - keyword型: string
keyword
必須フィールド
keywordフィールドには最大 700 文字を指定できますすべての %## はデコードされます（また、‘+’ 文字は空白文字にデコードされます）
keywordに “%” 文字を使用する必要がある場合は、“%25” として指定してください；keywordに “+” 文字を使用する必要がある場合は、“%2B” として指定してください；注意: 指定するキーワードは職種名を示す必要があります；
例:
.net developer
DataForSEO API の
keywordフィールドとkeywordsフィールドのルールと制限については、こちらの ヘルプセンター記事を参照してください - language型: string
_code 検索エンジンの言語コード
language_nameを指定しない場合は必須フィールドこのフィールドを使用する場合、
language_nameを指定する必要はありません；別途
https://api.dataforseo.com/v3/serp/google/languagesにリクエストを送信すると、検索エンジンの利用可能な言語とそのlanguage_codeの一覧を取得できます例:
en - language型: string
_name 検索エンジンの言語の正式名称
language_codeを指定しない場合は必須フィールドこのフィールドを使用する場合、
language_codeを指定する必要はありません；別途
https://api.dataforseo.com/v3/serp/google/languagesにリクエストを送信すると、検索エンジンの利用可能な言語とそのlanguage_nameの一覧を取得できます例:
English - location型: integer
_code 検索エンジンのロケーションコード
location_nameを指定しない場合は必須フィールド；別途
https://api.dataforseo.com/v3/serp/google/jobs/locationsにリクエストを送信すると、検索エンジンの利用可能なロケーションとそのlocation_codeの一覧を取得できます例:
2840 - location型: string
_name 検索エンジンのロケーションの正式名称
location_codeを指定しない場合は必須フィールドこのフィールドを使用する場合、
location_codeを指定する必要はありません；別途
https://api.dataforseo.com/v3/serp/google/jobs/locationsにリクエストを送信すると、検索エンジンの利用可能なロケーションとそのlocation_nameの一覧を取得できます例:
London,England,United Kingdom - location型: string | null
_radius ロケーション検索半径
任意フィールド
ロケーション検索半径（キロメートル）；
注意: 帝国単位を使用する国の場合、マイル単位の値に
1.609を掛けてキロメートルに変換する必要があります；値が指定されていない場合、指定したロケーション内の任意の場所で検索が実行されます；
最大値:
300最小値:
> 0 - 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、advanced、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
タスクの優先度
任意フィールド
次の値を指定できます:
1 – 通常の実行優先度（デフォルトで設定）；
2 – 高い実行優先度
実行優先度の高いタスクには追加料金がかかります；コストは料金ページで計算できます
- tag型: string | null
ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメータを使ってタスクを識別し、結果と照合できます
指定した
tagの値は、レスポンスのdataオブジェクトに含まれます
- 型: object | null · Response36Afe1097B20_SerpGoogleJobsTaskPostResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト（USD）
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_SerpGoogleJobsTaskPostTaskInfo
- 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/google/jobs/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": ".net developer"
},
{
"language_name": "English",
"location_name": "United States",
"keyword": ".net developer",
"tag": "some_string_123",
"pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
}
]'
{
"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
}
]
}