DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Microdata OnPage API
Mengesahkan data berstruktur pada satu url yang di-crawl. Membaca crawl yang telah selesai, jadi ia memerlukan id daripada post_dataforseo_on_page_submit dan memulangkan crawl_progress serta crawl_status yang mengandungi max_crawl_pages, pages_in_queue dan pages_crawled - semak nilai tersebut sebelum mempercayai hasil yang kecil, kerana crawl yang masih berjalan sememangnya mempunyai lebih sedikit perkara untuk dilaporkan. ⚠️ Halaman itu mesti menjadi bahagian crawl: meminta URL yang bukan bahagiannya akan memulangkan status_code 40406, Requested page was not submitted for crawling, di dalam HTTP 200. Lebarkan max_crawl_pages atau tetapkan start_url pada panggilan hantar jika halaman yang anda mahu tiada. 💰 Percuma di pihak upstream: membuat pertanyaan pada crawl yang telah selesai tidak dikenakan kos, hanya crawl itu sendiri.
Rujukan harga
- Pemeteran: Kos respons yang dilaporkan.
- Anggaran rujukan setiap permintaan: USD 0.012.
- 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)[]
- idJenis: string
- 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 - urlJenis: string
URL sumber
medan wajib
anda boleh mendapatkan URL ini dalam respons endpoint Pages
contoh:https://dataforseo.com/apis
- Jenis: object | null · Response36Afe1097B20_OnPageMicrodataResponseInfo200
- 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_OnPageMicrodataTaskInfo
- 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
tatasusunan hasil
- crawlJenis: string | null
_progress status sesi crawl
nilai yang mungkin:in_progress,finished - crawlJenis: object | null · Response36Afe1097B20_CrawlStatusInfo
_status butiran sesi crawl
- maxJenis: integer | null Format: int64
_crawl _pages bilangan maksimum halaman untuk dirayau menunjukkan had max_crawl_pages yang anda tetapkan semasa mencipta tugas
- pagesJenis: integer | null Format: int64
_crawled bilangan halaman yang dirayau
- pagesJenis: integer | null Format: int64
_in _queue bilangan halaman yang sedang berada dalam baris gilir perayauan
- itemsJenis: array (object | null)[] | null
tatasusunan items
- inspectionJenis: object | null · Response36Afe1097B20_MicrodataInspectionInfo
_info maklumat berkaitan pengesahan microdata
- fieldsJenis: array (object | null)[] | null
medan microdata
array objek yang mengandungi medan data berkaitan jenis microdata tertentu- fieldsJenis: array (object | null)[] | null
medan microdata
array objek yang mengandungi medan data berkaitan jenis microdata tertentu- fieldsJenis: array (object | null)[] | null
medan microdata
array objek yang mengandungi medan data berkaitan jenis microdata tertentu - nameJenis: string | null
nama medan
nama medan data - testJenis: object | null · Response36Afe1097B20_MessageInfo
_results hasil ujian pengesahan microdata
hasil ujian microdata subjenis yang mengandungi ralat yang dikesan dan mesej berkaitan- levelJenis: string | null
tahap ralat boleh mengambil nilai berikut: fatal, error, warning, info
- messageJenis: string | null
mesej yang berkaitan dengan ralat mesej yang memberikan butiran ralat yang dikesan
- typesJenis: array (string | null)[] | null
senarai jenis microdata
- valueJenis: string | null
nilai microdata nilai microdata yang ditentukan pada halaman web sasaran
- nameJenis: string | null
nama medan
nama medan data - testJenis: object | null · Response36Afe1097B20_MessageInfo
_results hasil ujian pengesahan microdata
hasil ujian microdata subjenis yang mengandungi ralat yang dikesan dan mesej berkaitan- levelJenis: string | null
tahap ralat boleh mengambil nilai berikut: fatal, error, warning, info
- messageJenis: string | null
mesej yang berkaitan dengan ralat mesej yang memberikan butiran ralat yang dikesan
- typesJenis: array (string | null)[] | null
senarai jenis microdata
- valueJenis: string | null
nilai microdata nilai microdata yang ditentukan pada halaman web sasaran
- typesJenis: array (string | null)[] | null
- typeJenis: string | null
jenis elemen
- itemsJenis: integer | null Format: int64
_count bilangan item dalam tatasusunan hasil
- testJenis: object | null · Response36Afe1097B20_TestSummary
_summary hasil ujian pengesahan microdata
- errorJenis: integer | null
bilangan ralat microdata serius
- fatalJenis: integer | null
bilangan ralat microdata fatal
- infoJenis: integer | null
bilangan bendera maklumat microdata
- warningJenis: integer | null
bilangan amaran microdata
- 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/microdata \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"id": "02241700-1535-0216-0000-034137259bc1",
"url": "https://dataforseo.com/apis"
}
]'
{
"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": [
{
"crawl_progress": null,
"crawl_status": {
"max_crawl_pages": null,
"pages_in_queue": null,
"pages_crawled": null
},
"test_summary": {
"fatal": null,
"error": null,
"warning": null,
"info": null
},
"items_count": null,
"items": [
{
"type": null,
"inspection_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}