v0.2.0-beta

OpenAPI 3.1.0

Membuat Tugas SERP Pencarian Google Ads

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

Membuat Tugas SERP Pencarian Google Ads

Mengantrekan iklan yang berjalan terhadap kata kunci di Google, mengembalikan id tugas di tasks[0].id. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Pasangan live-nya menjawab segera dan lebih sederhana untuk satu kueri; antrekan bila batch akan melebihi satu panggilan alat.

Referensi harga

Metering: Biaya respons yang dilaporkan.
Estimasi referensi per permintaan: USD 0.02.
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)[]
- advertiser_ids
  Tipe: array string[]
  
  pengenal pengiklan
  
  field wajib jika target tidak ditentukan
  
  Anda dapat menentukan maksimum 25 nilai dalam array ini;
  
  nilai advertiser_ids untuk parameter ini dapat ditemukan di endpoint Google Ads Advertisers;
- date_from
  Tipe: string
  
  tanggal mulai rentang waktu
  
  field opsional
  
  field wajib jika Anda menentukan date_to;
  
  format tanggal: "yyyy-mm-dd"
  
  nilai minimum: 2018-05-31
  
  nilai maksimum: tanggal hari ini
  
  contoh:
  
  "2020-01-01"
- date_to
  Tipe: string
  
  tanggal akhir rentang waktu
  
  field opsional
  
  field wajib jika Anda menentukan date_from;
  
  format tanggal: "yyyy-mm-dd"
  
  nilai minimum: 2018-05-31
  
  nilai maksimum: tanggal hari ini
  
  contoh:
  
  "2020-01-01"
- depth
  Tipe: integer | null
  
  kedalaman parsing
  
  field opsional
  
  jumlah hasil di SERP
  
  nilai default: 40
  
  nilai maksimum: 700
  
  Akun Anda akan ditagih per setiap SERP yang berisi hingga 40 hasil;
  Menetapkan kedalaman di atas 40 dapat mengakibatkan biaya tambahan jika mesin pencari mengembalikan lebih dari 40 hasil;
  
  Biaya dapat dihitung di halaman Harga.
- format
  Tipe: string | null
  
  format iklan
  
  field opsional
  
  nilai yang mungkin: all, text, image, video
- location_code
  Tipe: integer | null
  
  kode lokasi mesin pencari
  
  field opsional
  
  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/serp/google/ads_search/locations
  
  contoh:
  
  2840
  
  Catatan: jika Anda tidak menentukan location_name, location_code, atau location_coordinate, iklan akan dicari di semua lokasi yang tersedia
- location_coordinate
  Tipe: string | null
  
  koordinat GPS suatu lokasi
  
  field opsional
  
  jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name atau location_code
  
  contoh:
  
  52.6178549,-155.352142
  
  Catatan: jika Anda tidak menentukan location_name, location_code, atau location_coordinate, iklan akan dicari di semua lokasi yang tersedia
- location_name
  Tipe: string | null
  
  nama lengkap lokasi mesin pencari
  
  field opsional
  
  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/serp/google/ads_search/locations
  
  contoh:
  
  London,England,United Kingdom
  
  Catatan: jika Anda tidak menentukan location_name, location_code, atau location_coordinate, iklan akan dicari di semua lokasi yang tersedia
- pingback_url
  Tipe: string | null
  
  URL notifikasi tugas yang selesai
  
  field opsional
  
  setelah tugas selesai, kami akan memberi tahu Anda dengan permintaan GET yang dikirim ke URL yang Anda tentukan
  
  Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag yang dienkode URL. Kami akan menetapkan nilai yang diperlukan sebelum mengirim permintaan.
  
  contoh:
  
  http://your-server.com/pingscript?id=$id
  
  http://your-server.com/pingscript?id=$id&tag=$tag
  
  Catatan: karakter khusus di pingback_url akan dienkode URL;
  
  khususnya, karakter # akan dienkode menjadi %23
  
  pelajari lebih lanjut di Pusat Bantuan kami
- platform
  Tipe: string | null
  
  platform periklanan
  
  field opsional
  
  nilai yang mungkin: all, google_play, google_maps, google_search, google_shopping, youtube
  
  nilai default: all
- postback_data
  Tipe: string
  
  tipe data postback_url
  
  field wajib jika Anda menentukan postback_url
  
  sesuai dengan fungsi yang Anda gunakan untuk menyetel tugas
  
  nilai yang mungkin:
  
  advanced
- postback_url
  Tipe: string | null
  
  URL untuk mengirim hasil tugas
  
  field opsional
  
  setelah tugas selesai, kami akan mengirim permintaan POST dengan hasilnya yang dikompresi dalam format gzip ke postback_url yang Anda tentukan
  
  Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag yang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum mengirim permintaan.
  
  contoh:
  
  http://your-server.com/postbackscript?id=$id
  
  http://your-server.com/postbackscript?id=$id&tag=$tag
  
  Catatan: karakter khusus dalam postback_url akan di-urlencode;
  
  yaitu, karakter # akan dienkode menjadi %23
  
  pelajari selengkapnya di Pusat Bantuan kami
- priority
  Tipe: integer | null
  
  prioritas tugas
  
  field opsional
  
  dapat mengambil nilai berikut:
  
  1 – prioritas eksekusi normal (ditetapkan secara default)
  
  2 – prioritas eksekusi tinggi
  
  Anda akan dikenai biaya tambahan untuk tugas dengan prioritas eksekusi tinggi.
  Biaya dapat dihitung di halaman Harga
- tag
  Tipe: string | null
  
  pengenal tugas yang ditentukan pengguna
  
  field opsional
  
  batas karakter adalah 255
  
  Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil
  
  Anda akan menemukan nilai tag yang ditentukan di objek data pada respons
- target
  Tipe: string
  
  nama domain
  
  field wajib jika advertiser_ids tidak ditentukan
  
  nama domain yang terkait dengan akun pengiklan

Respons

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

array hasil
dalam kasus ini, nilainya akan menjadi null

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

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

Operasi berhasil

Membuat Tugas SERP Pencarian Google Ads

AutentikasiRequired

DataForSEO

Membuat Tugas SERP Pencarian Google Ads

Referensi harga