Yahoo 搜索

Yahoo 搜索 SERP，支持关键词检索、域名过滤和分页参数。

本页给出 Yahoo 搜索的字段定义、参数分组、必填约束以及可用过滤参数。

元数据

字段	值
引擎名称	Yahoo 搜索
原始名称	Yahoo Search
内部标识（scraper）	`yahoo_search`
接口标识（engine）	`yahoo_search`
网站	Yahoo
网站地址	Yahoo.com
输出格式	`json`
版本	`1.0.0`
参数数量	`9`
参数分组	分页 (1), 搜索词 (1), 地区与语言 (3), 高级筛选 (3), 请求控制 (1)

请求示例

下面的请求体是本次文档更新时实际用于验证 yahoo_search 的请求。对于 /v1/serp，engine 字段应传当前引擎的 scraper 值。

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

响应示例

下面的 JSON 片段来自同一次真实响应。为了避免页面被超长字段淹没，超长字符串、data URL 和大型数组做了裁剪。

{
  "search_metadata": {
    "created_at": "2026-03-26 08:33:57 UTC",
    "id": "01KMMMEF16J2S94V1AZXJ0JRD3",
    "json_endpoint": "https://serp.xcrawl.com/01KMMMEF16J2S94V1AZXJ0JRD3.json",
    "processed_at": "2026-03-26 08:33:57 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMMEF16J2S94V1AZXJ0JRD3.html",
    "status": "completed",
    "total_time_taken": 9
  },
  "search_parameters": {
    "engine": "yahoo_search",
    "q": "openai"
  },
  "total_credits_used": 1,
  "ads_results": [
    {
      "block_position": "top",
      "favicon": "https://up.yimg.com/ib/th?id=OADD2.1272134981145483_156MVKVJMXBUFZO&pid=21.2&w=16&c=1&rs=1&qlt=95",
      "link": "https://azure.microsoft.com/en-us/products/ai-foundry/models/openai/?ef_id=_k_20e388f1d60712649663e13539767090_k_&OCID=AIDcmmhvcv1sd6_SEM_k_20e388f1d60712649663e13539767090&utm_source=bing&utm_medium=cpc&utm_campaign=590... [truncated, 344 chars]",
      "position": 0,
      "sitelinks": {
        "expanded": [
          {
            "link": "https://azure.microsoft.com/en-us/pricing/calculator/?ef_id=_k_e2a11b7c81f4124a4e5a72b86e85c6b9_k_&OCID=AIDcmmhvcv1sd6_SEM_k_e2a11b7c81f4124a4e5a72b86e85c6b9&utm_source=bing&utm_medium=cpc&utm_campaign=590417846&utm_adgr... [truncated, 329 chars]",
            "snippet": "Azure Pricing Calculator",
            "title": "Azure Pricing Calculator"
          },
          {
            "_note": "1 more items omitted"
          }
        ]
      },
      "snippet": "Sign Up for an Account Today and Start Using Azure OpenAI Service. Build Cutting-Edge Applications with Large-Scale, Generative AI Models Backed by Azure. ",
      "title": "Deep Learning For Your Apps - Create Your Account Today"
    }
  ],
  "knowledge_graph": {
    "image": "https://s.yimg.com/zb/imgv1/4101d01f-a338-3734-958b-9574654493d2/t_500x300",
    "profiles": [
      {
        "link": "https://search.yahoo.com/search;_ylt=Awrhblpw78RpJgIAHBBXNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3Nj?ei=UTF-8&p=DeepSeek&d=%7B%22domain%22%3A%22company%22%2C%22type%22%3A%22yk%22%2C%22id%22%3A%22fa8fdff2-08f9-42ef-b93... [truncated, 304 chars]",
        "name": "DeepSeek"
      },
      {
        "_note": "9 more items omitted"
      }
    ]
  },
  "organic_results": [
    {
      "displayed_link": "",
      "link": "https://news.search.yahoo.com/search;_ylt=Awrhblpw78RpJgIA5A9XNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3Nj?p=openai&fr=fp-tts&fr2=p%3As%2Cv%3Aw%2Cm%3Anewsdd_tnn_t%2Cct%3Abing",
      "position": 0,
      "snippet": "OpenAI is shutting down its Sora video app six months after launch and Disney's $1 billion deal is off. Here is what happened and what comes next.",
      "snippet_highlighted_words": [],
      "title": "Top Stories"
    },
    {
      "_note": "5 more items omitted"
    }
  ],
  "pagination": {
    "current": 1,
    "next": "https://search.yahoo.com/search;_ylt=Awrhblpw78RpJgIADRBXNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3BhZ2luYXRpb24-?ei=UTF-8&fr=fp-tts&p=openai&b=8&pz=7&bct=0&xargs=0&pstart=3",
    "other_pages": {
      "2": "https://search.yahoo.com/search;_ylt=Awrhblpw78RpJgIACRBXNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3BhZ2luYXRpb24-?ei=UTF-8&fr=fp-tts&p=openai&b=8&pz=7&bct=0&xargs=0&pstart=3",
      "3": "https://search.yahoo.com/search;_ylt=Awrhblpw78RpJgIAChBXNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3BhZ2luYXRpb24-?ei=UTF-8&fr=fp-tts&p=openai&b=15&pz=7&bct=0&xargs=0&pstart=5",
      "4": "https://search.yahoo.com/search;_ylt=Awrhblpw78RpJgIACxBXNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3BhZ2luYXRpb24-?ei=UTF-8&fr=fp-tts&p=openai&b=22&pz=7&bct=0&xargs=0&pstart=7",
      "5": "https://search.yahoo.com/search;_ylt=Awrhblpw78RpJgIADBBXNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3BhZ2luYXRpb24-?ei=UTF-8&fr=fp-tts&p=openai&b=29&pz=7&bct=0&xargs=0&pstart=9"
    }
  },
  "related_questions": [
    {
      "link": "https://search.yahoo.com/search;_ylt=Awrhblpw78RpJgIA.A9XNyoA;_ylu=Y29sbwNiZjEEcG9zAzIEdnRpZAMEc2VjA3Nj?ei=UTF-8&p=Where+is+OpenAI+headquarters%3F&fr2=p%3As%2Cv%3Aw%2Cm%3AnuwaPeopleAlsoAsk&fr=fp-tts",
      "title": "Where is OpenAI headquarters?"
    },
    {
      "_note": "3 more items omitted"
    }
  ],
  "related_searches": {
    "bottom": [
      {
        "link": "https://search.yahoo.com/search;_ylt=Awrhblpw78RpJgIAARBXNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3JlbC1ib3Q-?ei=UTF-8&p=openai+discontinues+sora+video+platform&fr2=p%3As%2Cv%3Aw%2Cm%3Ars-bottom%2Cct%3Agossip&fr=fp-tts",
        "query": "openai discontinues sora video platform"
      },
      {
        "_note": "7 more items omitted"
      }
    ]
  },
  "search_information": {
    "query_displayed": "openai"
  },
  "trending_searches": {
    "results": [
      {
        "link": "https://search.yahoo.com/search;_ylt=Awrhblpw78RpJgIAMRBXNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3Nj?ei=UTF-8&p=NCIS&fr2=p%3As%2Cv%3Aw%2Cm%3Atn%2Cct%3Aall%2Cpg%3A1%2Cstl%3Atxt%2Ckt%3Aorg%2Cb%3A&fr=fp-tts",
        "position": 0,
        "title": "NCIS kills off major character in 500th episode",
        "trending": 0
      },
      {
        "_note": "5 more items omitted"
      }
    ]
  }
}

必填参数

以下表格列出当前 metadata 中标记为 must: true 的字段。字段是否必填，以 properties.<field>.must 为准，不以顶层 required 数组为准。

参数	类型	分组	说明
`q`	`string`	搜索词	你想让搜索引擎检索的关键词或短语。

可用参数

以下内容按后端返回的字段分组展示。主表只保留字段名、类型、必填标记和字段说明；默认值、可选值等附加约束会列在每个分组后。

分页

参数	类型	必填	说明
`b`	`string`	否	Yahoo 风格分页使用的结果偏移量。

搜索词

参数	类型	必填	说明
`q`	`string`	是	你想让搜索引擎检索的关键词或短语。

地区与语言

参数	类型	必填	说明
`vc`	`string`	否	Yahoo 用于本地化结果的国家代码。
`vl`	`string`	否	Yahoo 的语言筛选参数。
`yahoo_domain`	`string`	否	要请求的 Yahoo 域名，可用于切换到不同地区站点。

附加约束

vc：可选值：94 个可选值，例如：al、dz、ar、am、au
vl：可选值：32 个可选值，例如：lang_ar、lang_bg、lang_zh_chs、lang_zh_cht、lang_hr
yahoo_domain：可选值：40 个可选值，例如：espanol、be、fr、br、ca

高级筛选

参数	类型	必填	说明
`vf`	`string`	否	Yahoo 的文件类型筛选参数，例如 PDF、DOC 或 TXT。
`vm`	`string`	否	Yahoo 的安全搜索级别。
`vs`	`string`	否	将 Yahoo 结果限制在特定顶级域名，例如 `.com` 或 `.org`。

附加约束

vf：可选值：6 个可选值，例如：html、pdf、xls、ppt、doc
vm：可选值：3 个可选值，例如：r、i、p

请求控制

参数	类型	必填	说明
`device`	`string`	否	请求结果时使用的设备类型，例如桌面端或平板端。

附加约束

device：可选值：1 个可选值，例如：desktop

引擎列表

Yahoo 搜索