Bing Shopping 搜索

Bing Shopping SERP，支持商品检索、市场定向和分页参数。

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

元数据

字段	值
引擎名称	Bing Shopping 搜索
原始名称	Bing Shopping Search
内部标识（scraper）	`bing_shopping`
接口标识（engine）	`bing_shopping_search`
网站	Bing
网站地址	bingshopping.com
输出格式	`json`
版本	`1.0.0`
参数数量	`4`
参数分组	搜索词 (1), 地区与语言 (1), 地理位置 (1), 分页 (1)

请求示例

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

响应示例

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

{
  "search_metadata": {
    "cached": true,
    "created_at": "2026-03-26 08:19:14 UTC",
    "id": "01KMMKKFMP240C475745R3DV3P",
    "json_endpoint": "https://serp.xcrawl.com/01KMMKKFMP240C475745R3DV3P.json",
    "processed_at": "2026-03-26 08:19:14 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMKKFMP240C475745R3DV3P.html",
    "status": "completed",
    "total_time_taken": 11
  },
  "search_parameters": {
    "engine": "bing_shopping",
    "q": "wireless mouse"
  },
  "total_credits_used": 1,
  "ads_results": [
    {
      "displayed_link": "https://www.amazon.com › Shop › wireless mouse'",
      "link": "https://www.bing.com/aclick?ld=e8AFu2EJA1h6bdQSaTsYnwFzVUCUw8vMK4GKwWvvM9QXvDhEj99NvWcrZh0o__4Nt5rvYL3eM_9gtNj2DcMmlk_lWOVzcTz0RtWsTj3uLreFsc8kamQwj4Hr_CoPs3Bf1GKsJg-Hn1eZ42EHXrLmgdRd5vUxJo2em2gdVjQ2LJ7xPJny09vMhcqZkLnol... [truncated, 877 chars]",
      "sitelinks": [
        {
          "link": "https://www.bing.com/aclick?ld=e8AnRZMx_GaGHGPCh9EJOJajVUCUy1Bh2IUA0pqNaH4OHYjHgr7EM1CzwYadorBLrZ5brgvw2djP54_X5yxuGaxJleDm_q5d6Zm3NU1j-VAX8qnfHedlD_viSVslZaOpjulV7y6kEKA0kkHtUMezHnX2PhkGnCjfsCA0WfHsfBNRf4L1SXVs0fpNOwtKR... [truncated, 888 chars]",
          "text": "Amazon Deals"
        },
        {
          "_note": "3 more items omitted"
        }
      ],
      "snippet": "Shop Our Huge Selection · Read Ratings & Reviews · Shop Best Sellers · Fast Shipping",
      "title": "Wireless Mouse' | Amazon® Official Site | Order At Amazon Now"
    },
    {
      "_note": "10 more items omitted"
    }
  ],
  "filters": [
    {
      "options": [
        {
          "link": "https://www.bing.com/shop?q=wireless+mouse&filters=gsfilter%3a%22MSxCYXNpYywyPTEsVHw7%22+scenario%3a%2215%22&fk=Show+Only&FORM=SHOPFL&originIGUID=50DBA6EF6BB64846AAFDA9478B2D9222",
          "text": "Available nearby"
        }
      ],
      "type": "Show Only"
    },
    {
      "_note": "5 more items omitted"
    }
  ],
  "inline_ads_results": [
    {
      "block_position": "top",
      "extracted_price": 59.99,
      "link": "https://www.bing.com/aclick?ld=e8Lw3luzRJKtRAayrciP9mKTVUCUyQ67nIjkLI-JHbIFFire9Bx6r-0XUR0KLG5Uu3LYP8MmJEJbJwcYIDmVtVw9HKud2zs6kmPjaaJZMmI44lnOZfxbx6NoIEo8VjsPWqSluFRbCiLCQWb1Bs3ZxJ5HcbynuiTIAjyiVaEE4Yd858YB6Q9ia2stWnXTq... [truncated, 1442 chars]",
      "price": "$59.99",
      "rating": 4.5,
      "reviews": "797",
      "seller": "Best Buy",
      "thumbnail": "https://th.bing.com/th/id/OPHS.xkoNYkM5buBJ1g474C474?w=180&h=180&c=17&pid=21.1",
      "title": "Microsoft - Surface Bluetooth Optical Ambidextrous Mouse - Wireless - Silver"
    },
    {
      "_note": "19 more items omitted"
    }
  ],
  "pagination": {
    "current": 1,
    "next": "https://www.bing.com/shop?q=wireless+mouse&filters=scenario%3a%2215%22+LookupKey%3a%225248420ecdc74ec196e01952f32b5490%22+ParentRguid%3a%225248420ecdc74ec196e01952f32b5490%22&originIGUID=50DBA6EF6BB64846AAFDA9478B2D9222&... [truncated, 236 chars]",
    "other_pages": {
      "2": "https://www.bing.com/shop?q=wireless+mouse&filters=scenario%3a%2215%22+LookupKey%3a%225248420ecdc74ec196e01952f32b5490%22+ParentRguid%3a%225248420ecdc74ec196e01952f32b5490%22&originIGUID=50DBA6EF6BB64846AAFDA9478B2D9222&... [truncated, 236 chars]",
      "3": "https://www.bing.com/shop?q=wireless+mouse&filters=scenario%3a%2215%22+LookupKey%3a%225248420ecdc74ec196e01952f32b5490%22+ParentRguid%3a%225248420ecdc74ec196e01952f32b5490%22&originIGUID=50DBA6EF6BB64846AAFDA9478B2D9222&... [truncated, 236 chars]",
      "4": "https://www.bing.com/shop?q=wireless+mouse&filters=scenario%3a%2215%22+LookupKey%3a%225248420ecdc74ec196e01952f32b5490%22+ParentRguid%3a%225248420ecdc74ec196e01952f32b5490%22&originIGUID=50DBA6EF6BB64846AAFDA9478B2D9222&... [truncated, 237 chars]"
    }
  },
  "related_searches": [
    {
      "highlighted_words": [
        {
          "value": "Logitech"
        }
      ],
      "link": "https://www.bing.com/shop?q=Logitech+Wireless+Mouse&FORM=RSPINN",
      "text": " Logitech Wireless Mouse"
    },
    {
      "_note": "14 more items omitted"
    }
  ],
  "shopping_results": [
    {
      "free_shipping": true,
      "link": "https://www.bing.com/ck/a?!&&p=651a445617d06723ca4c23df2f4ba128bbb4b389df525858413d44e184e74ba1JmltdHM9MTc3NDQ4MzIwMA&ptn=3&ver=2&hsh=4&fclid=385281eb-d962-6476-376d-96c3d83c658e&u=a1L3Nob3AvcHJvZHVjdHBhZ2U_cT13aXJlbGVzc... [truncated, 577 chars]",
      "price": "$15.30$17.99",
      "seller": "Lenovo AU",
      "thumbnail": "https://th.bing.com/th/id/OPHS.4PQFrnWWeQzEiw474C474?w=220&h=220&c=17&o=5&pid=21.1"
    },
    {
      "_note": "35 more items omitted"
    }
  ]
}

必填参数

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

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

可用参数

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

搜索词

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

地区与语言

参数	类型	必填	说明
`cc`	`string`	否	用于本地化 Bing 系结果的国家代码。

附加约束

cc：可选值：36 个可选值，例如：AR、AU、AT、BE、BR

地理位置

参数	类型	必填	说明
`mkt`	`string`	否	Bing 的市场代码，通常由语言和国家组成，例如 `en-US`。

附加约束

mkt：可选值：37 个可选值，例如：es-ar、en-au、de-at、nl-be、fr-be

分页

参数	类型	必填	说明
`efirst`	`string`	否	Result Offset 参数。

引擎列表

Bing Shopping 搜索