DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
SERP Organik Google Lanjutan Langsung
Mengembalikan hasil peringkat untuk 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.0175.
- 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)[]
- browserTipe: integer | null
_screen _height tinggi layar browser field opsional Anda dapat menetapkan tinggi layar browser kustom untuk menghitung peringkat piksel untuk perangkat tertentu; dapat ditentukan dalam rentang berikut: 240-9999; secara default, parameter diatur ke: 1080 untuk desktop; 640 untuk mobile di android; 812 untuk mobile di iOS; Catatan: untuk menggunakan parameter ini, setel calculate_rectangles ke true
- browserTipe: integer | null
_screen _resolution _ratio rasio resolusi layar browser field opsional Anda dapat menetapkan rasio resolusi layar browser kustom untuk menghitung peringkat piksel untuk perangkat tertentu; dapat ditentukan dalam rentang berikut: 0.5-3; secara default, parameter diatur ke: 1 untuk desktop; 3 untuk mobile di android; 3 untuk mobile di iOS; Catatan: untuk menggunakan parameter ini, setel calculate_rectangles ke true
- browserTipe: integer | null Format: int64
_screen _width lebar layar browser field opsional Anda dapat menetapkan lebar layar browser kustom untuk menghitung peringkat piksel untuk perangkat tertentu; dapat ditentukan dalam rentang berikut: 240-9999; secara default, parameter diatur ke: 1920 untuk desktop; 360 untuk mobile di android; 375 untuk mobile di iOS; Catatan: untuk menggunakan parameter ini, setel calculate_rectangles ke true
- calculateTipe: boolean | null
_rectangles hitung peringkat piksel untuk elemen SERP dalam hasil lanjutan field opsional peringkat piksel mengacu pada jarak antara cuplikan hasil dan sudut kiri atas layar; Kunjungi Pusat Bantuan untuk mempelajari lebih lanjut>> secara default, parameter diatur ke false; Catatan: Anda akan dikenai biaya tambahan $0.002 untuk penggunaan parameter ini
- depthTipe: integer | null
kedalaman parsing field opsional jumlah hasil di SERP nilai default: 10 nilai maksimum: 200 Akun Anda akan ditagih per setiap SERP yang berisi hingga 10 hasil; Menetapkan kedalaman di atas 10 dapat mengakibatkan biaya tambahan jika mesin pencari mengembalikan lebih dari 10 hasil; Biaya dapat dihitung di halaman Harga.
- deviceTipe: string | null
jenis perangkat field opsional kembalikan hasil untuk jenis perangkat tertentu dapat mengambil nilai: desktop, mobile nilai default: desktop
- findTipe: array string[] | null
_targets _in jenis elemen SERP yang akan diperiksa untuk target field opsional untuk mengaktifkan parameter ini, stop_crawl_on_match juga harus diaktifkan tentukan jenis elemen SERP yang akan diperiksa untuk kecocokan target jika tidak ditentukan, semua elemen tingkat pertama yang memiliki field url dan domain akan diperiksa untuk target nilai yang mungkin: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Catatan: tidak boleh berisi jenis elemen yang sama dengan ignore_targets_in contoh: "find_targets_in": ["organic", "featured_snippet"] pelajari lebih lanjut tentang parameter ini di Pusat Bantuan kami
- groupTipe: boolean | null
_organic _results tampilkan hasil terkait field opsional jika diatur ke true, elemen related_result dalam respons akan diberikan sebagai cuplikan hasil organik asli; jika diatur ke false, elemen related_result akan diberikan sebagai hasil organik terpisah; nilai default: true
- ignoreTipe: array string[] | null
_targets _in jenis elemen SERP yang akan dikecualikan dari pencarian target field opsional untuk mengaktifkan parameter ini, stop_crawl_on_match juga harus diaktifkan tentukan jenis elemen SERP yang akan dikecualikan saat mencari kecocokan target nilai yang mungkin: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Catatan: tidak boleh berisi jenis elemen yang sama dengan find_targets_in contoh: "ignore_targets_in": ["paid", "images"] pelajari lebih lanjut tentang parameter ini di Pusat Bantuan kami
- keywordTipe: string
kata kunci field wajib Anda dapat menentukan hingga 700 karakter di field keyword semua %## akan didekode (karakter ‘+’ juga akan didekode menjadi karakter spasi) jika Anda perlu menggunakan karakter “%” untuk keyword, tentukan sebagai “%25”; jika Anda perlu menggunakan karakter “+” untuk keyword, tentukan sebagai “%2B”; jika field ini berisi parameter seperti ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘cache:’, ‘define:’, ‘definition:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘site:’, biaya per tugas akan dikalikan 5 pelajari lebih lanjut tentang aturan dan batasan field keyword dan keywords di API DataForSEO di artikel Pusat Bantuan ini
- languageTipe: string | null
_code kode bahasa mesin pencari field opsional jika Anda menentukan language_name jika Anda menggunakan field ini, Anda tidak perlu menentukan language_name Anda dapat memperoleh daftar bahasa yang tersedia dari mesin pencari dengan language_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/google/languages contoh: en
- languageTipe: string | null
_name nama lengkap bahasa mesin pencari field opsional jika Anda menentukan language_code jika Anda menggunakan field ini, Anda tidak perlu menentukan language_code Anda dapat memperoleh daftar bahasa yang tersedia dari mesin pencari dengan language_name dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/google/languages contoh: English
- loadTipe: boolean | null
_async _ai _overview muat ikhtisar AI secara asinkron field opsional atur ke true untuk menerima item ai_overview di SERP meskipun dimuat secara asinkron; jika diatur ke false, Anda hanya akan menerima item ai_overview dari cache; nilai default: false Catatan: Anda akan dikenai biaya tambahan $0.002 untuk penggunaan parameter ini; jika elemen tidak ada atau berisi "asynchronous_ai_overview": false, seluruh biaya tambahan akan dikembalikan ke saldo akun Anda
- locationTipe: integer | null
_code kode lokasi mesin pencari field wajib jika Anda tidak menentukan location_name atau location_coordinate jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name atau location_coordinate Anda dapat memperoleh daftar lokasi yang tersedia dari mesin pencari dengan location_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/google/locations contoh: 2840
- locationTipe: string | null
_coordinate koordinat GPS suatu lokasi field opsional jika Anda menentukan location_name atau location_code jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name atau location_code parameter location_coordinate harus ditentukan dalam format "latitude,longitude,radius" jumlah maksimum digit desimal untuk "latitude" dan "longitude": 7 nilai minimum untuk "radius": 199 (mm) nilai maksimum untuk "radius": 199999 (mm) contoh: 53.476225,-2.243572,200
- locationTipe: string | null
_name nama lengkap lokasi mesin pencari field wajib jika Anda tidak menentukan location_code atau location_coordinate jika Anda menggunakan field ini, Anda tidak perlu menentukan location_code atau location_coordinate Anda dapat memperoleh daftar lokasi yang tersedia dari mesin pencari dengan location_name dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/google/locations contoh: London,England,United Kingdom
- matchTipe: string | null
_type jenis kecocokan target field wajib jika stop_crawl_on_match ditentukan jenis kecocokan untuk match_value nilai yang mungkin: domain – domain atau subdomain tertentu with_subdomains – domain utama dan subdomainnya wildcard – pola wildcard
- matchTipe: string | null
_value nilai domain, subdomain, atau wildcard target field wajib jika stop_crawl_on_match ditentukan tentukan domain, subdomain, atau nilai wildcard target; Catatan: domain atau subdomain harus ditentukan tanpa protokol permintaan; contoh: "match_value": "dataforseo.com","match_value": "/blog/post-*"
- maxTipe: integer | null
_crawl _pages batas perayapan halaman field opsional jumlah halaman hasil pencarian yang akan dirayapi nilai maksimum: 100 Catatan: Anda akan ditagih untuk setiap halaman yang dirayapi (10 hasil organik per halaman); pelajari lebih lanjut tentang harga di halaman Harga kami; Catatan #2: parameter max_crawl_pages dan depth saling melengkapi; pelajari lebih lanjut di pusat bantuan kami
- osTipe: string | null
sistem operasi perangkat field opsional jika Anda menentukan desktop di field device, pilih dari nilai berikut: windows, macos nilai default: windows jika Anda menentukan mobile di field device, pilih dari nilai berikut: android, ios nilai default: android
- peopleTipe: integer | null
_also _ask _click _depth klik pada elemen terkait field opsional tentukan kedalaman klik pada elemen people_also_ask untuk menerima item people_also_ask_element tambahan; Catatan akun Anda akan dikenai biaya tambahan $0.00015 untuk setiap klik; jika elemen tidak ada atau kami melakukan lebih sedikit klik daripada yang Anda tentukan, seluruh biaya tambahan akan dikembalikan ke saldo akun Anda nilai yang mungkin: dari 1 hingga 4
- removeTipe: array string[] | null
_from _url hapus parameter tertentu dari URL field opsional dengan field ini, Anda dapat menentukan hingga 10 parameter yang akan dihapus dari URL dalam hasil contoh: "remove_from_url": ["srsltid"] Catatan: jika field target ditentukan, parameter URL yang ditentukan akan dihapus sebelum penelusuran
- seTipe: string | null
_domain domain mesin pencari field opsional kami memilih domain mesin pencari yang relevan secara otomatis sesuai lokasi dan bahasa yang Anda tentukan namun, Anda dapat menetapkan domain mesin pencari kustom di field ini contoh: google.co.uk, google.com.au, google.de, dll.
- searchTipe: string | null
_param parameter tambahan dari kueri pencarian field opsional dapatkan daftar parameter yang tersedia dan detail tambahan di sini Catatan: parameter mesin pencari berikut tidak didukung dan akan otomatis dibatalkan jika ditentukan: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
- stopTipe: array (object | null)[] | null
_crawl _on _match array target untuk menghentikan perayapan field opsional jika ditentukan, respons akan berisi hasil SERP hingga dan termasuk match_value yang ditentukan; Anda dapat menentukan hingga 10 nilai target dalam array ini contoh: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] pelajari selengkapnya tentang parameter ini di Pusat Bantuan kami - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Akun Anda akan ditagih untuk setiap SERP yang dirayapi melalui target yang ditentukan
- matchTipe: string | null
_type jenis pencocokan target field wajib jika stop_crawl_on_match ditentukan; jenis pencocokan untuk match_value nilai yang mungkin: domain, with_subdomains, wildcard
- matchTipe: string | null
_value domain target atau nilai wildcard field wajib jika stop_crawl_on_match ditentukan; tentukan domain target atau nilai wildcard; Catatan: nama domain harus ditentukan tanpa protokol permintaan; contoh: dataforseo.com
- 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 nilai tag yang ditentukan di objek data respons
- targetTipe: string | null
domain, subdomain, atau halaman web target untuk mendapatkan hasil field opsional domain atau subdomain harus ditentukan tanpa https:// dan www. perhatikan bahwa hasil tugas khusus target hanya akan menyertakan elemen SERP yang berisi string url; Anda juga dapat menggunakan karakter pengganti (‘’) untuk menentukan pola pencarian di SERP dan mempersempit hasil; contoh: example.com - mengembalikan hasil untuk halaman beranda situs web dengan URL seperti https://example.com, atau https://www.example.com/, atau https://example.com/; example.com - mengembalikan hasil untuk domain, termasuk semua halaman domain; example.com - mengembalikan hasil untuk seluruh domain, termasuk semua halaman dan subdomain; example.com - mengembalikan hasil untuk halaman beranda terlepas dari subdomain, seperti https://en.example.com; example.com/example-page - mengembalikan hasil untuk URL yang tepat; example.com/example-page - mengembalikan hasil untuk semua URL domain yang dimulai dengan string yang ditentukan
- targetTipe: string | null
_search _mode mode pencocokan target field opsional untuk mengaktifkan parameter ini, stop_crawl_on_match juga harus diaktifkan menentukan bagaimana perayapan akan berhenti saat beberapa target ditentukan di stop_crawl_on_match nilai yang mungkin: all, any all – perayapan akan berhenti hanya jika semua target yang ditentukan ditemukan any – perayapan berhenti saat target apa pun ditemukan nilai default: any pelajari lebih lanjut tentang parameter ini di Pusat Bantuan kami
- urlTipe: string | null
URL langsung dari kueri pencarian field opsional Anda dapat menentukan URL langsung dan kami akan mengurainya menjadi field yang diperlukan. Perhatikan bahwa metode ini paling sulit ditangani oleh API kami dan juga mengharuskan Anda menentukan bahasa dan lokasi dengan benar di URL. Dalam sebagian besar kasus, kami tidak menyarankan metode ini. contoh: https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS Catatan: parameter mesin pencari berikut tidak didukung dan akan otomatis dibatalkan jika ditentukan di URL: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
- Tipe: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResponseInfo200
- 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_SerpGoogleOrganicLiveAdvancedTaskInfo
- 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
- checkTipe: string | null
_url URL langsung ke hasil mesin penelusuran. Anda dapat menggunakannya untuk memastikan bahwa kami memberikan hasil yang akurat
- datetimeTipe: string | null
tanggal dan waktu saat hasil diterima. Dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”. Contoh: 2019-11-15 12:57:46 +00:00
- itemTipe: array (string | null)[] | null
_types jenis hasil pencarian di SERP berisi jenis hasil pencarian (items) yang ditemukan di SERP. jenis item yang mungkin: answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, recipes, top_sights, scholarly_articles, popular_products, questions_and_answers, find_results_on, stocks_box, commercial_units, local_services, google_hotels, math_solver, currency_box,product_considerations, short_videos, refine_products, perspectives, discussions_and_forums, compare_sites, ai_overview
- itemsTipe: array (object | null)[] | null
item elemen
- pageTipe: integer | null
nomor halaman hasil pencarian
menunjukkan nomor halaman SERP tempat elemen berada - positionTipe: string | null
perataan elemen dalam SERP
dapat mengambil nilai berikut:left,right - rectangleTipe: object | null · Response36Afe1097B20_AiModeRectangleInfo
parameter persegi panjang
berisi koordinat kartesius dan dimensi piksel cuplikan hasil di SERP
sama dengannulljikacalculate_rectanglesdalam permintaan POST tidak disetel ketrue- heightTipe: number | null Format: double
tinggi elemen dalam piksel
- widthTipe: number | null Format: double
lebar elemen dalam piksel
- xTipe: number | null Format: double
koordinat sumbu x koordinat sumbu x sudut kiri atas cuplikan hasil, dengan sudut kiri atas layar sebagai titik asal
- yTipe: number | null Format: double
koordinat sumbu y koordinat sumbu y sudut kiri atas cuplikan hasil, dengan sudut kiri atas layar sebagai titik asal
- typeTipe: string | null
jenis elemen
- xpathTipe: string | null
XPath elemen
- itemsTipe: integer | null Format: int64
_count jumlah hasil yang dikembalikan dalam array items
- keywordTipe: string | null
kata kunci yang diterima dalam array POST 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
- pagesTipe: integer | null Format: int64
_count total halaman hasil pencarian yang diambil, jumlah total SERP yang diambil dalam hasil
- refinementTipe: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips chip penyempurnaan pencarian
- itemsTipe: array (object | null)[] | null
item elemen
- domainTipe: string | null
domain di SERP
- optionsTipe: array (object | null)[] | null
opsi penyempurnaan pencarian lebih lanjut
- domainTipe: string | null
domain di SERP
- titleTipe: string | null
judul elemen
- typeTipe: string | null
jenis elemen
- urlTipe: string | null
URL penelusuran dengan parameter penyempurnaan
- titleTipe: string | null
judul elemen
- typeTipe: string | null
jenis elemen
- urlTipe: string | null
URL penelusuran dengan parameter penyempurnaan
- typeTipe: string | null
jenis elemen
- xpathTipe: string | null
XPath elemen
- seTipe: string | null
_domain domain mesin penelusuran dalam array POST
- seTipe: integer | null Format: int64
_results _count jumlah total hasil di SERP
- spellTipe: object | null · Response36Afe1097B20_SpellInfo
koreksi otomatis mesin penelusuran. Jika mesin penelusuran memberikan hasil untuk kata kunci yang dikoreksi, kami akan menentukan kata kunci yang dikoreksi oleh mesin penelusuran dan jenis koreksi otomatisnya
- keywordTipe: string | null
kata kunci yang diperoleh sebagai hasil koreksi otomatis mesin penelusuran hasil akan diberikan untuk kata kunci yang dikoreksi
- typeTipe: string | null
jenis koreksi otomatis nilai yang mungkin: did_you_mean, showing_results_for, no_results_found_for, including_results_for catatan: Yahoo dan Yandex hanya mendukung jenis koreksi otomatis berikut: including_results_for
- 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/organic/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",
"calculate_rectangles": true
}
]'
{
"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,
"check_url": null,
"datetime": null,
"spell": {
"keyword": null,
"type": null
},
"refinement_chips": {
"type": null,
"xpath": null,
"items": [
"[Max Depth Exceeded]"
]
},
"item_types": [
null
],
"se_results_count": null,
"pages_count": null,
"items_count": null,
"items": [
{
"type": null,
"page": null,
"position": null,
"xpath": null,
"rectangle": "[Max Depth Exceeded]"
}
]
}
]
}
]
}