/serp

用于本地化搜索结果的 SERP API

查看示例联系销售团队

关键词：running shoes

example.com

排名第 1 · 桌面端 · 美国

关键词：running shoes

example.com

排名第 2 · 商业意图

运行指南 — 信息结果

example.com

关键词：running shoes

example.com

排名第 1 · 桌面端 · 美国

关键词：running shoes

example.com

排名第 2 · 商业意图

工作流

基于搜索数据构建的示例工作流

工作流

基于搜索数据构建的示例工作流

SERP API 功能

按关键词、市场、语言和设备收集排名 URL、广告和搜索功能。选择实时或排队采集，并在自有排名跟踪工具中使用结构化结果。

跑鞋 — 研究示例

             example.com
            

先询问需要优先回答什么问题。然后选择能够支持该决策的数据系列、字段和采集频率。

结果

通过各来源专属的端点收集 Google、Bing、Yahoo、Baidu、YouTube、Naver 和 Seznam 的结果。研究自然搜索结果，以及受支持的地图、新闻、图片、招聘、购物和其他搜索版位。

跑鞋 — 自然搜索结果

             example.com
            

示例排名：1 · 美国 · 桌面端 · 自然搜索结果。

越野跑鞋 — 品类页面

             example.com
            

在受支持的搜索引擎、市场和设备上收集自然搜索结果、广告和搜索功能。使用结构化 JSON、HTML 和来源专属的采集选项进行排名跟踪和竞争研究。

运行指南 — 信息页面

             example.com
            

在扩展周期性工作流之前，请查看所选端点的字段覆盖情况和数据收集选项。

示例品牌 — 引用研究

             example.com
            

使用可比输入开展重复研究。将变化解读为趋势之前，请检查来源上下文。

要点

设置查询词、位置、语言和设备，以便开展可重复的研究。保留 rank_group 和 rank_absolute，以区分结果类型内的排名与在整个页面上的位置。

适用于您工作流的结构化数据

              “内容”
             
              : {
             
              "
              
              关键词
              
              "
             
              :
             
              关键词：running shoes 
              
              "
              
              result_type
              
              "
             
              :
             
              "
              
              自然
              
              "
             
              example.com
             
              "
              
              位置
              
              "
             
              :
             
              "
              
              美国
              
              "
             
              example.com
             
              "
              
              设备
              
              "
             
              :
             
              "
              
              桌面设备
              
              "
             
              }

结构化输出

端点支持时，可选择高级结构化结果、常规结果或 HTML。保留条目类型，以便解析器读取与各搜索功能相关的字段。

适用于您工作流的结构化数据

比较受众在不同市场以及桌面端或移动端看到的结果。 1 为个人任务规划 API 请求，或在分析需要更广泛的历史视角时，讨论批量数据集。 2 3 演示记录仅供说明。有关生产环境访问权限、请求量和采集频率，请与 DataSEO 团队讨论。 4 .

AI 摘要

当您的工作流需要视觉记录或对结果页进行额外解读时，请使用截图和 AI 摘要功能。保留底层查询和来源上下文。

示例响应字段

使用实时请求进行即时检查，或使用排队任务处理计划工作负载。请将任务标识符和检索状态与返回的搜索观察结果分别跟踪。

排队中的采集任务 69.6% / 454ms

实时采集 67.8% / ~1.2s

SEO Labs 80.0% / 平均 4.3 秒

示例数据采集 46.0% / 2.7s

示例数据采集 41.0% / 1.3s

示例数据集 43.0% / 547ms

示例数据采集 50.0% / 583ms

准确性 / 延迟

示例搜索洞察

准确性 / 延迟

示例覆盖率（%）

30%

40%

50%

60%

70%

80%

90%

排队中的采集任务 69.6% / 454ms

实时采集 67.8% / ~1.2s

SEO Labs 80.0% / 平均 4.3 秒

示例数据采集 46.0% / 2.7s

示例数据采集 41.0% / 1.3s

示例数据集 43.0% / 547ms

示例数据采集 50.0% / 583ms

300ms 500ms 1s 2s 4s

延迟（毫秒，对数刻度）

定价

采集范围和访问权限

索取报价适用于你的用量

查看示例联系销售团队

批量已排队

定时数据采集

实时实时

针对相同的关键词集、市场和设备，比较带日期的结果。在决定调查方向前，将排名变化与 URL、竞争页面和搜索结果特征关联起来。

扩展扩展版

确认所选路由和来源

从构想到首次请求

使用 SERP API 构建

设置关键词、搜索引擎、位置、语言和设备。保留这些设置，并用于每次观测，以便排名比较反映相同的受众和市场。

阅读文档 ↗联系我们的团队 ↗

NODE.JS

// 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.

浏览完整的 API 端点参考