AI 工作流规划
SERP API 文档和集成指南
发送服务器端任务请求,使用您的账户进行身份验证,并查看 HTTP 状态和各任务状态。探索 SEO 和营销数据类别中相同的集成模式。
在受支持的搜索引擎、市场和设备上收集自然搜索结果、广告和搜索功能。使用结构化 JSON、HTML 和
特定来源的
身份验证和任务请求
生产环境账户使用 HTTP Basic 身份验证。请在服务器上使用提供的登录名和密码构建 Authorization 标头;请勿将凭据放入浏览器代码或共享示例中。
对于受支持的采集 POST 路由,请发送一个数组,其中包含
task objects. Each task contains that route’s inputs; a keyword query, page URL and product identifier are not interchangeable
请求载荷。
// Server-side example; configure your deployment and credentials.
const url = new URL("/v3/serp/google/organic/live/advanced", process.env.DATASEO_API_ORIGIN);
const auth = Buffer.from(`${process.env.DATASEO_LOGIN}:${process.env.DATASEO_PASSWORD}`).toString("base64");
const response = await fetch(url, {
method: "POST",
headers: {Authorization: `Basic ${auth}`, "Content-Type": "application/json"},
body: JSON.stringify([{"keyword": "running shoes", "location_code": 2840, "language_code": "en", "device": "desktop"}])
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
for (const task of data.tasks ?? []) {
if (task.status_code !== 20000) throw new Error(task.status_message);
}
// Use task.result only after checking task status.
Check the HTTP status first, then the top-level response and each task status_code. A successful HTTP 200 can still contain task errors; only read task.result after validating the task.
YOUR_CONFIGURED_TOOL_SERVER
检查响应状态
关键词采集需要指定数据源和受支持的市场设置。将广告竞争度解读为付费搜索指标,并将月搜索量与标准化趋势分数分开处理。
若要检查 URL,请从 /v3/on_page/instant_pages 开始,并提供 url 输入。浏览器渲染和 Lighthouse 使用单独的选项或路由,可能需要额外设置。
如需获取官方模型回复,请使用受支持的 llm_responses 路由并提供 user_prompt。列出已配置的模型,并在比较回答时保留模型设置。
排队中的任务路由会返回供后续检索使用的标识符。请保存这些标识符,并按照所选路由的文档说明,使用 ready/get 流程检查任务状态,而不要假设所有产品都采用相同的交付方式。
保留数据收集时间戳、输入设置和来源标识符。缺失字段应保留为 null 或不提供;不要将不可用的指标转换为零。
受支持的搜索引擎、市场和设备上的自然搜索结果、广告和搜索功能。使用
用于排名跟踪和竞争研究的结构化 JSON、HTML 及特定来源的采集选项。
本网站的代码和响应仅供说明。生产环境部署前,必须确认路由架构、访问权限、配额、数据处理方式和客户定价。
该应用目前未提供经过验证的公开 MCP 服务器,也未提供图示工具的原生连接器。只有在确认所需来源和路由后,才可使用服务器端 HTTP 集成。
扩大规模前,请验证一个有代表性的响应。检查空值、项目类型、字段单位、错误消息,以及结果是否能回答应用需要解决的问题。
确保日志不包含凭据和敏感请求内容。存储生产环境观测数据之前,请就所选来源的保留期限、许可和允许用途达成一致。
“关于 RAG 的近期论文”
选择受支持的产品路由,配置部署源和凭据,然后先测试一项任务,再安排更大的工作负载。此界面使用本地示例数据,不会发送实时 API 请求。