DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Volume Pencarian Kata Kunci AI Keyword Data
Mengembalikan location_code, language_code, items_count, dan items. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Untuk volume pencarian klasik gunakan post_dataforseo_keywords_gads_search_volume_live; keduanya menjawab pertanyaan berbeda dan sering tidak sepakat.
Referensi harga
- Metering: Biaya respons yang dilaporkan.
- Estimasi referensi per permintaan: USD 0.011.
- 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)[]
- keywordsTipe: array string[]
kata kunci
field wajib
pengodean UTF-8
Jumlah maksimum kata kunci yang dapat Anda tentukan: 1000;
Jumlah maksimum karakter dalam satu kata kunci: 250;
Kata kunci akan diubah ke format huruf kecil;pelajari lebih lanjut tentang aturan dan batasan field
keyworddankeywordsdi API DataForSEO di artikel Pusat Bantuan ini - languageTipe: string
_code kode bahasa
field wajib jika Anda tidak menentukanlanguage_name
jika Anda menggunakan field ini, Anda tidak perlu menentukanlanguage_name
Anda dapat memperoleh daftar bahasa yang tersedia besertalanguage_code-nya dengan membuat permintaan terpisah kehttps://api.dataforseo.com/v3/ai_optimization/ai_keyword_data/locations_and_languages
contoh:en - languageTipe: string
_name nama lengkap bahasa
field wajib jika Anda tidak menentukanlanguage_code
jika Anda menggunakan field ini, Anda tidak perlu menentukanlanguage_code
Anda dapat memperoleh daftar bahasa yang tersedia besertalanguage_name-nya dengan membuat permintaan terpisah kehttps://api.dataforseo.com/v3/ai_optimization/ai_keyword_data/locations_and_languages
contoh:English - locationTipe: integer
_code pengenal lokasi unik
field wajib jika Anda tidak menentukanlocation_name
Catatan: Anda harus menentukanlocation_nameataulocation_code
Anda dapat memperoleh daftar lokasi yang tersedia besertalocation_code-nya dengan membuat permintaan terpisah kehttps://api.dataforseo.com/v3/ai_optimization/ai_keyword_data/locations_and_languages
contoh:2840 - locationTipe: string
_name nama lengkap lokasi
field wajib jika Anda tidak menentukanlocation_code
Catatan: Anda harus menentukanlocation_nameataulocation_code
Anda dapat memperoleh daftar lokasi yang tersedia besertalocation_name-nya dengan membuat permintaan terpisah kehttps://api.dataforseo.com/v3/ai_optimization/ai_keyword_data/locations_and_languages
contoh:United Kingdom - 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_AiOptimizationAiKeywordDataKeywordsSearchVolumeLiveResponseInfo200
- 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_AiOptimizationAiKeywordDataKeywordsSearchVolumeLiveTaskInfo
- 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
- itemsTipe: array (object | null)[] | null
berisi kata kunci yang ditentukan beserta tingkat volume penelusuran AI-nya
- aiTipe: array (object | null)[] | null
_monthly _searches tingkat volume penelusuran AI bulanan
array objek dengan tingkat volume penelusuran AI pada bulan tertentu dalam setahun - aiTipe: integer | null Format: int64
_search _volume - keywordTipe: string | null
kata kunci yang ditentukan
- itemsTipe: integer | null Format: int64
_count jumlah hasil yang dikembalikan dalam array
items - languageTipe: string | null
_code kode bahasa dalam array POST
- locationTipe: integer | null
_code kode lokasi dalam array POST
- 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/ai_optimization/ai_keyword_data/keywords_search_volume/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_name": "English",
"location_code": 2840,
"keywords": [
"iphone",
"seo"
]
}
]'
{
"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": [
{
"location_code": null,
"language_code": null,
"items_count": null,
"items": [
{
"keyword": null,
"ai_search_volume": null,
"ai_monthly_searches": [
"[Max Depth Exceeded]"
]
}
]
}
]
}
]
}