v0.2.0-beta

OpenAPI 3.1.0

Mencipta Tugas SERP Carian Google Ads

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/serp/google/ads_search/task_post

Mencipta Tugas SERP Carian Google Ads

Menghantar iklan yang berjalan terhadap kata kunci di Google ke baris gilir dan memulangkan id tugas dalam tasks[0].id. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak tetap memulangkan HTTP 200. Pasangan langsungnya menjawab serta-merta dan lebih mudah untuk satu pertanyaan; hantar ke baris gilir apabila kelompok akan melebihi satu panggilan alat.

Rujukan harga

Pemeteran: Kos respons yang dilaporkan.
Anggaran rujukan setiap permintaan: USD 0.02.
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)[]
- advertiser_ids
  Jenis: array string[]
  
  pengecam pengiklan
  
  medan wajib jika target tidak ditentukan
  
  anda boleh menentukan maksimum 25 nilai dalam tatasusunan ini;
  
  nilai advertiser_ids untuk parameter ini boleh didapati dalam endpoint Google Ads Advertisers;
- date_from
  Jenis: string
  
  tarikh mula julat masa
  
  medan pilihan
  
  medan wajib jika anda menentukan date_to;
  
  format tarikh: "yyyy-mm-dd"
  
  nilai minimum: 2018-05-31
  
  nilai maksimum: tarikh hari ini
  
  contoh:
  
  "2020-01-01"
- date_to
  Jenis: string
  
  tarikh tamat julat masa
  
  medan pilihan
  
  medan wajib jika anda menentukan date_from;
  
  format tarikh: "yyyy-mm-dd"
  
  nilai minimum: 2018-05-31
  
  nilai maksimum: tarikh hari ini
  
  contoh:
  
  "2020-01-01"
- depth
  Jenis: integer | null
  
  kedalaman penghuraian
  
  medan pilihan
  
  bilangan hasil dalam SERP
  
  nilai lalai: 40
  
  nilai maksimum: 700
  
  Akaun anda akan dicaj bagi setiap SERP yang mengandungi sehingga 40 hasil;
  Menetapkan kedalaman melebihi 40 boleh menyebabkan caj tambahan jika enjin carian mengembalikan lebih daripada 40 hasil;
  
  Kos boleh dikira di halaman Harga.
- format
  Jenis: string | null
  
  format iklan
  
  medan pilihan
  
  nilai yang mungkin: all, text, image, video
- location_code
  Jenis: integer | null
  
  kod lokasi enjin carian
  
  medan pilihan
  
  jika anda menggunakan medan ini, anda tidak perlu menentukan location_name atau location_coordinate
  
  anda boleh menerima senarai lokasi enjin carian yang tersedia berserta location_code-nya dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/google/ads_search/locations
  
  contoh:
  
  2840
  
  Nota: jika anda tidak menentukan location_name, location_code atau location_coordinate, iklan akan dicari merentas semua lokasi yang tersedia
- location_coordinate
  Jenis: string | null
  
  koordinat GPS sesuatu lokasi
  
  medan pilihan
  
  jika anda menggunakan medan ini, anda tidak perlu menentukan location_name atau location_code
  
  contoh:
  
  52.6178549,-155.352142
  
  Nota: jika anda tidak menentukan location_name, location_code atau location_coordinate, iklan akan dicari merentas semua lokasi yang tersedia
- location_name
  Jenis: string | null
  
  nama penuh lokasi enjin carian
  
  medan pilihan
  
  jika anda menggunakan medan ini, anda tidak perlu menentukan location_code atau location_coordinate
  
  anda boleh menerima senarai lokasi enjin carian yang tersedia berserta location_name-nya dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/google/ads_search/locations
  
  contoh:
  
  London,England,United Kingdom
  
  Nota: jika anda tidak menentukan location_name, location_code atau location_coordinate, iklan akan dicari merentas semua lokasi yang tersedia
- pingback_url
  Jenis: string | null
  
  URL pemberitahuan tugas yang selesai
  
  medan pilihan
  
  selepas tugas selesai, kami akan memberitahu anda dengan permintaan GET yang dihantar ke URL yang anda tentukan
  
  anda boleh menggunakan rentetan ‘$id’ sebagai pemboleh ubah $id dan ‘$tag’ sebagai pemboleh ubah $tag yang dikodkan URL. Kami akan menetapkan nilai yang diperlukan sebelum menghantar permintaan.
  
  contoh:
  
  http://your-server.com/pingscript?id=$id
  
  http://your-server.com/pingscript?id=$id&tag=$tag
  
  Nota: aksara khas dalam pingback_url akan dikodkan URL;
  
  khususnya, aksara # akan dikodkan sebagai %23
  
  ketahui lebih lanjut di Pusat Bantuan kami
- platform
  Jenis: string | null
  
  platform pengiklanan
  
  medan pilihan
  
  nilai yang mungkin: all, google_play, google_maps, google_search, google_shopping, youtube
  
  nilai lalai: all
- postback_data
  Jenis: string
  
  jenis data postback_url
  
  medan wajib jika anda menentukan postback_url
  
  sepadan dengan fungsi yang anda gunakan untuk menetapkan tugas
  
  nilai sah:
  
  advanced
- postback_url
  Jenis: string | null
  
  URL untuk menghantar hasil tugas
  
  medan pilihan
  
  selepas tugas selesai, kami akan menghantar permintaan POST dengan hasilnya yang dimampatkan dalam format gzip ke postback_url yang anda tentukan
  
  anda boleh menggunakan rentetan ‘$id’ sebagai pemboleh ubah $id dan ‘$tag’ sebagai pemboleh ubah $tag yang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum menghantar permintaan.
  
  contoh:
  
  http://your-server.com/postbackscript?id=$id
  
  http://your-server.com/postbackscript?id=$id&tag=$tag
  
  Nota: aksara khas dalam postback_url akan di-urlencode;
  
  iaitu, aksara # akan dikodkan menjadi %23
  
  ketahui lebih lanjut di Pusat Bantuan kami
- priority
  Jenis: integer | null
  
  keutamaan tugas
  
  medan pilihan
  
  boleh mengambil nilai berikut:
  
  1 – keutamaan pelaksanaan biasa (ditetapkan secara lalai)
  
  2 – keutamaan pelaksanaan tinggi
  
  Anda akan dicaj tambahan untuk tugas dengan keutamaan pelaksanaan tinggi.
  Kos boleh dikira di halaman Harga
- tag
  Jenis: string | null
  
  pengecam tugas yang ditentukan pengguna
  
  medan pilihan
  
  had aksara ialah 255
  
  anda boleh menggunakan parameter ini untuk mengenal pasti tugas dan memadankannya dengan hasil
  
  anda akan menemui nilai tag yang ditentukan dalam objek data respons
- target
  Jenis: string
  
  nama domain
  
  medan wajib jika advertiser_ids tidak ditentukan
  
  nama domain yang dikaitkan dengan akaun pengiklan

Respons

200
Jenis: object | null · Response36Afe1097B20_SerpGoogleAdsSearchTaskPostResponseInfo
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_SerpGoogleAdsSearchTaskPostTaskInfo
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: object | null

tatasusunan hasil
dalam kes ini, nilainya akan menjadi null

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/serp/google/ads_search/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ads_search/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "platform": "google_search",
    "advertiser_ids": [
      "AR13752565271262920705",
      "AR02439908557932462081"
    ]
  }
]'

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": null
    }
  ]
}

Operasi berjaya

Mencipta Tugas SERP Carian Google Ads

PengesahanRequired

DataForSEO

Mencipta Tugas SERP Carian Google Ads

Rujukan harga