DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
SERP Google Ai Mode HTML Langsung
Mengembalikan jawaban AI Mode Google untuk kueri, beserta sumber yang dikutipnya di Google, secara sinkron. Sumber halaman mentah alih-alih hasil terurai. 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 | null)[]
- deviceTipe: string | null
jenis perangkat
field opsional
kembalikan hasil untuk jenis perangkat tertentu
dapat mengambil nilai:desktop,mobile
nilai default:desktop - keywordTipe: string
kata kunci
field wajib
Anda dapat menentukan hingga 700 karakter di fieldkeyword
semua %## akan didekode (karakter '+' akan didekode menjadi karakter spasi)
jika Anda perlu menggunakan karakter "%" untukkeyword, tentukan sebagai "%25";
jika Anda perlu menggunakan karakter “+” untukkeyword, tentukan sebagai “%2B”; - languageTipe: string
_code kode bahasa mesin pencari
field wajib jika Anda tidak menentukanlanguage_name;
jika Anda menggunakan field ini, Anda tidak perlu menentukanlanguage_name;
Anda dapat memperoleh daftar bahasa mesin pencari yang tersedia besertalanguage_code-nya dengan membuat permintaan terpisah kehttps://api.dataforseo.com/v3/serp/google/ai_mode/languages - languageTipe: string
_name nama lengkap bahasa mesin pencari
field wajib jika Anda tidak menentukanlanguage_code;
jika Anda menggunakan field ini, Anda tidak perlu menentukanlanguage_code;
Anda dapat memperoleh daftar bahasa mesin pencari yang tersedia besertalanguage_name-nya dengan membuat permintaan terpisah kehttps://api.dataforseo.com/v3/serp/google/ai_mode/languages; - locationTipe: integer
_code kode lokasi mesin pencari
field wajib jika Anda tidak menentukanlocation_nameataulocation_coordinate
jika Anda menggunakan field ini, Anda tidak perlu menentukanlocation_nameataulocation_coordinate
Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia besertalocation_code-nya dengan membuat permintaan terpisah kehttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
contoh:2840 - locationTipe: string
_coordinate koordinat GPS suatu lokasi
field wajib jika Anda tidak menentukanlocation_nameataulocation_code
jika Anda menggunakan field ini, Anda tidak perlu menentukanlocation_nameataulocation_code
Parameterlocation_coordinateharus ditentukan dalam format "latitude,longitude,radius"
jumlah maksimum digit desimal untuk "latitude" dan "longitude": 7
nilai minimum untuk "radius": 199.9 (mm)
nilai maksimum untuk "radius": 199999 (mm)
contoh:53.476225,-2.243572,200 - locationTipe: string
_name nama lengkap lokasi mesin pencari
field wajib jika Anda tidak menentukanlocation_codeataulocation_coordinate
jika Anda menggunakan field ini, Anda tidak perlu menentukanlocation_codeataulocation_coordinate
Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia besertalocation_name-nya dengan membuat permintaan terpisah kehttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
contoh:London,England,United Kingdom - osTipe: string | null
sistem operasi perangkat
field opsional
jika Anda menentukandesktopdi fielddevice, pilih dari nilai berikut:windows,macos
nilai default:windows
jika Anda menentukanmobiledi fielddevice, pilih dari nilai berikut:android,ios
nilai default:android - tagTipe: 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 nilaitagyang ditentukan di objekdatapada respons
- Tipe: object | null · Response36Afe1097B20_SerpGoogleAiModeLiveHtmlResponseInfo200
- Tipe: number | null Format: doublecost
total biaya tugas, USD
- Tipe: integer | nullstatus
_code kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini
- Tipe: string | nullstatus
_message pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini
- Tipe: array (object | null)[] | nulltasks
array tugas
- Tipe: object | null · Response36Afe1097B20_SerpGoogleAiModeLiveHtmlTaskInfo
- costTipe: number | null Format: double
total biaya tugas, USD
- dataTipe: object | null
berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST
- propertyTipe: object | null
Name
- idTipe: string | null
pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID
- pathTipe: array (string | null)[] | null
Jalur URL
- resultTipe: array (object | null)[] | null
array hasil
- datetimeTipe: string | null
tanggal dan waktu saat hasil diterima
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
misalnya:2019-11-15 12:57:46 +00:00 - itemsTipe: array (object | null)[] | null
elemen hasil pencarian yang ditemukan di SERP
- dateTipe: string | null
tanggal dan waktu halaman HTML dipindai
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:2019-11-15 12:57:46 +00:00 - htmlTipe: string | null
halaman HTML
- pageTipe: integer | null
nomor urut halaman HTML yang dikembalikan
- itemsTipe: integer | null Format: int64
_count jumlah hasil yang dikembalikan dalam array
items - keywordTipe: string | null
kata kunci yang diterima dalam array POST
kata kunci dikembalikan dengan %## yang didekode (karakter plus '+' akan didekode menjadi karakter spasi) - languageTipe: string | null
_code kode bahasa dalam array POST
- locationTipe: integer | null
_code kode lokasi dalam array POST
- seTipe: string | null
_domain domain mesin pencari dalam array POST
- typeTipe: string | null
jenis elemen
- resultTipe: integer | null Format: int64
_count jumlah elemen dalam array hasil
- statusTipe: integer | null
_code kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini
- statusTipe: string | null
_message pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini
- timeTipe: string | null
waktu eksekusi, detik
- Tipe: integer | null Format: int64tasks
_count jumlah tugas dalam array tasks
- Tipe: integer | null Format: int64tasks
_error jumlah tugas dalam array tasks yang dikembalikan dengan error
- Tipe: string | nulltime
total waktu eksekusi, detik
- Tipe: string | nullversion
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/ai_mode/live/html \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "albert einstein"
}
]'
{
"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": [
{
"keyword": null,
"type": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"datetime": null,
"items_count": null,
"items": [
{
"page": null,
"date": null,
"html": null
}
]
}
]
}
]
}