沙盒环境

POST https://sandbox.api.seermartech.cn/v3/$path

沙盒环境用于在不产生费用的调试和验证 API 集成。沙盒返回模拟数据，但响应结构、字段定义及任务处理方式与生产环境保持一致，适合用于开发、联调和解析逻辑验证。

沙盒接口不计费，已注册用户可使用。生产环境调用请使用 https://api.seermartech.cn。

动态字段	说明
$path	需要测试的 API 路径，不 /v3/ 前缀。
示例	serp/google/maps/task_post

> 沙盒中的所有结果均为模拟数据，不代表真实搜索结果、数据、域名数据或市场数据。

沙盒能力与限制

• 调用：沙盒请求不会产生费用。
• 模拟响应：响应中的字段结构与生产环境一致，字段值为模拟数据。
• 回调支持：支持 pingback_url 与 postback_url。 -平台限流以认证说明中的 30/60/120 次/分钟规则为准/分钟**。
• 批量任务限制：
  • 沙盒中的异步 POST 接口：单次请求最多可提交 100 个任务。
  • 生产环境中的异步 POST 接口：单次请求可提交 1 个任务。
• 认证方式：沙盒与生产环境使用相同的 API 密钥认证方式。

Authorization: Bearer smt_live_YOUR_KEY

使用方式

使用沙盒时，无需修改请求参数或业务代码，只需将生产环境域名替换为沙盒域名：

生产环境：https://api.seermartech.cn/v3/...
沙盒环境：https://sandbox.api.seermartech.cn/v3/...

例如，原本请求生产环境的地址：

https://api.seermartech.cn/v3/serp/google/organic/task_post

在沙盒中应改为：

https://sandbox.api.seermartech.cn/v3/serp/google/organic/task_post

POST 请求体仍需使用 JSON 数组格式：

[
  {
    "keyword": "example keyword",
    "location_name": "United States",
    "language_name": "English"
  }
]

SERP API 沙盒

提交任务

使用与生产环境相同的任务提交路径替换域名：

POST https://sandbox.api.seermartech.cn/v3/serp/google/organic/task_post

获取任务结果

提交任务后，使用任务 ID 获取模拟结果：

GET https://sandbox.api.seermartech.cn/v3/serp/google/organic/task_get/advanced/$id

，$id 为任务提交接口返回的任务 ID。

查看完整自然搜索结果字段结构

如需查看 Google 自然搜索高级结果接口支持的 SERP素及字段，可请求以下固定任务 ID：

GET https://sandbox.api.seermartech.cn/v3/serp/google/organic/task_get/advanced/00000000-0000-0000-0000-000000000000

该请求将返回可用结果项的模拟响应，可用于开发搜索结果解析器、验证富媒体结果字段及建立数据模型。

Keywords Data API 沙盒

提交数据任务：

POST https://sandbox.api.seermartech.cn/v3/keywords_data/google/search_volume/task_post

请求体示例：

[
  {
    "keywords": [
      "seo tools",
      "keyword research"
    ],
    "location_name": "United States",
    "language_name": "English"
  }
]

获取任务结果：

GET https://sandbox.api.seermartech.cn/v3/keywords_data/google/search_volume/task_get/$id

Domain Analytics API 沙盒

域名分析类接口采用实时返回方式，无需额外调用 GET 接口获取结果。

POST https://sandbox.api.seermartech.cn/v3/domain_analytics/technologies/aggregation_technologies/live

请求体应保持 JSON 数组格式：

[
  {
    "target": "example.com"
  }
]

本平台 Labs API 沙盒

数据实验室接口采用实时返回方式，请求后会直接返回模拟结果，无需轮询任务状态。

POST https://sandbox.api.seermartech.cn/v3/dataforseo_labs/google/related_keywords/live

Backlinks API 沙盒

反向链接接口采用实时返回方式：

POST https://sandbox.api.seermartech.cn/v3/backlinks/referring_domains/live

OnPage API 沙盒

创建页面抓取任务：

POST https://sandbox.api.seermartech.cn/v3/on_page/task_post

请求体示例：

[
  {
    "target": "https://example.com"
  }
]

创建任务后，可通过以下接口请求页面和链接的模拟分析结果：

POST https://sandbox.api.seermartech.cn/v3/on_page/pages

POST https://sandbox.api.seermartech.cn/v3/on_page/links

Content Analysis API 沙盒

分析接口会在请求后直接返回模拟数据：

POST https://sandbox.api.seermartech.cn/v3/content_analysis/search/live

Merchant API 沙盒

提交商品数据任务：

POST https://sandbox.api.seermartech.cn/v3/merchant/google/products/task_post

获取任务结果：

GET https://sandbox.api.seermartech.cn/v3/merchant/google/products/task_get/advanced/$id

App Data API 沙盒

提交应用搜索任务：

POST https://sandbox.api.seermartech.cn/v3/app_data/google/app_searches/task_post

获取任务结果：

GET https://sandbox.api.seermartech.cn/v3/app_data/google/app_searches/task_get/advanced/$id

Business Data API 沙盒

提交信息查询任务：

POST https://sandbox.api.seermartech.cn/v3/business_data/google/hotel_info/task_post

获取任务结果：

GET https://sandbox.api.seermartech.cn/v3/business_data/google/hotel_info/task_get/advanced/$id

实时任务（Live）沙盒

支持实时返回结果的接口同样可以通过沙盒测试。调用时将生产环境域名替换为沙盒域名即可。

以下为常用实时接口示例：

POST https://sandbox.api.seermartech.cn/v3/keywords_data/google/search_volume/live

POST https://sandbox.api.seermartech.cn/v3/serp/google/organic/live/regular

POST https://sandbox.api.seermartech.cn/v3/dataforseo_labs/google/ranked_keywords/live

POST https://sandbox.api.seermartech.cn/v3/dataforseo_labs/google/related_keywords/live

POST https://sandbox.api.seermartech.cn/v3/dataforseo_labs/google/competitors_domain/live

POST https://sandbox.api.seermartech.cn/v3/backlinks/referring_domains/live

实用场景

• 验证 SERP 解析逻辑：使用固定任务 ID 获取完整模拟搜索结果结构，提前适自然结果、图片、视频、知识图谱等不同结果项。
• 调试异步任务流程：在不产生费用的测试任务提交、任务 ID 保存、结果轮询及失败重试逻辑。
• 联调分析功能：通过搜索量、和排名等模拟响应，验证研究的数据展示与计算逻辑。
• 构建站点审计模块：使用页面抓取、页面列表和链接分析接口的模拟数据，开发网站技术 SEO 检测与问题归类功能。
• 测试回调处理服务： pingback_url 或 postback_url，验证异步任务完成后的回调接收、签名校验和数据库流程。