SERP

SERP 专区整理了各搜索引擎的字段定义、参数分组、必填约束、分页参数以及地区 / 语言控制项。

如果你要先确认支持哪些引擎，查看 Supported Engines
如果你要先梳理跨引擎复用的参数，查看 Common Parameters
如果你已经确定目标引擎，直接进入左侧对应的引擎页

Search API 参考页侧重公开请求 / 响应结构
SERP 专区侧重引擎级参数能力、字段约束和差异说明

请求示例

下面这个 /v1/serp 请求是在 2026-03-26 实际调用时使用的请求体，示例引擎为 bing_videos。请求体中的 engine 字段应使用支持引擎页里的 scraper 值。

curl -X POST "https://run.xcrawl.com/v1/serp" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"engine":"bing_videos","q":"360"}'

请求头中的 Authorization 使用 Bearer Token
这是文档更新时实际跑通的一条请求，不是按 schema 手写的占位示例

响应示例

下面的 JSON 片段截取自同一次真实响应。为了便于阅读，超长字符串、data URL 和大型数组做了裁剪，但字段结构仍然来自真实返回。

{
  "search_metadata": {
    "cached": true,
    "created_at": "2026-03-26 08:16:41 UTC",
    "id": "01KMMKETDC42XNJ0D76QQHCZ42",
    "json_endpoint": "https://serp.xcrawl.com/01KMMKETDC42XNJ0D76QQHCZ42.json",
    "processed_at": "2026-03-26 08:16:41 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMKETDC42XNJ0D76QQHCZ42.html",
    "status": "completed",
    "total_time_taken": 10
  },
  "search_parameters": {
    "engine": "bing_videos",
    "q": "360"
  },
  "total_credits_used": 1,
  "video_results": [
    {
      "channel": "Science Filmmaking Tips",
      "date": "Feb 2, 2016",
      "extracted_views": 756000,
      "length": "18:39",
      "link": "https://www.bing.com/videos/riverview/relatedvideo?q=360&&mid=B0496CDAD7A952FB968CB0496CDAD7A952FB968C&FORM=VRDGAR",
      "position": 1,
      "source": "756K views",
      "thumbnail": "data:image/webp;base64,UklGRjAQAABXRUJQVlA4ICQQAADwVgCdASrzAIgAP0WGt1WwKKUjM9r9E... [truncated data URL, 5559 chars]",
      "title": "How to Make 360° Video (VR) : Basic Workflow Explained",
      "views": "756K views"
    },
    {
      "_note": "28 more items omitted"
    }
  ]
}

文档范围

查看当前支持的搜索引擎及其对应的 scraper
对比各引擎的参数规模、必填字段和字段分组
确认单个引擎支持的过滤条件、分页参数和地区 / 语言控制

建议阅读顺序

首次接入时，建议按“概览 -> 支持的引擎 -> 通用参数 -> 单引擎页面”的顺序阅读
已确定目标引擎时，可以直接进入对应引擎页查看字段定义
页面中的参数能力来自实时后端元数据，文档仅对字段说明做了整理

约束说明

必填参数以字段级 must 标记为准
同名参数在不同引擎中的语义和取值范围可能不同
如果某些参数包含大量枚举值，文档只展示摘要和示例，完整取值以实时接口返回为准

引擎列表