DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
ChatGPT LLM Scraper Langsung
Menanyakan keyword ke ChatGPT seperti yang dilakukan pengguna dan mengembalikan jawaban yang telah diurai. Mengembalikan keyword, location_code, language_code, model, datetime, markdown, sources, fan_out_queries, dan brand_entities - markdown adalah jawaban seperti yang dirender asisten, sources adalah halaman yang dikutipnya, dan brand_entities adalah merek yang disebutkannya. force_web_search membuatnya menjelajah alih-alih menjawab dari pelatihan. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Ini adalah endpoint untuk 'apa kata ChatGPT tentang kami'; untuk menghitung penyebutan di banyak jawaban gunakan post_dataforseo_ai_llm_mentions_aggregated_metrics_live alih-alih mengikis berulang kali. Bentuk mentahnya adalah post_dataforseo_ai_chat_gpt_llm_scraper_live_html.
Referensi harga
- Metering: Biaya respons yang dilaporkan.
- Estimasi referensi per permintaan: USD 0.004.
- 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)[]
- forceTipe: boolean | null
_web _search paksa agen AI menggunakan pencarian web
field opsional
jika diaktifkan, model AI dipaksa mengakses dan mengutip informasi web terkini;
nilai default:false;
Catatan: meskipun parameter disetel ketrue, tidak ada jaminan sumber web akan dikutip dalam respons - keywordTipe: string
kata kunci
field wajib
Anda dapat menentukan hingga 2000 karakter di fieldkeyword
semua %## akan didekode (karakter ‘+’ juga akan didekode menjadi karakter spasi)
jika Anda perlu menggunakan karakter “%” untukkeyword, tentukan sebagai “%25”;
jika Anda perlu menggunakan karakter “+” untukkeyword, tentukan sebagai “%2B”pelajari lebih lanjut tentang aturan dan batasan field
keyworddankeywordsdi API DataForSEO di artikel Pusat Bantuan ini - 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/ai_optimization/chat_gpt/llm_scraper/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/ai_optimization/chat_gpt/llm_scraper/languages - locationTipe: integer
_code kode lokasi mesin pencari
field wajib jika Anda tidak menentukanlocation_name
jika Anda menggunakan field ini, Anda tidak perlu menentukanlocation_name
Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia besertalocation_code-nya dengan membuat permintaan terpisah kehttps://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations
contoh:2840 - locationTipe: string
_name nama lengkap lokasi mesin pencari
field wajib jika Anda tidak menentukanlocation_code
jika Anda menggunakan field ini, Anda tidak perlu menentukanlocation_code
Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia besertalocation_name-nya dengan membuat permintaan terpisah kehttps://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations
contoh:United States - 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_AiOptimizationChatGptLlmScraperLiveAdvancedResponseInfo200
- 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_AiOptimizationChatGptLlmScraperLiveAdvancedTaskInfo
- 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
- brandTipe: array (object | null)[] | null
_entities array entitas merek
berisi informasi tentang merek yang disebutkan dalam respons- categoryTipe: string | null
kategori merek
- markdownTipe: string | null
- titleTipe: string | null
nama merek
- typeTipe: string | null
jenis elemen
- urlsTipe: object | null
array URL dan domain yang relevan dengan merek
- checkTipe: string | null
_url URL langsung ke hasil mesin pencari
Anda dapat menggunakannya untuk memastikan kami memberikan hasil yang tepat - 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 - fanTipe: array (string | null)[] | null
_out _queries array kueri fan-out
berisi kueri penelusuran terkait yang diturunkan dari kueri utama untuk memberikan respons yang lebih menyeluruh - itemTipe: array (string | null)[] | null
_types jenis hasil penelusuran
berisi jenis hasil penelusuran (items) yang ditemukan di SERP.
jenis item yang mungkin:chat_gpt_text,chat_gpt_table,chat_gpt_navigation_list,chat_gpt_images,chat_gpt_local_businesses,chat_gpt_products - itemsTipe: array (object | null)[] | null
elemen hasil ChatGPT
- rankTipe: integer | null
_absolute peringkat absolut di SERP
posisi absolut di antara semua elemen - rankTipe: integer | null
_group peringkat grup di SERP
posisi dalam grup elemen dengan nilaitypeyang sama
posisi elemen dengan nilaitypeberbeda dihilangkan darirank_group - typeTipe: string | null
jenis elemen
- 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 (simbol plus '+' akan didekode menjadi karakter spasi) - languageTipe: string | null
_code kode bahasa dalam array POST
- locationTipe: integer | null
_code kode lokasi dalam array POST
- markdownTipe: string | null
- modelTipe: string | null
menunjukkan versi model
- seTipe: integer | null Format: int64
_results _count total hasil
- searchTipe: array (object | null)[] | null
_results array hasil penelusuran
semua keluaran penelusuran web yang diambil model saat mencari informasi, termasuk duplikat dan entri yang tidak digunakan- breadcrumbTipe: string | null
jejak navigasi (breadcrumb)
- descriptionTipe: string | null
deskripsi hasil
- domainTipe: string | null
domain hasil
- titleTipe: string | null
judul hasil
- typeTipe: string | null
jenis elemen
- urlTipe: string | null
URL hasil
- sourcesTipe: array (object | null)[] | null
array sumber
sumber yang benar-benar dikutip atau dijadikan rujukan model dalam jawaban akhirnya- domainTipe: string | null
domain sumber di SERP
- markdownTipe: string | null
- publicationTipe: string | null
_date tanggal dan waktu hasil diterbitkan
dalam format: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”
contoh:2019-11-15 12:57:46 +00:00 - snippetTipe: string | null
deskripsi sumber
- sourceTipe: string | null
_name nama sumber
- thumbnailTipe: string | null
thumbnail sumber
- titleTipe: string | null
judul sumber
- typeTipe: string | null
jenis elemen
- urlTipe: string | null
URL sumber
- 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/chat_gpt/llm_scraper/live/advanced \
--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,
"location_code": null,
"language_code": null,
"model": null,
"check_url": null,
"datetime": null,
"markdown": null,
"search_results": [
{
"type": null,
"url": null,
"domain": null,
"title": null,
"description": null,
"breadcrumb": null
}
],
"sources": [
{
"type": null,
"title": null,
"snippet": null,
"domain": null,
"url": null,
"thumbnail": null,
"source_name": null,
"publication_date": null,
"markdown": null
}
],
"fan_out_queries": [
null
],
"brand_entities": [
{
"type": null,
"title": null,
"category": null,
"markdown": null,
"urls": null
}
],
"se_results_count": null,
"item_types": [
null
],
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null
}
]
}
]
}
]
}