DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
「Bing Ads オーディエンス推定」タスクの設定
Bing オーディエンス推定をキューに登録し、タスク id を返します。DataForSEO のエンベロープに包まれます。データは tasks[0].result、結果は tasks[0].status_code に格納され、拒否されたリクエストでも HTTP 200 が返ります。get_dataforseo_keywords_bing_audience_fetch で取得します。
料金の参考情報
- 計測方法：報告されたレスポンスコスト。
- 参考リクエスト見積もり：0.09 USD。
- 参照用の顧客乗数：1.0。確定済みの顧客金額に再適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array (object | null)[]
- age型: array string[] | null
ターゲティング用の年齢層の選択
指定可能な値:eighteen_to_twenty_four、fifty_to_sixty_four、sixty_five_and_above、thirteen_to_seventeen、thirty_five_to_forty_nine、twenty_five_to_thirty_four、unknown、zero_to_twelve - bid型: number | null
米ドル単位の希望入札設定値
最大値: 1000 - daily型: number | null
_budget 米ドル単位の 1 日のキャンペーン予算額
最大値: 10000 - gender型: array string[] | null
ターゲティングする性別
指定可能な値:male、female、unknown - industry型: array string[] | null
LinkedIn プロフィールターゲティングの業種
このフィールドを使用する場合、https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/industries に個別にリクエストすると、industry_id を付した利用可能な業種名のリストを取得できます
例:
806301758 - job型: array string[] | null
_function LinkedIn プロフィールターゲティングの職務
このフィールドを使用する場合、https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/job_functions に個別にリクエストすると、job_function_id を付した利用可能な職務名のリストを取得できます
例:
806300451 - location型: integer
_code 検索エンジンの所在地コード
location_nameまたはlocation_coordinateを指定しない場合は必須フィールド
このフィールドを使用する場合、location_nameまたはlocation_coordinateを指定する必要はありませんhttps://api.dataforseo.com/v3/keywords_data/bing/locationsに個別にリクエストすると、検索エンジンの利用可能な所在地とそのlocation_codeの一覧を取得できます
例:2840 - location型: string
_coordinate 所在地の GPS 座標
location_nameまたはlocation_codeを指定しない場合は必須フィールド
このフィールドを使用する場合、location_nameまたはlocation_codeを指定する必要はありませんlocation_coordinateパラメーターは "緯度,経度,半径（km）" 形式で指定します
データは、指定した座標が属する国について提供されます
例:29.6821525,-82.4098881,100 - location型: string
_name 検索エンジンの所在地の正式名
location_codeまたはlocation_coordinateを指定しない場合は必須フィールド
このフィールドを使用する場合、location_codeまたはlocation_coordinateを指定する必要はありませんhttps://api.dataforseo.com/v3/keywords_data/bing/locationsに個別にリクエストすると、検索エンジンの利用可能な所在地とそのlocation_nameの一覧を取得できます
例:London,England,United Kingdom
- 型: object | null · Response36Afe1097B20_KeywordsDataBingAudienceEstimationTaskPostResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト（USD）
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_KeywordsDataBingAudienceEstimationTaskPostTaskInfo
- 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/keywords_data/bing/audience_estimation/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"location_coordinate": "29.6821525,-82.4098881,100",
"age": [
"twenty_five_to_thirty_four",
"eighteen_to_twenty_four",
"unknown"
],
"bid": 1,
"daily_budget": 24,
"gender": [
"male"
],
"industry": [
"806303407",
"806301758"
],
"job_function": [
"806298607"
]
}
]'
{
"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
}
]
}