v0.2.0-beta

OpenAPI 3.1.0

Membuat Tugas ‘Bing Ads Audience Estimation’ Langsung

Felo API Support

MIT

Server

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

Membuat Tugas ‘Bing Ads Audience Estimation’ Langsung

Memperkirakan audiens Bing Ads yang dapat dijangkau pada bid dan daily_budget tertentu, dipersempit oleh location_code, age, industri, dan fungsi pekerjaan. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Nilai industri dan fungsi pekerjaan berasal dari get_dataforseo_keywords_bing_audience_industries dan get_dataforseo_keywords_bing_audience_job_functions - keduanya gratis, dan keduanya layak dibaca sebelum menyusun permintaan. Endpoint pengiriman dan pengambilan kembar dari endpoint ini melakukan pekerjaan yang sama secara asinkron, dengan harga yang sama, untuk kumpulan yang terlalu besar untuk ditunggu.

Referensi harga

Metering: Biaya respons yang dilaporkan.
Estimasi referensi per permintaan: USD 0.09.
Pengali pelanggan referensi: 1.0. Jangan terapkan lagi pada jumlah pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

Isi

application/json

Tipe: array (object | null)[]
- age
  Tipe: array string[] | null
  
  pilihan rentang usia untuk penargetan
  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
  Tipe: number | null
  
  nilai setelan tawaran yang diinginkan dalam USD
  nilai maksimum: 1000
- daily_budget
  Tipe: number | null
  
  nilai anggaran kampanye harian dalam USD
  nilai maksimum: 10000
- gender
  Tipe: array string[] | null
  
  jenis kelamin untuk penargetan
  nilai yang mungkin: male, female, unknown
- industry
  Tipe: array string[] | null
  
  industri penargetan profil LinkedIn
  
  jika Anda menggunakan field ini, Anda dapat menerima daftar nama industri yang tersedia beserta industry_id dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/industries
  
  contoh: 806301758
- job_function
  Tipe: array string[] | null
  
  fungsi pekerjaan penargetan profil LinkedIn
  
  jika Anda menggunakan field ini, Anda dapat menerima daftar nama fungsi pekerjaan yang tersedia beserta job_function_id dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/job_functions
  
  contoh: 806300451
- location_code
  Tipe: integer
  
  kode lokasi mesin pencari
  field wajib jika Anda tidak menentukan location_name atau location_coordinate
  jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name atau location_coordinate
  Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia beserta location_code-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/bing/locations
  contoh:
  2840
- location_coordinate
  Tipe: string
  
  koordinat GPS suatu lokasi
  field wajib jika Anda tidak menentukan location_name atau location_code
  jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name atau location_code
  parameter location_coordinate harus ditentukan dalam format "latitude,longitude,radius (dalam km)"
  data akan diberikan untuk negara tempat koordinat yang ditentukan berada
  contoh:
  29.6821525,-82.4098881,100
- location_name
  Tipe: string
  
  nama lengkap lokasi mesin pencari
  field wajib jika Anda tidak menentukan location_code atau location_coordinate
  jika Anda menggunakan field ini, Anda tidak perlu menentukan location_code atau location_coordinate
  Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia beserta location_name-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/bing/locations
  contoh:
  London,England,United Kingdom

Respons

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

total biaya tugas, USD

status_code
Tipe: integer | null

kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini

status_message
Tipe: string | null

pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

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

array tugas

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

total biaya tugas, USD

data
Tipe: object | null

berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST

propertyName
Tipe: object | null
id
Tipe: string | null

pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID

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

Jalur URL

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

array hasil

currency
Tipe: string | null

nama mata uang

misalnya: USDollar

est_audience_size
Tipe: object | null · Response36Afe1097B20_AudienceEstimationInfo

rentang perkiraan jumlah pengguna yang dapat dijangkau per bulan

high
Tipe: number | null Format: double

menunjukkan batas atas hasil rentang

low
Tipe: number | null Format: double

menunjukkan batas bawah hasil rentang

est_clicks
Tipe: object | null · Response36Afe1097B20_AudienceEstimationInfo

rentang perkiraan jumlah klik per bulan

high
Tipe: number | null Format: double

menunjukkan batas atas hasil rentang

low
Tipe: number | null Format: double

menunjukkan batas bawah hasil rentang

est_cost_per_event
Tipe: object | null · Response36Afe1097B20_AudienceEstimationInfo

menunjukkan perkiraan biaya per peristiwa dalam bentuk rentang

high
Tipe: number | null Format: double

menunjukkan batas atas hasil rentang

low
Tipe: number | null Format: double

menunjukkan batas bawah hasil rentang

est_ctr
Tipe: object | null · Response36Afe1097B20_AudienceEstimationInfo

rentang perkiraan rasio klik-tayang

high
Tipe: number | null Format: double

menunjukkan batas atas hasil rentang

low
Tipe: number | null Format: double

menunjukkan batas bawah hasil rentang

est_impressions
Tipe: object | null · Response36Afe1097B20_AudienceEstimationInfo

rentang perkiraan tayangan per bulan

high
Tipe: number | null Format: double

menunjukkan batas atas hasil rentang

low
Tipe: number | null Format: double

menunjukkan batas bawah hasil rentang

est_reach_audience_size
Tipe: integer | null Format: int64

perkiraan jumlah pengguna per bulan

est_reach_impressions
Tipe: integer | null Format: int64

perkiraan jumlah tayangan per bulan

est_spend
Tipe: object | null · Response36Afe1097B20_AudienceEstimationInfo

rentang perkiraan pengeluaran per bulan

high
Tipe: number | null Format: double

menunjukkan batas atas hasil rentang

low
Tipe: number | null Format: double

menunjukkan batas bawah hasil rentang

events_lost_to_bid
Tipe: integer | null Format: int64

menunjukkan jumlah peristiwa yang hilang karena tawaran masukan tidak mencukupi

events_lost_to_budget
Tipe: integer | null

menunjukkan jumlah peristiwa yang hilang karena anggaran masukan tidak mencukupi

suggested_bid
Tipe: number | null

nilai tawaran yang disarankan pada penargetan saat ini

suggested_budget
Tipe: number | null Format: double

nilai anggaran harian yang disarankan pada penargetan dan tawaran saat ini

result_count
Tipe: integer | null Format: int64

jumlah elemen dalam array hasil

status_code
Tipe: integer | null

kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini

status_message
Tipe: string | null

pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

time
Tipe: string | null

waktu eksekusi, detik

tasks_count
Tipe: integer | null Format: int64

jumlah tugas dalam array tasks

tasks_error
Tipe: integer | null Format: int64

jumlah tugas dalam array tasks yang dikembalikan dengan error

time
Tipe: string | null

total waktu eksekusi, detik

version
Tipe: string | null

versi API saat ini
application/json
400

Permintaan tidak dapat diproses. Periksa parameter permintaan.
401

Kunci API Felo yang valid diperlukan.
402

Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.
403

Akun tidak diizinkan melakukan operasi ini.
429

Batas permintaan atau batas pengeluaran telah tercapai.
502

Layanan tidak dapat menyelesaikan permintaan.
503

API atau layanan penagihan untuk sementara tidak tersedia.
504

Layanan kehabisan waktu saat memproses permintaan.
default

Respons error; respons passthrough upstream dapat 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"
    ]
  }
]'

Tampilkan 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 berhasil

Membuat Tugas ‘Bing Ads Audience Estimation’ Langsung

AutentikasiRequired

DataForSEO

Membuat Tugas ‘Bing Ads Audience Estimation’ Langsung

Referensi harga