DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Mencipta Tugas OnPage
Memulakan crawl target dan memulangkan id tugas dalam tasks[0].id - id itu ialah pemegang yang diperlukan oleh setiap alat lain dalam keluarga ini, jadi simpanlah. max_crawl_pages mengehadkan crawl, start_url, max_crawl_depth, priority_urls dan crawl_delay membentuknya, dan store_raw_html menentukan sama ada post_dataforseo_on_page_raw_html akan mempunyai apa-apa untuk disajikan kemudian. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak tetap memulangkan HTTP 200. ⚠️ Ini bukan pasangan hantar/ambil biasa: crawl ialah sesi yang kemudian ditanyakan oleh sedozen alat lain mengikut id. Tinjau get_dataforseo_on_page_summary sehingga crawl_progress terbaca finished; crawl satu halaman example.com mengambil masa jauh di bawah satu minit.
Rujukan harga
- Pemeteran: Kos respons yang dilaporkan.
- Anggaran rujukan setiap permintaan: USD 0.003.
- 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)[]
- acceptJenis: string | null
_language header bahasa untuk mengakses laman web
medan pilihan
semua format locale disokong (xx, xx-XX, xxx-XX, dsb.)
Nota: jika anda tidak menentukan parameter ini, sesetengah laman web mungkin menolak akses; dalam kes ini, halaman akan dipulangkan dengan"type":"brokendalam array respons - allowJenis: boolean | null
_subdomains sertakan halaman pada subdomain
medan pilihan
tetapkan kepadatruejika anda ingin merangkak semua subdomain laman web sasaran
nilai lalai:false - allowedJenis: array string[] | null
_subdomains subdomain untuk dirangkak
medan pilihan
tentukan subdomain yang anda ingin rangkak
contoh:["blog.site.com", "my.site.com", "shop.site.com"]
Nota: untuk menggunakan parameter ini, parameterallow_subdomainsharus ditetapkan kepadafalse;
jika tidak, kandungan medanallowed_subdomainsakan diabaikan dan hasil akan dipulangkan untuk semua subdomain - browserJenis: string | null
_preset preset untuk parameter skrin pelayar
medan pilihan
jika anda menggunakan medan ini, anda tidak perlu menentukanbrowser_screen_width,browser_screen_height,browser_screen_scale_factornilai yang tersedia:desktop,mobile,tabletpresetdesktopakan menggunakan nilai berikut:browser_screen_width: 1920browser_screen_height: 1080browser_screen_scale_factor: 1presetmobileakan menggunakan nilai berikut:browser_screen_width: 390browser_screen_height: 844browser_screen_scale_factor: 3presettabletakan menggunakan nilai berikut:browser_screen_width: 1024browser_screen_height: 1366browser_screen_scale_factor: 2
Nota: untuk menggunakan parameter ini, tetapkanenable_javascriptatauenable_browser_renderingkepadatrue - browserJenis: integer | null
_screen _height tinggi skrin pelayar
medan pilihan
anda boleh menetapkan tinggi skrin pelayar tersuai untuk melakukan audit bagi peranti tertentu;
jika anda menggunakan medan ini, anda tidak perlu menentukanbrowser_presetkerana ia akan diabaikan;
Nota: untuk menggunakan parameter ini, tetapkanenable_javascriptatauenable_browser_renderingkepadatruenilai minimum, dalam piksel:240
nilai maksimum, dalam piksel:9999 - browserJenis: number | null
_screen _scale _factor faktor skala skrin pelayar
medan pilihan
anda boleh menetapkan nisbah resolusi skrin pelayar tersuai untuk melakukan audit bagi peranti tertentu;
jika anda menggunakan medan ini, anda tidak perlu menentukanbrowser_presetkerana ia akan diabaikan;
Nota: untuk menggunakan parameter ini, tetapkanenable_javascriptatauenable_browser_renderingkepadatruenilai minimum:0.5
nilai maksimum:3 - browserJenis: integer | null Format: int64
_screen _width lebar skrin pelayar
medan pilihan
anda boleh menetapkan lebar skrin pelayar tersuai untuk melakukan audit bagi peranti tertentu;
jika anda menggunakan medan ini, anda tidak perlu menentukanbrowser_presetkerana ia akan diabaikan;
Nota: untuk menggunakan parameter ini, tetapkanenable_javascriptatauenable_browser_renderingkepadatruenilai minimum, dalam piksel:240
nilai maksimum, dalam piksel:9999 - calculateJenis: boolean | null
_keyword _density kira kepadatan kata kunci untuk domain sasaran
medan pilihan
tetapkan kepadatruejika anda ingin mengira kepadatan kata kunci untuk halaman laman web
nilai lalai:false
Nota: jika anda menggunakan parameter ini, caj tambahan akan dikenakan; ketahui lebih lanjut tentang kos tugas dengan parameter ini dalam artikel bantuan kami
sebaik sahaja perangkakan selesai, anda boleh mendapatkan nilai kepadatan kata kunci dengan endpoint Keyword Density - checkJenis: boolean | null
_spell - checkJenis: array string[] | null
_spell _exceptions perkataan yang dikecualikan daripada semakan ejaan
medan pilihan
tentukan perkataan yang anda ingin kecualikan daripada semakan ejaan
panjang perkataan maksimum: 100 aksara
bilangan perkataan maksimum: 1000
contoh:"SERP", "minifiers", "JavaScript" - checkJenis: string | null
_spell _language bahasa semakan ejaan
medan pilihan
bahasa yang disokong: 'hy', 'eu', 'bg', 'ca', 'hr', 'cs', 'da', 'nl', 'en', 'eo', 'et', 'fo', 'fa', 'fr', 'fy', 'gl', 'ka', 'de', 'el', 'he', 'hu', 'is', 'ia', 'ga', 'it', 'rw', 'la', 'lv', 'lt', 'mk', 'mn', 'ne', 'nb', 'nn', 'pl', 'pt', 'ro', 'gd', 'sr', 'sk', 'sl', 'es', 'sv', 'tr', 'tk', 'uk', 'vi'
Nota: jika tiada bahasa ditentukan, ia akan ditetapkan secara automatik berdasarkan kandungan halaman - checksJenis: object | null
_threshold nilai ambang tersuai untuk semakan
medan pilihan
anda boleh menentukan nilai ambang tersuai untuk parameter yang disertakan dalam objekchecksrespons OnPage API;
Nota: hanya nilai ambang integer boleh diubah suai;
sebagai contoh, parameterhigh_loading_timedanlarge_page_sizeditetapkan secara lalai kepada 3 saat dan 1 megabait;
jika anda ingin menukar ambang ini kepada 1 saat dan 1000 kbyte, gunakan coretan berikut:"checks_threshold": {<br>"high_loading_time": 1,<br>"large_page_size": 1000<br>}
parameter yang boleh disesuaikan berserta nilai lalai:"title_too_short", default value: 30, type: "int"<br>"title_too_long", default value: 65, type: "int"<br>"small_page_size", default value: 1024, type: "int"<br>"large_page_size", default value: 1048576 (1024 * 1024), type: "int"<br>"low_character_count", default value: 1024, type: "int"<br>"high_character_count", default value: 256000 (250 * 1024), type: "int"<br>"low_content_rate", default value: 0.1, type: "float"<br>"high_content_rate", default value: 0.9, type: "float"<br>"high_loading_time", default value: 3000, type: "int"<br>"high_waiting_time", default value: 1500, type: "int"<br>"low_readability_rate", default value: 15.0, type: "float"<br>"irrelevant_description", default value: 0.2, type: "float"<br>"irrelevant_title", default value: 0.3, type: "float"<br>"irrelevant_meta_keywords", default value: 0.6, type: "float"- propertyJenis: integer | null Format: int64
Name Signed 64-bit integers (long type).
- crawlJenis: integer | null
_delay kelewatan antara hit, ms
medan pilihan
kelewatan tersuai antara hit crawler ke pelayan
nilai lalai:2000 - crawlJenis: boolean | null
_sitemap _only crawl hanya halaman yang ditunjukkan dalam sitemap
medan pilihan
tetapkan kepadatruejika anda mahu crawl hanya halaman yang ditunjukkan dalam sitemap
jika anda menetapkan parameter ini kepadatruedan tidak menentukancustom_sitemap, kami akan crawl sitemap lalai
nilai lalai:false
Nota: jika anda mahu menggunakan parameter ini,respect_sitemaphendaklahtrue - customJenis: string | null
_js javascript tersuai
medan pilihan
Ambil perhatian bahawa masa pelaksanaan untuk skrip yang anda masukkan di sini hendaklah maksimum 700 ms, sebagai contoh anda boleh menggunakan coretan JS berikut untuk menyemak sama ada laman web mengandungi Google Tag Manager sebagai atributscr:let meta = { haveGoogleAnalytics: false, haveTagManager: false };rnfor (var i = 0; i < document.scripts.length; i++) {rn let src = document.scripts[i].getAttribute("src");rn if (src != undefined) {rn if (src.indexOf("analytics.js") >= 0)rn meta.haveGoogleAnalytics = true;rntif (src.indexOf("gtm.js") >= 0)rn meta.haveTagManager = true;rn }rn}rnmeta;nilai yang dipulangkan bergantung pada apa yang anda tentukan dalam medan ini. Sebagai contoh, jika anda menentukan skrip berikut:meta = {}; meta.url = document.URL; meta.test = 'test'; meta;
sebagai respons anda akan menerima data berikut:"custom_js_response": {<br>"url": "https://dataforseo.com/",<br>"test": "test"<br>}
Nota: panjang skrip yang anda masukkan tidak boleh melebihi 2000 aksara - customJenis: string | null
_robots _txt tetapan robots.txt tersuai
medan pilihan
contoh:Disallow: /directory1/ - customJenis: string | null
_sitemap URL sitemap tersuai
medan pilihan
URL halaman tempat sitemap alternatif berada
Nota: jika anda mahu menggunakan parameter ini,respect_sitemaphendaklahtrue - customJenis: string | null
_user _agent user agent tersuai
medan pilihan
user agent tersuai untuk merangkak laman web
contoh:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36
nilai lalai:Mozilla/5.0 (compatible; RSiteAuditor) - disableJenis: boolean | null
_cookie _popup nyahdayakan popup cookie
medan pilihan
tetapkan kepadatruejika anda mahu menyahdayakan popup yang meminta persetujuan cookie daripada pengguna;
nilai lalai:false - disableJenis: array string[] | null
_page _checks halang semakan halaman tertentu daripada berjalan
medan pilihan
tentukancheckstertentu untuk menghalangnya daripada berjalan dan mempengaruhionpage_scorecontoh:"disable_page_checks": ["is_5xx_code", "is_4xx_code"] - disableJenis: array string[] | null
_sitewide _checks halang semakan seluruh laman tertentu daripada berjalan
medan pilihan
tentukanchecksberikut untuk menghalangnya daripada berjalan pada laman webtarget:"test_page_not_found""test_canonicalization""test_https_redirect""test_directory_browsing"contoh:"disable_sitewide_checks": ["test_directory_browsing", "test_page_not_found"]ketahui lebih lanjut di pusat bantuan kami - disallowedJenis: array string[] | null
_subdomains subdomain yang tidak di-crawl
medan pilihan
tentukan subdomain yang anda tidak mahu crawl
contoh:["status.site.com", "docs.site.com"]
Nota: untuk menggunakan parameter ini, parameterallow_subdomainshendaklah ditetapkan kepadatrue - enableJenis: boolean | null
_browser _rendering tiru paparan pelayar untuk mengukur Core Web Vitals
medan pilihan
dengan menggunakan parameter ini anda boleh meniru pelayar semasa memuatkan halaman web;enable_browser_renderingmemuatkan gaya, imej, fon, animasi, video dan sumber lain pada halaman;
nilai lalai:false
tetapkan kepadatrueuntuk memperoleh metrik Core Web Vitals (FID, CLS, LCP) dalam respons;
jika anda menggunakan medan ini, parameterenable_javascriptdanload_resourcesmesti ditetapkan kepadatrue
Nota: jika anda menggunakan parameter ini, caj tambahan akan dikenakan; ketahui lebih lanjut tentang kos tugas dengan parameter ini dalam artikel bantuan kami; kos boleh dikira di Halaman Harga - enableJenis: boolean | null
_content _parsing - enableJenis: boolean | null
_javascript muatkan javascript pada halaman
medan pilihan
tetapkan kepadatruejika anda mahu memuatkan skrip yang tersedia pada halaman
nilai lalai:false
Nota: jika anda menggunakan parameter ini, caj tambahan akan dikenakan; ketahui lebih lanjut tentang kos tugas dengan parameter ini dalam artikel bantuan kami; kos boleh dikira di Halaman Harga - enableJenis: boolean | null
_www _redirect _check semak sama ada domain melaksanakan pengalihan www
medan pilihan
tetapkan kepadatruejika anda mahu menyemak sama ada domain yang diminta melaksanakan pengalihan www ke non-www atau non-www ke www;
nilai lalai:false - enableJenis: boolean | null
_xhr dayakan XMLHttpRequest pada halaman
medan pilihan
tetapkan kepadatruejika anda mahu crawler kami meminta data daripada pelayan web menggunakan objek XMLHttpRequest
nilai lalai:false;jika anda menggunakan medan ini,enable_javascriptmesti ditetapkan kepadatrue; - forceJenis: boolean | null
_sitewide _checks dayakan semakan seluruh laman semasa crawl satu halaman
medan pilihan
tetapkan kepadatrueuntuk mendapatkan data tentang semakan seluruh laman semasa crawl satu halaman;
nilai lalai:false - loadJenis: boolean | null
_resources muatkan sumber
medan pilihan
tetapkan kepadatruejika anda mahu memuatkan imej, helaian gaya, skrip dan sumber rosak
nilai lalai:false
Nota: jika anda menggunakan parameter ini, caj tambahan akan dikenakan; ketahui lebih lanjut tentang kos tugas dengan parameter ini dalam artikel bantuan kami; kos boleh dikira di Halaman Harga - maxJenis: integer | null
_crawl _depth kedalaman crawl
medan pilihan
kedalaman pautan halaman untuk di-crawl;
sebagai contoh, halaman permulaan crawl ialah tahap 0, halaman yang mempunyai pautan daripada halaman itu ialah tahap 1, dan seterusnya. - maxJenis: integer
_crawl _pages had halaman yang di-crawl
medan wajib
bilangan halaman untuk di-crawl pada domain yang ditentukan
Nota:
jika anda menetapkanmax_crawl_pageskepada 1 dan tidak menentukanstart_urlatau menetapkan laman utama di dalamnya, semakan seluruh laman berikut akan dinyahdayakan:test_canonicalization,enable_www_redirect_check,test_hidden_server_signature,test_page_not_found,test_directory_browsing,test_https_redirect
untuk tetap mendayakannya, tetapkanforce_sitewide_checkskepadatruejika anda menetapkanmax_crawl_pageskepada 1 dan menentukanstart_urlselain laman utama, semua semakan seluruh laman akan dinyahdayakan;
untuk tetap mendayakannya, tetapkanforce_sitewide_checkskepadatrue - pingbackJenis: string | null
_url URL pemberitahuan tugas yang selesai
medan pilihan
apabila tugas selesai, kami akan memberitahu anda melalui permintaan GET yang dihantar ke URL yang anda tentukan
anda boleh menggunakan string ‘$id’ sebagai pemboleh ubah$iddan ‘$tag’ sebagai pemboleh ubah$tagberkod URL. Kami akan menetapkan nilai yang diperlukan sebelum menghantar permintaan.
contoh:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Nota: aksara khas dalampingback_urlakan dikodkan URL;
iaitu, aksara#akan dikodkan menjadi%23 - priorityJenis: array string[] | null
_urls URL untuk di-crawl dengan memintas baris gilir
medan pilihan
URL yang ditentukan dalam tatasusunan ini akan di-crawl terlebih dahulu, memintas baris gilir crawl;
Nota: anda harus menentukan URL mutlak;
anda boleh menentukan sehingga 20 URL;
semua URL dalam tatasusunan mesti tergolong dalam domaintarget;
subdomain akan diabaikan melainkan parameterallow_subdomainsditetapkan kepadatruecontoh:"priority_urls": [<br>"https://dataforseo.com/apis/serp-api",<br>"https://dataforseo.com/contact"<br>] - respectJenis: boolean | null
_sitemap patuhi sitemap semasa crawl
medan pilihan
tetapkan kepadatruejika anda mahu mengikut susunan halaman yang ditunjukkan dalam sitemap utama semasa crawl;
nilai lalai:false
Nota: jika ditetapkan kepadatrue, nilaiclick_depthdalam respons API akan sama dengan0;
medanmax_crawl_depthbagi permintaan akan diabaikan, anda boleh menentukan bilangan halaman untuk di-crawl menggunakan parametermax_crawl_pages - returnJenis: boolean | null
_despite _timeout pulangkan data halaman walaupun berlaku ralat tamat masa
medan pilihan
jikatrue, data akan diberikan untuk halaman yang gagal dimuatkan dalam tempoh 120 saat dan bertindak balas dengan ralat tamat masa;
nilai lalai:false - robotsJenis: string | null
_txt _merge _mode gabungkan dengan atau timpa tetapan robots.txt
medan pilihan
nilai yang mungkin:merge,override;
tetapkan kepadaoverridejika anda mahu mengabaikan sekatan crawl laman web dan tetapan robots.txt lain
nilai lalai:merge;
Nota: jika ditetapkan kepadaoverride, tentukan parametercustom_robots_txt - startJenis: string | null
_url url pertama untuk di-crawl
medan pilihan
Nota: anda harus menentukan URL mutlak
jika anda mahu crawl satu halaman, tentukan URL-nya dalam medan ini dan sebagai tambahan tetapkan parametermax_crawl_pageskepada1
anda juga boleh menggunakan endpoint Instant Pages langsung untuk mendapatkan data khusus halaman - storeJenis: boolean | null
_raw _html - supportJenis: boolean | null
_cookies sokong cookie pada halaman yang di-crawl
medan pilihan
tetapkan kepadatrueuntuk menyokong cookie semasa crawl halaman
nilai lalai:false - switchJenis: boolean | null
_pool tukar kumpulan proxy
medan pilihan
jikatrue, kumpulan proxy tambahan akan digunakan untuk mendapatkan data yang diminta;
parameter ini boleh digunakan jika banyak tugas ditetapkan serentak, menyebabkan ralatrate-limitdan/atausite_unreachablesekali-sekala - 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 nilaitagyang ditentukan dalam objekdatarespons - targetJenis: string
domain sasaran
medan wajib
nama domain harus ditentukan tanpahttps://danwww.
jika anda menentukan URL halaman, hasil akan dipulangkan untuk domain yang terkandung dalam URL - validateJenis: boolean | null
_micromarkup
- Jenis: object | null · Response36Afe1097B20_OnPageTaskPostResponseInfo200
- 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
tatasusunan tugas
- Jenis: object | null · Response36Afe1097B20_OnPageTaskPostTaskInfo
- 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: object | null
tatasusunan hasil
dalam kes ini, nilainya akan menjadinull - 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/on_page/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "dataforseo.com",
"max_crawl_pages": 10,
"load_resources": true,
"enable_javascript": true,
"custom_js": "meta = {}; meta.url = document.URL; meta;",
"tag": "some_string_123",
"pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
}
]'
{
"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": null
}
]
}