DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Microdata của OnPage API
Kiểm tra dữ liệu có cấu trúc trên một url đã crawl. Đọc một lượt crawl đã hoàn tất, nên cần id từ post_dataforseo_on_page_submit và trả về crawl_progress cùng crawl_status gồm max_crawl_pages, pages_in_queue và pages_crawled - hãy kiểm tra các giá trị này trước khi tin vào một kết quả nhỏ, vì lượt crawl còn đang chạy đơn giản là có ít thứ để báo cáo hơn. ⚠️ Trang phải là một phần của lượt crawl: yêu cầu một URL không thuộc lượt crawl sẽ trả về status_code 40406, Requested page was not submitted for crawling, bên trong một HTTP 200. Tăng max_crawl_pages hoặc đặt start_url trong lệnh gửi nếu trang bạn muốn bị thiếu. 💰 Miễn phí ở phía upstream: truy vấn một lượt crawl đã hoàn tất không tốn phí, chỉ bản thân lượt crawl mới tốn phí.
Tham chiếu giá
- Đo lường: Chi phí phản hồi được báo cáo.
- Ước tính tham chiếu cho mỗi yêu cầu: USD 0.012.
- Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại cho số tiền khách hàng đã quyết toán.
Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.
- Kiểu: array (object | null)[]
- idKiểu: string
- tagKiểu: string | null
mã định danh tác vụ do người dùng xác định
trường tùy chọn
giới hạn ký tự là 255
bạn có thể dùng tham số này để nhận diện tác vụ và khớp với kết quả
bạn sẽ thấy giá trịtagđã chỉ định trong đối tượngdatacủa phản hồi - urlKiểu: string
URL tài nguyên
trường bắt buộc
bạn có thể lấy URL này trong phản hồi của endpoint Pages
ví dụ:https://dataforseo.com/apis
- Kiểu: object | null · Response36Afe1097B20_OnPageMicrodataResponseInfo200
- Kiểu: number | null Định dạng: doublecost
tổng chi phí tác vụ, USD
- Kiểu: integer | nullstatus
_code mã trạng thái chung; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây
- Kiểu: string | nullstatus
_message thông điệp thông tin chung; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây
- Kiểu: array (object | null)[] | nulltasks
mảng tác vụ
- Kiểu: object | null · Response36Afe1097B20_OnPageMicrodataTaskInfo
- costKiểu: number | null Định dạng: double
tổng chi phí tác vụ, USD
- dataKiểu: object | null
chứa các tham số giống như bạn đã chỉ định trong yêu cầu POST
- propertyKiểu: object | null
Name
- idKiểu: string | null
mã định danh tác vụ; mã định danh tác vụ duy nhất trong hệ thống của chúng tôi ở định dạng UUID
- pathKiểu: array (string | null)[] | null
Đường dẫn URL
- resultKiểu: array (object | null)[] | null
mảng kết quả
- crawlKiểu: string | null
_progress trạng thái của phiên crawl
giá trị khả dụng:in_progress,finished - crawlKiểu: object | null · Response36Afe1097B20_CrawlStatusInfo
_status chi tiết của phiên crawl
- maxKiểu: integer | null Định dạng: int64
_crawl _pages số trang tối đa được thu thập cho biết giới hạn max_crawl_pages bạn đã chỉ định khi tạo tác vụ
- pagesKiểu: integer | null Định dạng: int64
_crawled số trang đã thu thập
- pagesKiểu: integer | null Định dạng: int64
_in _queue số trang hiện đang trong hàng đợi thu thập
- itemsKiểu: array (object | null)[] | null
mảng items
- inspectionKiểu: object | null · Response36Afe1097B20_MicrodataInspectionInfo
_info thông tin liên quan đến kiểm tra microdata
- fieldsKiểu: array (object | null)[] | null
các trường microdata
một mảng các đối tượng chứa các trường dữ liệu liên quan đến loại microdata nhất định- fieldsKiểu: array (object | null)[] | null
các trường microdata
một mảng các đối tượng chứa các trường dữ liệu liên quan đến loại microdata nhất định- fieldsKiểu: array (object | null)[] | null
các trường microdata
một mảng các đối tượng chứa các trường dữ liệu liên quan đến loại microdata nhất định - nameKiểu: string | null
tên trường
tên của trường dữ liệu - testKiểu: object | null · Response36Afe1097B20_MessageInfo
_results kết quả kiểm tra xác thực microdata
kết quả kiểm tra microdata của kiểu con chứa các lỗi được phát hiện và thông báo liên quan- levelKiểu: string | null
mức lỗi có thể nhận các giá trị sau: fatal, error, warning, info
- messageKiểu: string | null
thông báo gắn với lỗi thông báo cung cấp chi tiết về lỗi được phát hiện
- typesKiểu: array (string | null)[] | null
danh sách các loại microdata
- valueKiểu: string | null
giá trị microdata giá trị microdata được chỉ định trên một trang web mục tiêu
- nameKiểu: string | null
tên trường
tên của trường dữ liệu - testKiểu: object | null · Response36Afe1097B20_MessageInfo
_results kết quả kiểm tra xác thực microdata
kết quả kiểm tra microdata của kiểu con chứa các lỗi được phát hiện và thông báo liên quan- levelKiểu: string | null
mức lỗi có thể nhận các giá trị sau: fatal, error, warning, info
- messageKiểu: string | null
thông báo gắn với lỗi thông báo cung cấp chi tiết về lỗi được phát hiện
- typesKiểu: array (string | null)[] | null
danh sách các loại microdata
- valueKiểu: string | null
giá trị microdata giá trị microdata được chỉ định trên một trang web mục tiêu
- typesKiểu: array (string | null)[] | null
- typeKiểu: string | null
loại phần tử
- itemsKiểu: integer | null Định dạng: int64
_count số mục trong mảng kết quả
- testKiểu: object | null · Response36Afe1097B20_TestSummary
_summary kết quả kiểm tra microdata
- errorKiểu: integer | null
số lỗi microdata nghiêm trọng
- fatalKiểu: integer | null
số lỗi microdata chí mạng
- infoKiểu: integer | null
số cờ thông tin microdata
- warningKiểu: integer | null
số cảnh báo microdata
- resultKiểu: integer | null Định dạng: int64
_count số phần tử trong mảng kết quả
- statusKiểu: integer | null
_code mã trạng thái của tác vụ do DataForSEO tạo; có thể nằm trong khoảng sau: 10000-60000; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây
- statusKiểu: string | null
_message thông điệp thông tin của tác vụ; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây
- timeKiểu: string | null
thời gian thực thi, giây
- Kiểu: integer | null Định dạng: int64tasks
_count số lượng tác vụ trong mảng tasks
- Kiểu: integer | null Định dạng: int64tasks
_error số lượng tác vụ trong mảng tasks được trả về kèm lỗi
- Kiểu: string | nulltime
tổng thời gian thực thi, giây
- Kiểu: string | nullversion
phiên bản hiện tại của API
application/json - 400
Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.
- 401
Cần có khóa API Felo hợp lệ.
- 402
Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.
- 403
Tài khoản không được phép thực hiện thao tác này.
- 429
Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.
- 502
Dịch vụ không thể hoàn tất yêu cầu.
- 503
API hoặc dịch vụ thanh toán tạm thời không khả dụng.
- 504
Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.
- default
Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp
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]"
}
]
}
]
}
]
}