DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
設定即時「Bing Ads 受眾估算」任務
估算在指定 bid 與 daily_budget 下可觸及的 Bing Ads 受眾，並可依 location_code、age、產業與職能縮小範圍。採用 DataForSEO 的信封結構：資料位於 tasks[0].result，結果狀態位於 tasks[0].status_code——被拒絕的請求仍會回傳 HTTP 200。產業與職能值來自 get_dataforseo_keywords_bing_audience_industries 與 get_dataforseo_keywords_bing_audience_job_functions——兩者都免費，也都值得在建立請求前閱讀。此端點的提交與擷取配套端點會以相同價格非同步完成相同工作，適合大到無法等待的批次。
計費參考
- 計量方式：依回報的回應成本計量。
- 參考請求估算：0.09 美元。
- 參考客戶倍率：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 以美元計的每日廣告活動預算值
最大值：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_codelocation_coordinate參數應採用 "緯度,經度,半徑（公里）" 格式
資料將依指定座標所屬的國家/地區提供
範例：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_KeywordsDataBingAudienceEstimationLiveResponseInfo200
- 類型: number | null 格式: doublecost
任務總費用，美元
- 類型: integer | nullstatus
_code 一般狀態碼 完整回應碼清單請見此處
- 類型: string | nullstatus
_message 一般資訊訊息 完整的一般資訊訊息清單請見此處
- 類型: array (object | null)[] | nulltasks
任務陣列
- 類型: object | null · Response36Afe1097B20_KeywordsDataBingAudienceEstimationLiveTaskInfo
- cost類型: number | null 格式: double
任務總費用，美元
- data類型: object | null
包含你在 POST 請求中指定的相同參數
- property類型: object | null
Name
- id類型: string | null
任務識別碼 我們系統中 UUID 格式的唯一任務識別碼
- path類型: array (string | null)[] | null
URL 路徑
- result類型: array (object | null)[] | null
結果陣列
- currency類型: string | null
貨幣名稱
範例：
USDollar - est類型: object | null · Response36Afe1097B20_AudienceEstimationInfo
_audience _size 每月預估觸及使用者數範圍
- high類型: number | null 格式: double
表示範圍結果的上限
- low類型: number | null 格式: double
表示範圍結果的下限
- est類型: object | null · Response36Afe1097B20_AudienceEstimationInfo
_clicks 每月預估點擊次數範圍
- high類型: number | null 格式: double
表示範圍結果的上限
- low類型: number | null 格式: double
表示範圍結果的下限
- est類型: object | null · Response36Afe1097B20_AudienceEstimationInfo
_cost _per _event 代表以範圍呈現的預估單次事件費用
- high類型: number | null 格式: double
表示範圍結果的上限
- low類型: number | null 格式: double
表示範圍結果的下限
- est類型: object | null · Response36Afe1097B20_AudienceEstimationInfo
_ctr 預估點擊率範圍
- high類型: number | null 格式: double
表示範圍結果的上限
- low類型: number | null 格式: double
表示範圍結果的下限
- est類型: object | null · Response36Afe1097B20_AudienceEstimationInfo
_impressions 每月預估曝光次數範圍
- high類型: number | null 格式: double
表示範圍結果的上限
- low類型: number | null 格式: double
表示範圍結果的下限
- est類型: integer | null 格式: int64
_reach _audience _size 每月預估使用者數
- est類型: integer | null 格式: int64
_reach _impressions 每月預估曝光次數
- est類型: object | null · Response36Afe1097B20_AudienceEstimationInfo
_spend 每月預估支出範圍
- high類型: number | null 格式: double
表示範圍結果的上限
- low類型: number | null 格式: double
表示範圍結果的下限
- events類型: integer | null 格式: int64
_lost _to _bid 代表因輸入出價不足而錯失的事件數
- events類型: integer | null
_lost _to _budget 代表因輸入預算不足而錯失的事件數
- suggested類型: number | null
_bid 目前目標設定下的建議出價
- suggested類型: number | null 格式: double
_budget 目前目標設定與出價下的建議每日預算
- 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/live \
--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": [
{
"est_impressions": {
"high": null,
"low": null
},
"est_audience_size": {
"high": null,
"low": null
},
"est_clicks": {
"high": null,
"low": null
},
"est_spend": {
"high": null,
"low": null
},
"est_cost_per_event": {
"high": null,
"low": null
},
"est_ctr": {
"high": null,
"low": null
},
"suggested_bid": null,
"suggested_budget": null,
"events_lost_to_bid": null,
"events_lost_to_budget": null,
"est_reach_audience_size": null,
"est_reach_impressions": null,
"currency": null
}
]
}
]
}