DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
SERP Organik Google Lanjutan Langsung
Memulangkan hasil berkedudukan untuk kata kunci di Google, secara segerak. Memulangkan keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count dan items. advanced ialah pilihan lalai; ambil regular apabila hanya senarai berkedudukan yang penting dan html hanya untuk memeriksa apa yang digugurkan penghurai. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak tetap memulangkan HTTP 200.
Rujukan harga
- Pemeteran: Kos respons yang dilaporkan.
- Anggaran rujukan setiap permintaan: USD 0.0175.
- Pengganda pelanggan rujukan: 1.0. Jangan gunakan semula pada amaun pelanggan yang telah diselesaikan.
Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.
- Jenis: array (object | null)[]
- browserJenis: integer | null
_screen _height tinggi skrin pelayar medan pilihan anda boleh menetapkan tinggi skrin pelayar tersuai untuk mengira kedudukan piksel bagi peranti tertentu; boleh ditentukan dalam julat berikut: 240-9999; secara lalai, parameter ditetapkan kepada: 1080 untuk desktop; 640 untuk mobile pada android; 812 untuk mobile pada iOS; Nota: untuk menggunakan parameter ini, tetapkan calculate_rectangles kepada true
- browserJenis: integer | null
_screen _resolution _ratio nisbah resolusi skrin pelayar medan pilihan anda boleh menetapkan nisbah resolusi skrin pelayar tersuai untuk mengira kedudukan piksel bagi peranti tertentu; boleh ditentukan dalam julat berikut: 0.5-3; secara lalai, parameter ditetapkan kepada: 1 untuk desktop; 3 untuk mobile pada android; 3 untuk mobile pada iOS; Nota: untuk menggunakan parameter ini, tetapkan calculate_rectangles kepada true
- browserJenis: integer | null Format: int64
_screen _width lebar skrin pelayar medan pilihan anda boleh menetapkan lebar skrin pelayar tersuai untuk mengira kedudukan piksel bagi peranti tertentu; boleh ditentukan dalam julat berikut: 240-9999; secara lalai, parameter ditetapkan kepada: 1920 untuk desktop; 360 untuk mobile pada android; 375 untuk mobile pada iOS; Nota: untuk menggunakan parameter ini, tetapkan calculate_rectangles kepada true
- calculateJenis: boolean | null
_rectangles kira kedudukan piksel untuk elemen SERP dalam hasil lanjutan medan pilihan kedudukan piksel merujuk kepada jarak antara coretan hasil dan sudut kiri atas skrin; Lawati Pusat Bantuan untuk mengetahui lebih lanjut>> secara lalai, parameter ditetapkan kepada false; Nota: anda akan dicaj tambahan $0.002 kerana menggunakan parameter ini
- depthJenis: integer | null
kedalaman penghuraian medan pilihan bilangan hasil dalam SERP nilai lalai: 10 nilai maksimum: 200 Akaun anda akan dicaj bagi setiap SERP yang mengandungi sehingga 10 hasil; Menetapkan kedalaman melebihi 10 boleh menyebabkan caj tambahan jika enjin carian memulangkan lebih daripada 10 hasil; Kos boleh dikira di halaman Harga.
- deviceJenis: string | null
jenis peranti medan pilihan pulangkan hasil untuk jenis peranti tertentu boleh mengambil nilai: desktop, mobile nilai lalai: desktop
- findJenis: array string[] | null
_targets _in jenis elemen SERP untuk disemak bagi sasaran medan pilihan untuk mendayakan parameter ini, stop_crawl_on_match juga mesti didayakan tentukan jenis elemen SERP untuk disemak bagi padanan sasaran jika tidak ditentukan, semua elemen peringkat pertama yang mempunyai medan url dan domain akan disemak untuk sasaran nilai sah: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Nota: tidak boleh mengandungi jenis elemen yang sama seperti ignore_targets_in contoh: "find_targets_in": ["organic", "featured_snippet"] ketahui lebih lanjut tentang parameter ini di Pusat Bantuan kami
- groupJenis: boolean | null
_organic _results paparkan hasil berkaitan medan pilihan jika ditetapkan kepada true, elemen related_result dalam respons akan disediakan sebagai coretan hasil organik asal; jika ditetapkan kepada false, elemen related_result akan disediakan sebagai hasil organik berasingan; nilai lalai: true
- ignoreJenis: array string[] | null
_targets _in jenis elemen SERP untuk dikecualikan daripada carian sasaran medan pilihan untuk mendayakan parameter ini, stop_crawl_on_match juga mesti didayakan tentukan jenis elemen SERP untuk dikecualikan semasa mencari padanan sasaran nilai sah: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Nota: tidak boleh mengandungi jenis elemen yang sama seperti find_targets_in contoh: "ignore_targets_in": ["paid", "images"] ketahui lebih lanjut tentang parameter ini di Pusat Bantuan kami
- keywordJenis: string
kata kunci medan wajib anda boleh menentukan sehingga 700 aksara dalam medan keyword semua %## akan dinyahkod (aksara ‘+’ juga akan dinyahkod kepada aksara ruang) jika anda perlu menggunakan aksara “%” untuk keyword, nyatakan sebagai “%25”; jika anda perlu menggunakan aksara “+” untuk keyword, nyatakan sebagai “%2B”; jika medan ini mengandungi parameter seperti ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘cache:’, ‘define:’, ‘definition:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘site:’, caj setiap tugas akan didarab dengan 5 ketahui lebih lanjut tentang peraturan dan had medan keyword dan keywords dalam API DataForSEO dalam artikel Pusat Bantuan ini
- languageJenis: string | null
_code kod bahasa enjin carian medan pilihan jika anda menentukan language_name jika anda menggunakan medan ini, anda tidak perlu menentukan language_name anda boleh mendapatkan senarai bahasa tersedia bagi enjin carian dengan language_code dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/google/languages contoh: en
- languageJenis: string | null
_name nama penuh bahasa enjin carian medan pilihan jika anda menentukan language_code jika anda menggunakan medan ini, anda tidak perlu menentukan language_code anda boleh mendapatkan senarai bahasa tersedia bagi enjin carian dengan language_name dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/google/languages contoh: English
- loadJenis: boolean | null
_async _ai _overview muatkan gambaran keseluruhan AI secara tak segerak medan pilihan tetapkan kepada true untuk menerima item ai_overview dalam SERP walaupun ia dimuatkan secara tak segerak; jika ditetapkan kepada false, anda hanya akan menerima item ai_overview daripada cache; nilai lalai: false Nota: anda akan dicaj tambahan $0.002 kerana menggunakan parameter ini; jika elemen tiada atau mengandungi "asynchronous_ai_overview": false, seluruh caj tambahan akan dikembalikan ke baki akaun anda
- locationJenis: integer | null
_code kod lokasi enjin carian medan wajib jika anda tidak menentukan location_name atau location_coordinate jika anda menggunakan medan ini, anda tidak perlu menentukan location_name atau location_coordinate anda boleh mendapatkan senarai lokasi tersedia bagi enjin carian dengan location_code dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/google/locations contoh: 2840
- locationJenis: string | null
_coordinate koordinat GPS sesuatu lokasi medan pilihan jika anda menentukan location_name atau location_code jika anda menggunakan medan ini, anda tidak perlu menentukan location_name atau location_code parameter location_coordinate mesti ditentukan dalam format "latitude,longitude,radius" bilangan maksimum digit perpuluhan untuk "latitude" dan "longitude": 7 nilai minimum untuk "radius": 199 (mm) nilai maksimum untuk "radius": 199999 (mm) contoh: 53.476225,-2.243572,200
- locationJenis: string | null
_name nama penuh lokasi enjin carian medan wajib jika anda tidak menentukan location_code atau location_coordinate jika anda menggunakan medan ini, anda tidak perlu menentukan location_code atau location_coordinate anda boleh mendapatkan senarai lokasi tersedia bagi enjin carian dengan location_name dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/google/locations contoh: London,England,United Kingdom
- matchJenis: string | null
_type jenis padanan sasaran medan wajib jika stop_crawl_on_match ditentukan jenis padanan untuk match_value nilai sah: domain – domain atau subdomain tertentu with_subdomains – domain utama dan subdomainnya wildcard – corak wildcard
- matchJenis: string | null
_value nilai domain, subdomain atau wildcard sasaran medan wajib jika stop_crawl_on_match ditentukan tentukan domain, subdomain atau nilai wildcard sasaran; Nota: domain atau subdomain mesti ditentukan tanpa protokol permintaan; contoh: "match_value": "dataforseo.com","match_value": "/blog/post-*"
- maxJenis: integer | null
_crawl _pages had crawl halaman medan pilihan bilangan halaman hasil carian untuk di-crawl nilai maksimum: 100 Nota: anda akan dicaj bagi setiap halaman yang di-crawl (10 hasil organik setiap halaman); ketahui lebih lanjut tentang harga di halaman Harga kami; Nota #2: parameter max_crawl_pages dan depth saling melengkapi; ketahui lebih lanjut di pusat bantuan kami
- osJenis: string | null
sistem pengendalian peranti medan pilihan jika anda menentukan desktop dalam medan device, pilih daripada nilai berikut: windows, macos nilai lalai: windows jika anda menentukan mobile dalam medan device, pilih daripada nilai berikut: android, ios nilai lalai: android
- peopleJenis: integer | null
_also _ask _click _depth klik pada elemen berkenaan medan pilihan tentukan kedalaman klik pada elemen people_also_ask untuk menerima item people_also_ask_element tambahan; Nota akaun anda akan dicaj tambahan $0.00015 untuk setiap klik; jika elemen tiada atau kami melakukan lebih sedikit klik daripada yang anda tentukan, seluruh caj tambahan akan dikembalikan ke baki akaun anda nilai sah: dari 1 hingga 4
- removeJenis: array string[] | null
_from _url buang parameter tertentu daripada URL medan pilihan dengan medan ini, anda boleh menentukan sehingga 10 parameter untuk dibuang daripada URL dalam hasil contoh: "remove_from_url": ["srsltid"] Nota: jika medan target ditentukan, parameter URL yang ditentukan akan dibuang sebelum carian
- seJenis: string | null
_domain domain enjin carian medan pilihan kami memilih domain enjin carian yang relevan secara automatik mengikut lokasi dan bahasa yang anda tentukan namun, anda boleh menetapkan domain enjin carian tersuai dalam medan ini contoh: google.co.uk, google.com.au, google.de, dsb.
- searchJenis: string | null
_param parameter tambahan pertanyaan carian medan pilihan dapatkan senarai parameter tersedia dan butiran tambahan di sini Nota: parameter enjin carian berikut tidak disokong dan akan dibatalkan secara automatik jika ditentukan: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
- stopJenis: array (object | null)[] | null
_crawl _on _match tatasusunan sasaran untuk menghentikan crawl medan pilihan jika ditentukan, respons akan mengandungi hasil SERP sehingga dan termasuk match_value yang ditentukan; anda boleh menentukan sehingga 10 nilai sasaran dalam tatasusunan ini contoh: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] ketahui lebih lanjut tentang parameter ini di Pusat Bantuan kami - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Akaun anda akan dicaj bagi setiap SERP yang di-crawl melalui sasaran yang ditentukan
- matchJenis: string | null
_type jenis padanan sasaran medan wajib jika stop_crawl_on_match ditentukan; jenis padanan untuk match_value nilai yang mungkin: domain, with_subdomains, wildcard
- matchJenis: string | null
_value domain sasaran atau nilai wildcard medan wajib jika stop_crawl_on_match ditentukan; tentukan domain sasaran atau nilai wildcard; Nota: nama domain mesti ditentukan tanpa protokol permintaan; contoh: dataforseo.com
- tagJenis: string | null
pengecam tugas yang ditentukan pengguna medan pilihan had aksara ialah 255 anda boleh menggunakan parameter ini untuk mengenal pasti tugas dan memadankannya dengan hasil anda akan menemui nilai tag yang ditentukan dalam objek data respons
- targetJenis: string | null
domain, subdomain atau halaman web sasaran untuk mendapatkan hasil medan pilihan domain atau subdomain mesti ditentukan tanpa https:// dan www. ambil perhatian bahawa hasil tugas khusus sasaran hanya akan merangkumi elemen SERP yang mengandungi rentetan url; anda juga boleh menggunakan aksara wildcard (‘’) untuk menentukan corak carian dalam SERP dan menyempitkan hasil; contoh: example.com - pulangkan hasil untuk halaman utama laman web dengan URL seperti https://example.com, atau https://www.example.com/, atau https://example.com/; example.com - pulangkan hasil untuk domain, termasuk semua halaman domain; example.com - pulangkan hasil untuk seluruh domain, termasuk semua halaman dan subdomain; example.com - pulangkan hasil untuk halaman utama tanpa mengira subdomain, seperti https://en.example.com; example.com/example-page - pulangkan hasil untuk URL yang tepat; example.com/example-page - pulangkan hasil untuk semua URL domain yang bermula dengan rentetan yang ditentukan
- targetJenis: string | null
_search _mode mod pemadanan sasaran medan pilihan untuk mendayakan parameter ini, stop_crawl_on_match juga mesti didayakan menentukan cara crawl akan berhenti apabila berbilang sasaran ditentukan dalam stop_crawl_on_match nilai sah: all, any all – crawl akan berhenti hanya apabila semua sasaran yang ditentukan ditemui any – crawl berhenti apabila mana-mana sasaran ditemui nilai lalai: any ketahui lebih lanjut tentang parameter ini di Pusat Bantuan kami
- urlJenis: string | null
URL langsung pertanyaan carian medan pilihan anda boleh menentukan URL langsung dan kami akan menghuraikannya kepada medan yang diperlukan. Ambil perhatian bahawa kaedah ini paling sukar dikendalikan oleh API kami dan juga memerlukan anda menentukan bahasa dan lokasi dengan tepat dalam URL. Dalam kebanyakan kes, kami tidak mengesyorkan kaedah ini. contoh: https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS Nota: parameter enjin carian berikut tidak disokong dan akan dibatalkan secara automatik jika ditentukan dalam URL: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
- Jenis: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResponseInfo200
- Jenis: number | null Format: doublecost
jumlah kos tugas, USD
- Jenis: integer | nullstatus
_code kod status umum; anda boleh menemui senarai penuh kod respons di sini
- Jenis: string | nullstatus
_message mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini
- Jenis: array (object | null)[] | nulltasks
array tugas
- Jenis: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedTaskInfo
- costJenis: number | null Format: double
jumlah kos tugas, USD
- dataJenis: object | null
mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST
- propertyJenis: object | null
Name
- idJenis: string | null
pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID
- pathJenis: array (string | null)[] | null
Laluan URL
- resultJenis: array (object | null)[] | null
array hasil
- checkJenis: string | null
_url URL langsung ke hasil enjin carian. Anda boleh menggunakannya untuk memastikan bahawa kami memberikan hasil yang tepat
- datetimeJenis: string | null
tarikh dan masa apabila hasil diterima. Dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”. Contoh: 2019-11-15 12:57:46 +00:00
- itemJenis: array (string | null)[] | null
_types jenis hasil carian dalam SERP mengandungi jenis hasil carian (items) yang ditemui dalam 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
- itemsJenis: array (object | null)[] | null
item elemen
- pageJenis: integer | null
nombor halaman hasil carian
menunjukkan nombor halaman SERP tempat elemen berada - positionJenis: string | null
penjajaran elemen dalam SERP
boleh mengambil nilai berikut:left,right - rectangleJenis: object | null · Response36Afe1097B20_AiModeRectangleInfo
parameter segi empat tepat
mengandungi koordinat kartesan dan dimensi piksel petikan hasil dalam SERP
sama dengannulljikacalculate_rectanglesdalam permintaan POST tidak ditetapkan kepadatrue- heightJenis: number | null Format: double
tinggi elemen dalam piksel
- widthJenis: number | null Format: double
lebar elemen dalam piksel
- xJenis: number | null Format: double
koordinat paksi x koordinat paksi x sudut kiri atas petikan hasil, dengan sudut kiri atas skrin sebagai asalan
- yJenis: number | null Format: double
koordinat paksi y koordinat paksi y sudut kiri atas petikan hasil, dengan sudut kiri atas skrin sebagai asalan
- typeJenis: string | null
jenis elemen
- xpathJenis: string | null
XPath elemen
- itemsJenis: integer | null Format: int64
_count bilangan hasil yang dikembalikan dalam array items
- keywordJenis: string | null
kata kunci yang diterima dalam array POST dipulangkan dengan %## dinyahkod (aksara tambah '+' akan dinyahkod menjadi aksara ruang)
- languageJenis: string | null
_code kod bahasa dalam array POST
- locationJenis: integer | null
_code kod lokasi dalam array POST
- pagesJenis: integer | null Format: int64
_count jumlah halaman hasil carian yang diambil, jumlah keseluruhan SERP yang diambil dalam hasil
- refinementJenis: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips cip penghalusan carian
- itemsJenis: array (object | null)[] | null
item elemen
- domainJenis: string | null
domain dalam SERP
- optionsJenis: array (object | null)[] | null
pilihan penghalusan carian lanjut
- domainJenis: string | null
domain dalam SERP
- titleJenis: string | null
tajuk elemen
- typeJenis: string | null
jenis elemen
- urlJenis: string | null
URL carian dengan parameter penghalusan
- titleJenis: string | null
tajuk elemen
- typeJenis: string | null
jenis elemen
- urlJenis: string | null
URL carian dengan parameter penghalusan
- typeJenis: string | null
jenis elemen
- xpathJenis: string | null
XPath elemen
- seJenis: string | null
_domain domain enjin carian dalam array POST
- seJenis: integer | null Format: int64
_results _count jumlah keseluruhan hasil dalam SERP
- spellJenis: object | null · Response36Afe1097B20_SpellInfo
pembetulan automatik enjin carian. Jika enjin carian memberikan hasil untuk kata kunci yang dibetulkan, kami akan menyatakan kata kunci yang dibetulkan oleh enjin carian dan jenis pembetulan automatik
- keywordJenis: string | null
kata kunci yang diperoleh hasil daripada pembetulan automatik enjin carian keputusan akan diberikan untuk kata kunci yang dibetulkan
- typeJenis: string | null
jenis pembetulan automatik nilai yang mungkin: did_you_mean, showing_results_for, no_results_found_for, including_results_for nota: Yahoo dan Yandex hanya menyokong jenis pembetulan automatik berikut: including_results_for
- typeJenis: string | null
jenis elemen
- resultJenis: integer | null Format: int64
_count bilangan elemen dalam array hasil
- statusJenis: integer | null
_code kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini
- statusJenis: string | null
_message mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini
- timeJenis: string | null
masa pelaksanaan, saat
- Jenis: integer | null Format: int64tasks
_count bilangan tugas dalam array tasks
- Jenis: integer | null Format: int64tasks
_error bilangan tugas dalam array tasks yang dipulangkan dengan ralat
- Jenis: string | nulltime
jumlah masa pelaksanaan, saat
- Jenis: string | nullversion
versi semasa API
application/json - 400
Permintaan tidak dapat diproses. Semak parameter permintaan.
- 401
Kunci API Felo yang sah diperlukan.
- 402
Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.
- 403
Akaun tidak dibenarkan melakukan operasi ini.
- 429
Had permintaan atau had perbelanjaan telah dicapai.
- 502
Perkhidmatan tidak dapat menyelesaikan permintaan.
- 503
API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.
- 504
Perkhidmatan tamat masa semasa memproses permintaan.
- default
Respons ralat; respons passthrough huluan mungkin 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]"
}
]
}
]
}
]
}