京东 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请求
POST /api/v1/social { "platform": "jd", "action": "search", "params": { "keyword": "华为手机" } }2JSON 响应
{ "results": [ { "item_id": "10237497167004", "title": "华为手机2026热销新机上市畅享 90 Plus 麒麟8系芯片丝滑超好用鸿蒙AI防诈6620mAh巨鲸大电池柔光护眼 星空黑【128GB】 官方标配【365天延保+蓝牙耳机+运费险】", "price": 1999, "currency": "CNY" }, … ], "count": 5 }3行
item_id title price currency 10237497167004 华为手机2026热销新机上市畅享 90 Plus 麒麟8系芯片丝滑超好用鸿蒙AI防诈6620mAh巨鲸大电池柔光护眼 星空黑【128GB】 官方标配【365天延保+蓝牙耳机+运费险】 1999 CNY 10230554159591 华为mate60pro手机智能手机鸿蒙智能AI手机麒麟芯片正品国行mate60赠手机壳 Mate60Pro【雅川青】 12GB+256GB 7天试用(送手机壳88W充电器) 2837 CNY 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_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 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 10237497167004 | https://item.jd.com/10237497167004.html | 华为手机2026热销新机上市畅享 90 Plus 麒麟8系芯片丝滑超好用鸿蒙AI防诈6620mAh巨鲸大电池柔光护眼 星空黑【128GB】 官方标配【365天延保+蓝牙耳机+运费险】 | null | 1999 | CNY | null | null | null | 219104371 | 迪旺手机专营店 | https://mall.jd.com/index-219104371.html | null | null | null | ["9987","653","655"] | https://img14.360buyimg.com/n0/jfs/t1/547105/14/3627/77818/6ad1919eFd3fb2338/0083320320125c52.png | jd |
| 10230554159591 | https://item.jd.com/10230554159591.html | 华为mate60pro手机智能手机鸿蒙智能AI手机麒麟芯片正品国行mate60赠手机壳 Mate60Pro【雅川青】 12GB+256GB 7天试用(送手机壳88W充电器) | null | 2837 | CNY | null | null | null | 169276555 | 尊享数码手机拼购店 | https://mall.jd.com/index-169276555.html | null | null | null | ["9987","653","655"] | https://img14.360buyimg.com/n0/jfs/t1/483100/15/10357/93091/6a647f40Ff1f84472/008332032085260d.jpg | jd |
用途
选品初筛
搜一个品类词,用
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 |
合计按每次调用的标价算。
代码示例
#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 助手。
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 等待后重试。
写代码前,先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式,再把方案和大概花费讲给我确认。请求参数
#| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
Authorization | header | string | 是 | - | Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。 |
platform | body | string | 是 | jd | 平台标识,固定值。 |
action | body | string | 是 | search | 能力标识,固定值。 |
keyword | body.params | string | 是 | - | 京东商品搜索词;中文关键词通常更贴近站内商品标题。 |
page | body.params | integer | 否 | - | 搜索结果的页码,整数;不传或传 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_token | body.params | string | 否 | - | 翻页令牌。第 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 都能用它。 |
limit | body.params | integer (1–30) | 否 | 5 | 这次调用最多返回的条数,整数,1–30;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。 |
响应示例
#{ "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;少返回的条数对应的档退回,空页不扣费。失败和空结果不收费。
相关的 京东 JD.com 能力
同一把 Key 还能调用京东的其他能力。
- 商品详情
product_detail每千次 $2.44商品详情:返回单个对象;主要字段 item_id、url、title、price、price_display、price_masked。 - 评价
reviews每千次 $8评价:返回列表,默认 10 条、单次最多 10 条;主要字段 id、item_id、text、review_append、rating、rating_scale。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 店铺资料
shop每千次 $28.81店铺资料:返回列表,默认 24 条、单次最多 60 条;主要字段 item_id、url、title、price、currency、shop_id。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页按这一页的条数计费,每 24 条算一次调用;最深 168 条。 - 商品价格
product_price每千次 $5.56商品价格:返回单个对象;主要字段 item_id、url、price、currency、available、unavailable_reason。 - 全部 SKU 与价格
skus每千次 $2.44全部 SKU 与价格:返回列表。每个 SKU 一行,第一行是请求里的那个(is_requested 为 true),其后是京东为它列出的其他颜色、尺码或容量;每行各有 properties(规格)、price、on_sale、in_stock、stock_state、stock。price 是京东对未登录买家展示的价格,不含结算时才使用的优惠券,不是券后到手价。每返回一个 SKU 算一次调用:按 limit(1–100,默认 100)先扣,没返回的当场退回;只能同步调用。 - 商品介绍详情图
description_images每千次 $8商品介绍详情图:返回列表。每张图一行,按「商品介绍」从上到下排:position 从 1 开始,image_url 是京东图床的 https 原图,image_count 是这次一共返回几张。主图与图集在 product_detail 的 image_urls,product_detail 不含详情图;商品没有详情图时按空结果退款。