DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Microdata OnPage API
Memvalidasi data terstruktur pada satu url yang di-crawl. Membaca crawl yang sudah selesai, jadi memerlukan id dari post_dataforseo_on_page_submit dan mengembalikan crawl_progress plus crawl_status berisi max_crawl_pages, pages_in_queue, dan pages_crawled - periksa nilai tersebut sebelum memercayai hasil yang sedikit, karena crawl yang masih berjalan memang punya lebih sedikit hal untuk dilaporkan. ⚠️ Halaman harus menjadi bagian dari crawl: meminta URL yang bukan bagian akan mengembalikan status_code 40406, Requested page was not submitted for crawling, di dalam HTTP 200. Perlebar max_crawl_pages atau setel start_url pada panggilan submit jika halaman yang anda inginkan tidak ada. 💰 Gratis di sisi upstream: menanyakan crawl yang sudah selesai tidak dikenakan biaya, hanya crawl itu sendiri.
Referensi harga
- Metering: Biaya respons yang dilaporkan.
- Estimasi referensi per permintaan: USD 0.012.
- 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)[]
- idTipe: string
- 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 - urlTipe: string
URL sumber daya
field wajib
Anda dapat memperoleh URL ini di respons endpoint Pages
contoh:https://dataforseo.com/apis
- Tipe: object | null · Response36Afe1097B20_OnPageMicrodataResponseInfo200
- 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_OnPageMicrodataTaskInfo
- 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
- crawlTipe: string | null
_progress status sesi crawl
nilai yang mungkin:in_progress,finished - crawlTipe: object | null · Response36Afe1097B20_CrawlStatusInfo
_status detail sesi crawl
- maxTipe: integer | null Format: int64
_crawl _pages jumlah halaman maksimum untuk dirayapi menunjukkan batas max_crawl_pages yang Anda tentukan saat membuat tugas
- pagesTipe: integer | null Format: int64
_crawled jumlah halaman yang dirayapi
- pagesTipe: integer | null Format: int64
_in _queue jumlah halaman yang saat ini berada dalam antrean perayapan
- itemsTipe: array (object | null)[] | null
array items
- inspectionTipe: object | null · Response36Afe1097B20_MicrodataInspectionInfo
_info informasi terkait validasi microdata
- fieldsTipe: array (object | null)[] | null
field microdata
array objek yang berisi field data terkait jenis microdata tertentu- fieldsTipe: array (object | null)[] | null
field microdata
array objek yang berisi field data terkait jenis microdata tertentu- fieldsTipe: array (object | null)[] | null
field microdata
array objek yang berisi field data terkait jenis microdata tertentu - nameTipe: string | null
nama field
nama field data - testTipe: object | null · Response36Afe1097B20_MessageInfo
_results hasil uji validasi microdata
hasil uji microdata subtipe yang berisi kesalahan yang terdeteksi dan pesan terkait- levelTipe: string | null
tingkat kesalahan dapat bernilai sebagai berikut: fatal, error, warning, info
- messageTipe: string | null
pesan yang terkait dengan kesalahan pesan yang memberikan detail kesalahan yang terdeteksi
- typesTipe: array (string | null)[] | null
daftar jenis microdata
- valueTipe: string | null
nilai microdata nilai microdata yang ditentukan pada halaman web target
- nameTipe: string | null
nama field
nama field data - testTipe: object | null · Response36Afe1097B20_MessageInfo
_results hasil uji validasi microdata
hasil uji microdata subtipe yang berisi kesalahan yang terdeteksi dan pesan terkait- levelTipe: string | null
tingkat kesalahan dapat bernilai sebagai berikut: fatal, error, warning, info
- messageTipe: string | null
pesan yang terkait dengan kesalahan pesan yang memberikan detail kesalahan yang terdeteksi
- typesTipe: array (string | null)[] | null
daftar jenis microdata
- valueTipe: string | null
nilai microdata nilai microdata yang ditentukan pada halaman web target
- typesTipe: array (string | null)[] | null
- typeTipe: string | null
jenis elemen
- itemsTipe: integer | null Format: int64
_count jumlah item dalam array hasil
- testTipe: object | null · Response36Afe1097B20_TestSummary
_summary hasil pengujian validasi microdata
- errorTipe: integer | null
jumlah kesalahan microdata serius
- fatalTipe: integer | null
jumlah kesalahan microdata fatal
- infoTipe: integer | null
jumlah flag informasi microdata
- warningTipe: integer | null
jumlah peringatan microdata
- 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/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]"
}
]
}
]
}
]
}