Yahoo 图片搜索

Yahoo 图片 SERP，支持图片检索以及布局、颜色、尺寸、类型等过滤参数。

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

元数据

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

请求示例

下面的请求体是本次文档更新时实际用于验证 yahoo_images 的请求。对于 /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_images","b":1,"q":"openai logo"}'

响应示例

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

{
  "search_metadata": {
    "created_at": "2026-03-26 08:33:07 UTC",
    "id": "01KMMMCV5VFAFK0VDY3HJVPZQ1",
    "json_endpoint": "https://serp.xcrawl.com/01KMMMCV5VFAFK0VDY3HJVPZQ1.json",
    "processed_at": "2026-03-26 08:33:07 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMMCV5VFAFK0VDY3HJVPZQ1.html",
    "status": "completed",
    "total_time_taken": 12
  },
  "search_parameters": {
    "b": 1,
    "engine": "yahoo_images",
    "q": "openai logo"
  },
  "total_credits_used": 1,
  "images_results": [
    {
      "link": "https://images.search.yahoo.com/search/images;_ylt=Awrg3R4878RpRgIA9daJzbkF;_ylu=Y29sbwNncTEEcG9zAzEEdnRpZAMEc2VjA3Ny?p=openai+logo&imgurl=https%3A%2F%2Flogos-world.net%2Fwp-content%2Fuploads%2F2024%2F08%2FOpenAI-Logo.jp... [truncated, 221 chars]",
      "original": "https://logos-world.net/wp-content/uploads/2024/08/OpenAI-Logo.jpg",
      "position": 1,
      "size": "3840x2160",
      "source": "https://logos-world.net/openai-logo/",
      "thumbnail": "https://tse4.mm.bing.net/th/id/OIP.Yn879D-SbFfIJB4W9wgAFwHaEK?pid=Api&h=220&P=0",
      "title": "OpenAI Logo, symbol, meaning, history, PNG, brand"
    },
    {
      "_note": "31 more items omitted"
    }
  ],
  "related_searches": [
    {
      "link": "https://images.search.yahoo.com/search/images;_ylt=Awrg3R4878RpRgIACdeJzbkF;_ylu=Y29sbwNncTEEcG9zAzEEdnRpZAMEc2VjA3JlbC1lYXN0?&p=Openai+Logo+Word+Art&fr2=p%3As%2Cv%3Ai%2Cm%3Ars-algo-rel",
      "name": "openai logo Word Art",
      "serpapi_link": "https://serpapi.com/search.json?device=desktop&engine=yahoo_images&p=Openai+Logo+Word+Art"
    },
    {
      "_note": "9 more items omitted"
    }
  ],
  "suggested_searches": [
    {
      "link": "https://images.search.yahoo.com/search/images;_ylt=Awrg3R4878RpRgIA5taJzbkF;_ylu=Y29sbwNncTEEcG9zAzEEdnRpZAMEc2VjA3JlbA--?&p=Openai+Logo+Transparent&fr2=p%3As%2Cv%3Ai%2Cm%3Ars-top%2Cct%3Abing%2Crgn%3Atop%2Cpos%3A1",
      "name": "openai logo Transparent",
      "serpapi_link": "https://serpapi.com/search.json?device=desktop&engine=yahoo_images&p=Openai+Logo+Transparent"
    },
    {
      "_note": "14 more items omitted"
    }
  ]
}

必填参数

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

参数	类型	分组	说明
`b`	`number`	分页	Yahoo 风格分页使用的结果偏移量。
`q`	`string`	搜索词	你想让搜索引擎检索的关键词或短语。

可用参数

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

分页

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

附加约束

b：默认值：1

搜索词

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

高级筛选

参数	类型	必填	说明
`imga`	`string`	否	Layout 参数。
`imgc`	`string`	否	Color 参数。
`imgf`	`string`	否	People 参数。
`imgl`	`string`	否	Usage Rights 参数。
`imgt`	`string`	否	Time 参数。
`imgsz`	`string`	否	按尺寸或最低分辨率筛选图片。
`imgty`	`string`	否	Image Type 参数。

附加约束

imga：可选值：3 个可选值，例如：square、wide、tall
imgc：可选值：14 个可选值，例如：color、bw、red、orange、yellow
imgf：可选值：3 个可选值，例如：face、portrait、nonportrait
imgl：可选值：6 个可选值，例如：cc、pd、fsu、fsuc、fmsu
imgt：可选值：4 个可选值，例如：day、week、month、year
imgsz：可选值：4 个可选值，例如：small、medium、large、wallpaper
imgty：可选值：5 个可选值，例如：photo、clipart、linedrawing、gif、transparent

请求控制

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

附加约束

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

引擎列表

Yahoo 图片搜索