Task Post

正式环境

https://api.302.ai

POST

/dataforseo/v3/on_page/task_post

OnPage API 可针对网站的60多种可自定义页面级参数进行检测，并展示所有发现的缺陷及优化机会，以便您轻松修复。它会检查每一页的元标签、重复内容、图片标签、响应代码及其他参数。您可在“页面”部分查看OnPage API 检测的完整参数列表。
所有POST数据应以JSON格式（UTF-8编码）发送。任务设置通过POST方法完成。在设置任务时，您需将所有任务参数放入通用POST数组的任务数组中。您每分钟最多可发送2000次API调用，每次POST调用包含的任务数不得超过100个。如果您的POST调用包含超过100个任务，则超出限制的任务将返回40006错误。
您同时发送的请求数量上限为30个。

参考：https://docs.dataforseo.com/v3/on_page/task_post/

价格：cost * 1PTC/次

请求参数

Header 参数

Body 参数application/json必填

示例

[
    {
        "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"
    }
]

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/dataforseo/v3/on_page/task_post' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "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"
    }
]'

返回响应

🟢200

application/json

Body

示例

{}

修改于 2026-03-25 10:39:02

Filters And Thresholds

Tasks Ready