v0.2.0-beta

OpenAPI 3.1.0

Mencipta Tugas ‘Bing Ads Audience Estimation’ Langsung

Felo API Support

MIT

Pelayan

https://openapi.felo.ai

Pustaka Klien

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operasi

post/v1/beta/dataforseo/keywords_data/bing/audience_estimation/live

Mencipta Tugas ‘Bing Ads Audience Estimation’ Langsung

Menganggar audiens Bing Ads yang boleh dicapai pada bid dan daily_budget tertentu, disempitkan oleh location_code, age, industri dan fungsi kerja. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak tetap memulangkan HTTP 200. Nilai industri dan fungsi kerja datang daripada get_dataforseo_keywords_bing_audience_industries dan get_dataforseo_keywords_bing_audience_job_functions - kedua-duanya percuma, dan kedua-duanya wajar dibaca sebelum menyusun permintaan. Endpoint penghantaran dan pengambilan kembar bagi endpoint ini melakukan kerja yang sama secara tak segerak, pada harga yang sama, untuk kelompok yang terlalu besar untuk ditunggu.

Rujukan harga

Pemeteran: Kos respons yang dilaporkan.
Anggaran rujukan setiap permintaan: USD 0.09.
Pengganda pelanggan rujukan: 1.0. Jangan gunakan semula pada amaun pelanggan yang telah diselesaikan.

Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.

Badan

application/json

Jenis: array (object | null)[]
- age
  Jenis: array string[] | null
  
  pilihan julat umur untuk penyasaran
  nilai yang mungkin: 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
  Jenis: number | null
  
  nilai tetapan bidaan yang dikehendaki dalam USD
  nilai maksimum: 1000
- daily_budget
  Jenis: number | null
  
  nilai belanjawan kempen harian dalam USD
  nilai maksimum: 10000
- gender
  Jenis: array string[] | null
  
  jantina untuk disasarkan
  nilai yang mungkin: male, female, unknown
- industry
  Jenis: array string[] | null
  
  industri penyasaran profil LinkedIn
  
  jika anda menggunakan medan ini, anda boleh menerima senarai nama industri yang tersedia bersama industry_id dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/industries
  
  contoh: 806301758
- job_function
  Jenis: array string[] | null
  
  fungsi kerja penyasaran profil LinkedIn
  
  jika anda menggunakan medan ini, anda boleh menerima senarai nama fungsi kerja yang tersedia bersama job_function_id dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/job_functions
  
  contoh: 806300451
- location_code
  Jenis: integer
  
  kod lokasi enjin carian
  medan wajib jika anda tidak menentukan location_name atau location_coordinate
  jika anda menggunakan medan ini, anda tidak perlu menentukan location_name atau location_coordinate
  anda boleh mendapatkan senarai lokasi enjin carian yang tersedia bersama location_code masing-masing dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/bing/locations
  contoh:
  2840
- location_coordinate
  Jenis: string
  
  koordinat GPS sesuatu lokasi
  medan wajib jika anda tidak menentukan location_name atau location_code
  jika anda menggunakan medan ini, anda tidak perlu menentukan location_name atau location_code
  parameter location_coordinate hendaklah ditentukan dalam format "latitude,longitude,radius (dalam km)"
  data akan disediakan untuk negara milik koordinat yang ditentukan
  contoh:
  29.6821525,-82.4098881,100
- location_name
  Jenis: string
  
  nama penuh lokasi enjin carian
  medan wajib jika anda tidak menentukan location_code atau location_coordinate
  jika anda menggunakan medan ini, anda tidak perlu menentukan location_code atau location_coordinate
  anda boleh mendapatkan senarai lokasi enjin carian yang tersedia bersama location_name masing-masing dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/bing/locations
  contoh:
  London,England,United Kingdom

Respons

200
Jenis: object | null · Response36Afe1097B20_KeywordsDataBingAudienceEstimationLiveResponseInfo
cost
Jenis: number | null Format: double

jumlah kos tugas, USD

status_code
Jenis: integer | null

kod status umum; anda boleh menemui senarai penuh kod respons di sini

status_message
Jenis: string | null

mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini

tasks
Jenis: array (object | null)[] | null

tatasusunan tugas

Jenis: object | null · Response36Afe1097B20_KeywordsDataBingAudienceEstimationLiveTaskInfo
cost
Jenis: number | null Format: double

jumlah kos tugas, USD

data
Jenis: object | null

mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST

propertyName
Jenis: object | null
id
Jenis: string | null

pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID

path
Jenis: array (string | null)[] | null

Laluan URL

result
Jenis: array (object | null)[] | null

tatasusunan hasil

currency
Jenis: string | null

nama mata wang

contoh: USDollar

est_audience_size
Jenis: object | null · Response36Afe1097B20_AudienceEstimationInfo

julat anggaran bilangan pengguna yang boleh dicapai setiap bulan

high
Jenis: number | null Format: double

menunjukkan had atas hasil julat

low
Jenis: number | null Format: double

menunjukkan had bawah hasil julat

est_clicks
Jenis: object | null · Response36Afe1097B20_AudienceEstimationInfo

julat anggaran bilangan klik setiap bulan

high
Jenis: number | null Format: double

menunjukkan had atas hasil julat

low
Jenis: number | null Format: double

menunjukkan had bawah hasil julat

est_cost_per_event
Jenis: object | null · Response36Afe1097B20_AudienceEstimationInfo

menunjukkan anggaran kos setiap peristiwa dalam bentuk julat

high
Jenis: number | null Format: double

menunjukkan had atas hasil julat

low
Jenis: number | null Format: double

menunjukkan had bawah hasil julat

est_ctr
Jenis: object | null · Response36Afe1097B20_AudienceEstimationInfo

julat anggaran kadar klik-lalu

high
Jenis: number | null Format: double

menunjukkan had atas hasil julat

low
Jenis: number | null Format: double

menunjukkan had bawah hasil julat

est_impressions
Jenis: object | null · Response36Afe1097B20_AudienceEstimationInfo

julat anggaran tayangan setiap bulan

high
Jenis: number | null Format: double

menunjukkan had atas hasil julat

low
Jenis: number | null Format: double

menunjukkan had bawah hasil julat

est_reach_audience_size
Jenis: integer | null Format: int64

anggaran bilangan pengguna setiap bulan

est_reach_impressions
Jenis: integer | null Format: int64

anggaran bilangan tayangan setiap bulan

est_spend
Jenis: object | null · Response36Afe1097B20_AudienceEstimationInfo

julat anggaran perbelanjaan setiap bulan

high
Jenis: number | null Format: double

menunjukkan had atas hasil julat

low
Jenis: number | null Format: double

menunjukkan had bawah hasil julat

events_lost_to_bid
Jenis: integer | null Format: int64

menunjukkan bilangan peristiwa yang hilang disebabkan bidaan input tidak mencukupi

events_lost_to_budget
Jenis: integer | null

menunjukkan bilangan peristiwa yang hilang disebabkan belanjawan input tidak mencukupi

suggested_bid
Jenis: number | null

nilai bidaan yang dicadangkan di bawah penyasaran semasa

suggested_budget
Jenis: number | null Format: double

nilai belanjawan harian yang dicadangkan di bawah penyasaran dan bidaan semasa

result_count
Jenis: integer | null Format: int64

bilangan elemen dalam array hasil

status_code
Jenis: integer | null

kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini

status_message
Jenis: string | null

mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini

time
Jenis: string | null

masa pelaksanaan, saat

tasks_count
Jenis: integer | null Format: int64

bilangan tugas dalam array tasks

tasks_error
Jenis: integer | null Format: int64

bilangan tugas dalam array tasks yang dipulangkan dengan ralat

time
Jenis: string | null

jumlah masa pelaksanaan, saat

version
Jenis: string | null

versi semasa API
application/json
400

Permintaan tidak dapat diproses. Semak parameter permintaan.
401

Kunci API Felo yang sah diperlukan.
402

Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.
403

Akaun tidak dibenarkan melakukan operasi ini.
429

Had permintaan atau had perbelanjaan telah dicapai.
502

Perkhidmatan tidak dapat menyelesaikan permintaan.
503

API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.
504

Perkhidmatan tamat masa semasa memproses permintaan.
default

Respons ralat; respons passthrough huluan mungkin menggunakan format penyedia

application/json

post/v1/beta/dataforseo/keywords_data/bing/audience_estimation/live

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"
    ]
  }
]'

Tunjukkan Skema

{
  "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
        }
      ]
    }
  ]
}

Operasi berjaya

Mencipta Tugas ‘Bing Ads Audience Estimation’ Langsung

PengesahanRequired

DataForSEO

Mencipta Tugas ‘Bing Ads Audience Estimation’ Langsung

Rujukan harga