DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Pencarian Google Ads Lanjutan Langsung
Mengembalikan iklan yang berjalan terhadap kata kunci di Google, secara sinkron. Mengembalikan keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count, dan items. advanced adalah pilihan default; ambil regular bila hanya daftar peringkat yang penting dan html hanya untuk memeriksa apa yang dibuang parser. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200.
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.
- Tipe: array object[]
- advertiserTipe: array string[]
_ids wajibPengenal pengiklan; wajib jika target tidak ditentukan
- locationTipe: integer
_code Kode lokasi mesin pencari
- locationTipe: string
_coordinate Koordinat GPS suatu lokasi
- locationTipe: string
_name Nama lengkap lokasi mesin pencari
- targetTipe: string
Nama domain yang terkait dengan akun pengiklan; wajib jika advertiser_ids tidak ditentukan
- Tipe: object200
Respons berhasil
- Tipe: numbercost
Total biaya tugas, USD
- Tipe: integerstatus
_code Kode status umum
- Tipe: stringstatus
_message Pesan informasi umum
- Tipe: array string[]tasks
Array tugas
- Tipe: array string[]tasks[]
.result Array hasil SERP langsung
- Tipe: stringtime
Waktu eksekusi, detik
- Tipe: stringversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ads_search/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{}
]'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks": [
"string"
],
"tasks[].result": [
"string"
]
}