京东 JD.com 关键词搜索 API

按 keyword 搜京东商品,每条返回 item_id、title、price、currency、shop_name、is_jd_self、sold_count 和 good_rate,按返回条数分档计费,每档 $0.002472。

京东关键词搜索按 keyword 检索京东商品,返回商品 ID、标题与短标题、价格、评价条数、好评率、店铺、是否京东自营、促销标签和卖点。它回答「搜这个词,京东上排在前面的是哪些商品、谁在卖、口碑如何」,适合做选品初筛、价格带摸底,以及自营与第三方店铺的对比。

中文关键词通常更贴近站内商品标题,命中更准。结果里的 item_id 可以直接交给京东的商品详情、评价能力继续深挖;good_rate 是京东公开的好评率百分比,要和评价数一起看;review_count、sold_count 是列表上显示的文字(如「10万+」),不是精确数字。

  • page 或 page_token 往后翻,limit 定一页条数
  • promotion 和 sell_point 给列表上的促销标签和卖点
  • 失败和空结果不收费
免费开始

接口健康状态

24h 健康值
100%
24h 平均耗时
12.38 s
  • 健康 / 正常
  • 可用
  • 少量可用
  • 基本不可用
健康

24 小时趋势

30 天趋势

  1. 1请求

    POST /api/v1/social
    {
      "platform": "jd",
      "action": "search",
      "params": {
        "keyword": "华为手机"
      }
    }
  2. 2JSON 响应

    {
      "results": [
        {
          "item_id": "10237497167004",
          "title": "华为手机2026热销新机上市畅享 90 Plus 麒麟8系芯片丝滑超好用鸿蒙AI防诈6620mAh巨鲸大电池柔光护眼 星空黑【128GB】 官方标配【365天延保+蓝牙耳机+运费险】",
          "price": 1999,
          "currency": "CNY"
        },
        …
      ],
      "count": 5
    }
  3. 3行

    item_idtitlepricecurrency
    10237497167004华为手机2026热销新机上市畅享 90 Plus 麒麟8系芯片丝滑超好用鸿蒙AI防诈6620mAh巨鲸大电池柔光护眼 星空黑【128GB】 官方标配【365天延保+蓝牙耳机+运费险】1999CNY
    10230554159591华为mate60pro手机智能手机鸿蒙智能AI手机麒麟芯片正品国行mate60赠手机壳 Mate60Pro【雅川青】 12GB+256GB 7天试用(送手机壳88W充电器)2837CNY
  4. 4CSV

    jd-search-sample.csv item_id,url,title,short_title,price,currency,sold_count,review_count,good_rate,shop_id,shop_name,shop_url,is_jd_self,promotion,sell_point,category_ids,image_url,platform

请求带 keyword,返回一页商品,results 里每行是一件商品,列成字段表,也可下载为 CSV。

能拿到什么数据

下表取自对 华为手机 的一次真实调用,采集于 2026年10月25日 02:28(UTC),共返回 5 行。你自己调用时,按字段表返回这些字段。

item_idurltitleshort_titlepricecurrencysold_countreview_countgood_rateshop_idshop_nameshop_urlis_jd_selfpromotionsell_pointcategory_idsimage_urlplatform
10237497167004https://item.jd.com/10237497167004.html华为手机2026热销新机上市畅享 90 Plus 麒麟8系芯片丝滑超好用鸿蒙AI防诈6620mAh巨鲸大电池柔光护眼 星空黑【128GB】 官方标配【365天延保+蓝牙耳机+运费险】null1999CNYnullnullnull219104371迪旺手机专营店https://mall.jd.com/index-219104371.htmlnullnullnull["9987","653","655"]https://img14.360buyimg.com/n0/jfs/t1/547105/14/3627/77818/6ad1919eFd3fb2338/0083320320125c52.pngjd
10230554159591https://item.jd.com/10230554159591.html华为mate60pro手机智能手机鸿蒙智能AI手机麒麟芯片正品国行mate60赠手机壳 Mate60Pro【雅川青】 12GB+256GB 7天试用(送手机壳88W充电器)null2837CNYnullnullnull169276555尊享数码手机拼购店https://mall.jd.com/index-169276555.htmlnullnullnull["9987","653","655"]https://img14.360buyimg.com/n0/jfs/t1/483100/15/10357/93091/6a647f40Ff1f84472/008332032085260d.jpgjd

用途

  • 选品初筛

    搜一个品类词,用 price 看价格带,用 shop_name 看有哪些店铺在卖。

  • 盯品牌词的搜索结果

    定期读同一个 keyword,比较 item_id 的排位和 promotion 标签有没有变。

  • 比口碑

    把 good_rate 和 review_count 放在一起看,挑出口碑好、评价多的商品,再用 reviews 读评价。

  • 整理卖点写法

    sell_point 是列表上的公开卖点,读一批竞品的卖点,看它们怎么写。

京东帮助中心和京东联盟(宙斯 JOS) 与 EveryInfra 对比

下面从好评率和接入条件两方面,比较京东帮助中心的评价晒单规则、京东联盟和 EveryInfra search。

对比项京东帮助中心和京东联盟(宙斯 JOS)EveryInfra
好评率好评定义:"用户提交的4-5星评价为好评,会计入好评数和好评率的计算。"good_rate 是京东公开的好评率百分比;review_count 是列表上显示的评价数原文,可能是约数。
接入条件"联盟创建的appkey除了可以在联盟平台……调用API,也可以在宙斯平台调用联盟接口"。一把 EveryInfra API Key 放在 Authorization: Bearer 请求头里,不需要联盟账号和 appkey,不用登录京东。

引文出自京东帮助中心的评价晒单规则和京东联盟页面(jos.jd.com/jdunion),2026-11-22 核对;页面没有标更新日期。联盟接口是推广者读推广商品用的,这里只比好评率的口径和接入条件。 官方出处: 评价晒单规则(京东帮助中心) · 京东联盟

限制和注意事项

  • keyword 必填,中文关键词通常更贴近站内商品标题。
  • limit 上限 30。翻页用 page(整数,不传按第 1 页),或把响应里的 next_page_token 原样作为 page_token 传回;两个同传时以 page_token 为准。
  • 能翻到的深度有固定上限,翻到头时 pagination.stop_reason 为 depth_limit;列表本来就短时为 end_of_list。
  • 第 2 页起的商品取自一份保存下来的列表,最多是一小时前的;用 page 直接跳页时,页与页之间可能有商品重复或缺漏,合并时按 item_id 去重。要不重复地读完整个列表,从第 1 页起跟着 next_page_token 翻。
  • sold_count、review_count 是列表上显示的原文(如「10万+」),是文本、可能是约数,sold_count 可能缺省。
  • price 是抓取时可见的价格快照,可能不含会员、新人、地区、定向券或结算页权益。

价格

按这一页返回的商品条数分档计费,每一档算一次调用,每次 $0.002472;没返回的条数对应的档退回,一条都没返回的空页不扣费。用 page 直接跳到第 N 页,按前面各页整页加上第 N 页本身一起收,和一页页翻到第 N 页收得一样。失败和空结果不收费。

调用次数费用
10,000$24.72
100,000$247.22
1,000,000$2,472.22

合计按每次调用的标价算。

代码示例

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "jd",
  "action": "search",
  "params": {
    "keyword": "华为手机"
  }
}'

OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key,复制出去的代码不含你的 Key。

keyword 是商品搜索词;目前固定一页,最多 25 条。

API 参考

下面是 search 的参数、响应字段、错误和计费,可以复制整页,或用 Markdown 打开后交给 AI 助手。

POST

AI 提示词

#
请帮我用 EveryInfra 的「京东 JD.com 关键词搜索」接口(jd/search)写一个数据采集脚本。

接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 jd,action 填 search,参数放在 params 里。
- 必填参数:
  - keyword:京东商品搜索词;中文关键词通常更贴近站内商品标题。
- 可选参数:
  - page:搜索结果的页码,整数;不传或传 1 就是第 1 页。取值范围是 1 到 150 ÷ limit(向上取整):limit 30 时 1–5,默认 limit 5 时 1–30,limit 10 时 1–15。
  - page_token:翻页令牌。第 1 页不用传;响应里有 next_page_token 时,把它原样作为 page_token 传回就拿下一页,其余参数保持不变。
  - limit:这次调用最多返回的条数,整数,1–30;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。(默认 5)
- 返回一组记录,每条记录的主要字段:item_id(京东商品数字 ID)、url、title、short_title(京东返回的商品短标题)、price、currency、sold_count(搜索列表上显示的销量原文(sear…)、review_count(搜索列表上显示的评价数原文(sea…)、good_rate(京东公开的好评率百分比)、shop_id(京东店铺数字 ID)、shop_name(公开店铺名称)、shop_url(京东店铺公开页面);一共 17 个字段,完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=jd。
- 示例请求体:
{
  "platform": "jd",
  "action": "search",
  "params": {
    "keyword": "华为手机"
  }
}
- 计费:$2.47 / 千次;失败和空结果不扣费。
- 一次要采几十上百个时,在请求体加 "mode": "async":先拿到 job_id,再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。

写代码前,先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式,再把方案和大概花费讲给我确认。

请求参数

#
参数名位置类型必填默认值说明
Authorizationheaderstring是-Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。
platformbodystring是jd平台标识,固定值。
actionbodystring是search能力标识,固定值。
keywordbody.paramsstring是-京东商品搜索词;中文关键词通常更贴近站内商品标题。
pagebody.paramsinteger否-搜索结果的页码,整数;不传或传 1 就是第 1 页。取值范围是 1 到 150 ÷ limit(向上取整):limit 30 时 1–5,默认 limit 5 时 1–30,limit 10 时 1–15。用 page 时,每页条数就是这次请求的 limit(1–30)。每一页都按第 1 页的价收,只按这一页自己的条数分档,每 5 条算一次调用:limit 30 时每页 30 条算 6 次,limit 5 时每页算 1 次。用 page=N 直接跳到第 N 页,这一次按 N 页收,和一页页翻到第 N 页收得一样(前面 N − 1 页按整页算,加上第 N 页本身):limit 30、page 5 一次算 30 次调用。第 N 页没返回的条数对应的档退回;第 N 页是空的(比如列表没那么长),整次不扣费。page 超出范围、是 0、负数、小数、字符串(如 "2")或布尔值时,扣费前返回 422,不扣费。同步请求就能翻到最深那一页(第 150 条),不用加 "mode": "async"。最深那一页(limit 30 时是第 5 页)没有 next_page_token,pagination.stop_reason 为 depth_limit;列表本来就短、翻到头时为 end_of_list。第 1 页每次都现取。第 2 页起从一份保存下来的完整列表(最多 150 条)里按顺序切;第一次要第 2 页或更后面的页时,这份列表最多是一小时前的。用 page 直接要的页,从这份列表里按原位置切(第 N 页 = 列表里第 (N − 1) × limit + 1 条起的 limit 条)。它不知道你之前拿到的第 1 页是什么样,所以和单独取的第 1 页之间、或者跨了整点再要的页之间,可能有几件商品重复或缺漏,合并时按 item_id 去重。要一页不重复地读完整个列表,从第 1 页起跟着 next_page_token 翻。pagination.page 是这一页的页码;pagination.has_more 为 true 就还有下一页:接着传 page + 1,或把 next_page_token 作为 page_token 传回。page 和 page_token 同传时以 page_token 为准。按页码要到的页也会给 next_page_token,下一次带不带 page 都能用它。
page_tokenbody.paramsstring否-翻页令牌。第 1 页不用传;响应里有 next_page_token 时,把它原样作为 page_token 传回就拿下一页,其余参数保持不变。每页条数沿用拿到这个令牌的那次请求的 limit,之后改 limit 不起作用。也可以不用令牌,用 page 直接要第 N 页;page 和 page_token 同传时以 page_token 为准。令牌 24 小时内有效,只能用于同一组参数、同一个账户;换了参数会被拒(422,不扣费)。每一页都按第 1 页的价收,只按这一页自己的条数分档,每 5 条算一次调用:limit 30 时每页 30 条算 6 次,翻到第 5 页一共 5 页、30 次调用;limit 5 时每页算 1 次。没返回的条数对应的档退回,一条都没返回的空页(比如翻过了短列表的末页)不扣费。最多翻到第 150 条(limit 30 时是 5 页),同步请求就能翻到,不用加 "mode": "async"。第 150 条所在的那一页没有 next_page_token,pagination.stop_reason 为 depth_limit;列表本来就短、翻到头时为 end_of_list。第 1 页每次都现取。第 2 页起从一份保存下来的完整列表(最多 150 条)里按顺序切;第一次要第 2 页或更后面的页时,这份列表最多是一小时前的。用 page_token 从第 1 页一路翻下去,后面每一页都从同一份列表里切:第 1 页已经给过的商品不再出现,中间也不漏,所以各页之间没有重复的商品。翻得慢也一样,这条令牌链一直用它第一次到第 2 页时的那一份。pagination.page 是这一页的页码;pagination.has_more 为 true 就还有下一页,把 next_page_token 作为 page_token 传回。按页码要到的页也会给 next_page_token,下一次带不带 page 都能用它。
limitbody.paramsinteger (1–30)否5这次调用最多返回的条数,整数,1–30;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。

响应示例

#
2026年10月25日 02:28(北京时间)用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回,已隐去名字、账号、头像、主页链接、联系方式等个人信息,列表只保留前 2 条;id、billing、quota 每次调用都不同,只给结构。
json
{  "id": "req_…",  "platform": "jd",  "action": "search",  "results": [    {      "item_id": "10237497167004",      "url": "https://item.jd.com/10237497167004.html",      "title": "华为手机2026热销新机上市畅享 90 Plus 麒麟8系芯片丝滑超好用鸿蒙AI防诈6620mAh巨鲸大电池柔光护眼 星空黑【128GB】 官方标配【365天延保+蓝牙耳机+运费险】",      "price": 1999,      "currency": "CNY",      "shop_id": "219104371",      "shop_name": "迪旺手机专营店",      "shop_url": "https://mall.jd.com/index-219104371.html",      "category_ids": [        "9987",        "653",        "655"      ],      "image_url": "https://img14.360buyimg.com/n0/jfs/t1/547105/14/3627/77818/6ad1919eFd3fb2338/0083320320125c52.png",      "platform": "jd"    },    {      "item_id": "10230554159591",      "url": "https://item.jd.com/10230554159591.html",      "title": "华为mate60pro手机智能手机鸿蒙智能AI手机麒麟芯片正品国行mate60赠手机壳 Mate60Pro【雅川青】 12GB+256GB 7天试用(送手机壳88W充电器)",      "price": 2837,      "currency": "CNY",      "shop_id": "169276555",      "shop_name": "尊享数码手机拼购店",      "shop_url": "https://mall.jd.com/index-169276555.html",      "category_ids": [        "9987",        "653",        "655"      ],      "image_url": "https://img14.360buyimg.com/n0/jfs/t1/483100/15/10357/93091/6a647f40Ff1f84472/008332032085260d.jpg",      "platform": "jd"    }  ],  "next_page_token": …,  "pagination": { … },  "count": 5,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

返回字段

#

业务数据在 results 里;下表是每条记录可能包含的字段,平台没有提供的值不会被编造。

字段含义
item_id京东商品数字 ID;search 可把它直接交给详情、评价或价格能力。
url该记录在原平台上的可访问链接。
title标题。平台无标题概念时(如纯文本帖)为 null。
short_title京东返回的商品短标题。
price价格数值,不含货币符号;币种见 currency。
currency价格币种代码(如 CNY、USD)。price 存在但 currency 为 null 时不要假定币种。
sold_count搜索列表上显示的销量原文(search),是「10万+」这类文本、不是精确件数;可能缺省。
review_count搜索列表上显示的评价数原文(search),是文本、可能是约数,不是精确条数。
good_rate京东公开的好评率百分比。
shop_id京东店铺数字 ID。
shop_name公开店铺名称。
shop_url京东店铺公开页面。
is_jd_self是否为京东自营商品。
promotion商品列表中的促销标签。
sell_point商品列表中的公开卖点。
category_ids京东类目 ID 路径。
image_url图片链接:search、product_detail、shop、skus 里是商品主图(封面);description_images 里是这一行的那张详情图(京东图床的 https 原图)。
platform数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。

错误与计费

#
401
缺少 Key 或 Key 无效。
402
余额不足,先充值。
422
参数名或取值不对,按错误信息给的候选改;不扣费。
429
超过每分钟请求上限,按 Retry-After 等待后再试。
503
暂时无法完成,预扣的费用退回;结果未知时先核对,不要直接重发。
200 空结果
没有数据,不扣费。

错误码

常见问题

用英文关键词能搜吗?

能,但中文关键词通常更贴近京东站内的商品标题,命中更准。搜品牌加型号时,按商品标题里常见的写法填写,效果更好。

搜索结果怎么继续查详情和评价?

每条结果的 item_id 是京东商品数字 ID,直接传给京东的商品详情、评价或价格能力即可,不需要再拼商品链接。

怎么区分京东自营和第三方店铺?

看 is_jd_self,为真表示京东自营商品;店铺信息在 shop_name、shop_id 和 shop_url。比较价格和口碑时,把自营和第三方分开看更公平。

京东搜索接口返回哪些字段?

item_id、url、title、short_title、price、currency、sold_count、review_count、good_rate、shop_id、shop_name、shop_url、is_jd_self、promotion、sell_point、category_ids、image_url。

item_id 和 shop_id 要转成数字吗?

不要转。item_id、shop_id 和 category_ids 里的每一项都是字符串,按字符串存。

搜一页怎么收费?

按这一页返回的条数分档,每一档算一次调用,每次 $0.002472,每千次 $2.47;少返回的条数对应的档退回,空页不扣费。失败和空结果不收费。

同一把 Key 还能调用京东的其他能力。

Google Analytics 同意才加载 隐私