logo

Jumia 关键词商品搜索

按关键词获取各国站点的商品搜索列表,包含展示排名、价格、评分和商品链接。

发布者
价格
¥0.0035 / 条
最近更新
2026-11-10

概览

把商品搜索结果整理成可比较的清单,将搜索关键词、展示位置、当地价格和评价信息保存在同一行。研究一类商品时,可以直接观察搜索列表里出现了哪些品牌与型号,而不必逐条抄录页面。

同一商品可能出现在不同关键词的结果中。保留这种对应关系,有助于区分不同搜索意图下的商品覆盖,也方便把后续采集结果与本次清单做比较。

数据说明

数据来自公开商品搜索列表,保留采集时的默认展示顺序。搜索排名表示本次读取到的列表位置,包含推荐位,不代表销量;同一关键词内按商品去重,不同关键词独立保留。站点调整排序时,位置可能变化。

当前价格和划线价格均为列表展示值,使用当地币种,不能跨币种直接比较;划线价不是上次采集价,最终结算金额还可能受运费及优惠条件影响。未提供的数值记为 -1,文本留空,不能视为零价格或零评分。未发现官方店标记时表示未确认。

只覆盖公开可见商品,不包含登录后专属内容。采集时间采用世界协调时间,用于区分不同批次。

结果长什么样

每条记录表示一个关键词下的一件商品。

搜索关键词搜索排名商品名称当前价格币种平均评分
samsung1Galaxy A07 4G, 6.7", 64GB + 4GB RAM (Dual SIM), 5000mAh, Black (2YRs WRTY)14700.0KES4.4
samsung2Galaxy A06, 6.7", 4GB RAM+ 64GB (Dual SIM), 5000mAh, Black (1YR WRTY)13300.0KES4.2

结果还包含品牌、商品编号、商品图片、商品链接和采集时间。

应用场景

  • 商品覆盖研究:结合搜索关键词、品牌和商品名称,观察不同需求下有哪些商品出现。
  • 定价比较:在相同国家和币种内,按当前价格分组,再结合平均评分与评价数量筛选比较对象。
  • 展示位置观察:保存多次采集结果,通过记录标识、搜索排名和采集时间比较同一商品的位置变化。

适用边界

覆盖八个国家的公开商品搜索列表,最多 20 个关键词、每词最多 50 页且全次合计不超过 2000 条,不采详情、评论或登录后信息。

  • 适合用于
  • 需要按关键词收集商品列表,并比较展示位置、价格和评分。
  • 不要用于
  • 需要销售数量、付费广告归因、个性化排名、商品完整详情或历史价格。

失败处理

开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。

  1. 1要求验证码或拒绝访问时停止,不会将访问失败记为空结果;请确认运行环境能访问所选国家站点。
  2. 2页面结构变化或分页改变关键词时需要检查采集程序;无匹配商品时正常返回空结果。
  3. 3临时限流或连接超时可稍后重试,已写回的记录仍保留并计费;再次运行会重新采集。

输入参数

调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。

  • 国家站点country必填string(enum)
    选择要搜索的国家,结果价格保留当地币种。
    可选值埃及eg加纳gh科特迪瓦ci肯尼亚ke摩洛哥ma尼日利亚ng塞内加尔sn乌干达ug示例ke
  • 搜索关键词keywords必填array<string>
    每个词组作为一次独立搜索,最多 20 个;同一关键词内去重,不同关键词分别保留结果。每个词组最多 200 个字符。
    数量最多 20 项示例["samsung"]
  • 每个关键词最多返回条数max_results_per_keyword选填integer
    默认每个关键词最多返回 100 条,按站内默认顺序采集;每次运行合计最多 2000 条,每个关键词最多扫描 50 页。
    范围1–2000默认值100

输出数据

单条记录的字段结构,与 manifest.json 的 output.schema 同源。

  • 记录标识idstring
    由国家、关键词摘要和商品编号组合,同一关键词的同一商品重复采集时保持不变。
    示例ke:968e2d5b08687bf42997461c:325675454
  • 国家countrystring
    商品所属国家站点代码。
    示例ke
  • 搜索关键词keywordstring
    本条结果对应的关键词,去除首尾空白。
    示例samsung
  • 搜索排名rankinteger
    在采集到的列表中的展示位置,从 1 开始跨页累计;包含推荐位,去重后可能不连续,不代表销量排名。
    示例1

示例数据

以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。

output.example
{
  "id": "ke:968e2d5b08687bf42997461c:325675454",
  "country": "ke",
  "keyword": "samsung",
  "rank": 1,
  "page": 1,
  "product_id": "325675454",
  "sku": "SA948MP5POCTWNAFAMZ",
  "title": "Galaxy A07 4G, 6.7\", 64GB + 4GB RAM (Dual SIM), 5000mAh, Black (2YRs WRTY)",
  "brand": "Samsung",
  "price": 14700,
  "currency": "KES",
  "old_price": 18500,
  "discount_percent": 21,
  "rating": 4.4,
  "review_count": 249,
  "product_url": "https://www.jumia.co.ke/samsung-galaxy-a07-4g-6.7-64gb-4gb-ram-dual-sim-5000mah-black-2yrs-wrty-325675454.html",
  "image_url": "https://ke.jumia.is/unsafe/fit-in/520x520/filters:fill(white)/product/45/4576523/1.jpg?6869",
  "official_store": "yes",
  "scraped_at": "2026-11-10T08:36:42+00:00"
}

调用方式

本 Data App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 Data App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。

通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。选择你的客户端与认证方式,复制下方配置即可接入。

客户端配置

把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。

mcpServers 配置
{
  "mcpServers": {
    "bazhuayu_datahub": {
      "type": "http",
      "url": "https://mcp-v2.bazhuayu.com?pin=donglichun/jumia-keyword-search",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

让 AI 自己完成配置

不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。

如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。

价格

商品搜索结果

按实际成功返回的数据条数计费,任务失败不计费。

¥0.0035/ 条

多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。

立即体验

填写参数直接运行,结果来自真实调用。

示例
参数按 input.schema 校验后提交
¥0.0035 / 条