怎么调用 京东 JD.com 关键词搜索 API?
search使用 platform="jd"、action="search" 调用“关键词搜索”能力;返回列表,默认 5 条、单次最多 30 条,主要包含 item_id、url、title、short_title、price、currency 等 18 个字段。
keyword 是商品搜索词;目前固定一页,最多 25 条。
{ "platform": "jd", "action": "search", "params": { "keyword": "华为手机" } }
京东 JD.com search 的参数分别是什么意思?
keyword必填- 京东商品搜索词;中文关键词通常更贴近站内商品标题。
京东官方开放平台资料说明联盟商品接口可按 SKU ID 或关键词查询,并返回商品名称、主图、类目、价格、物流与自营等信息。该资料属于需相应接入条件的官方接口语境,只用于解释 keyword、SKU 与商品对象,不证明任意网页访问权限、EveryInfra 结果完整性或本站字段逐项等同。官方来源:京东宙斯/京东联盟:商品关键词与 SKU 查询对象来源核查:
page可选- 搜索结果的页码,整数;不传或传 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可选- 翻页令牌。第 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 都能用它。
京东 JD.com 返回字段与含义(13)
item_id- 京东商品数字 ID;search 可把它直接交给详情、评价或价格能力。
short_title- 京东返回的商品短标题。
shop_id- 京东店铺数字 ID。
shop_name- 公开店铺名称。
shop_url- 京东店铺公开页面。
good_rate- 京东公开的好评率百分比。
is_jd_self- 是否为京东自营商品。
promotion- 商品列表中的促销标签。
sell_point- 商品列表中的公开卖点。
category_ids- 京东类目 ID 路径。
sold_count- 搜索列表上显示的销量原文(search),是「10万+」这类文本、不是精确件数;可能缺省。
review_count- 搜索列表上显示的评价数原文(search),是文本、可能是约数,不是精确条数。
image_url- 图片链接:search、product_detail、shop、skus 里是商品主图(封面);description_images 里是这一行的那张详情图(京东图床的 https 原图)。