万有引擎
搜索⌘K
中文
登录免费开始

电商数据 · 数据 API

Shopee

Shopee API

搜索 Shopee 商品，按店铺整理商品列表，并查看单品规格、库存和店铺相关信息；结合商品与店铺标识核对对象，评分计数仅作为单品字段返回。 调用 POST /api/v1/social ；返回结构化 JSON，$1.39 / 千次；失败不计费。

免费开始 看文档

4

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Shopee 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordcountry, max_price, min_price, sort默认 20 · 最多 100同步$1.39 / 千次shop_id · item_id · name · url · image_url · price · original_price · discount_pct · currency · rating · rating_scale · rating_count · sold_count · location · is_mall · platform
profileurlcountry—同步$1.39 / 千次shop_id · item_id · name · url · description · price · price_min · price_max · original_price · discount_pct · currency · rating · rating_scale · rating_count · sold_count · stock · liked_count · view_count · brand · is_pre_order · has_video · platform · images · shop
shopshopcountry默认 20 · 最多 100同步$1.39 / 千次shop_id · item_id · name · url · image_url · price · original_price · discount_pct · currency · rating · rating_scale · rating_count · sold_count · location · is_mall · platform
product_detailurlcountry—同步$1.39 / 千次id · url · name · text · price · original_price · currency · discount · stock · sold_count · rating · rating_scale · review_count · shop_name · shop_location · variants · image_url · platform

Shopee 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

怎么调用 Shopee 主页或对象详情 API？

profile

使用 platform="shopee"、action="profile" 调用“主页或对象详情”能力；返回单个对象，主要包含 shop_id、item_id、name、url、description、price 等 24 个字段。

Shopee profile 的参数分别是什么意思？

url必填
Shopee 商品完整链接，路径需含 i.店铺ID.商品ID；短链需先取得落地页地址，不能保证直接解析。

Shopee 卖家教育资料分别介绍 Shop ID、Item ID、用户名和店铺展示名，提醒读者不要混用这些标识。此处引用术语，不承诺其他地区的后台操作步骤相同。官方来源：Shopee：查找店铺与商品 ID来源核查：

country可选
商品所属商城地区代码，支持 id/sg/my/th/ph/vn/br/tw/mx/co/cl；显式值优先于 URL 域名推断，需与链接所属市场一致。
查看全部 11 个允许值

brclcoidmxmyphsgthtwvn

Shopee 特有返回字段与含义（12）
item_id
商品 ID。
original_price
原价。
discount_pct
折扣百分比。
sold_count
销量。
shop_id
店铺 ID。
brand
品牌。
price_min
多规格价格下限。
price_max
多规格价格上限。
stock
库存。
liked_count
商品被收藏数。
is_pre_order
是否为预售。
has_video
是否有视频。

怎么调用 Shopee 店铺资料 API？

shop

使用 platform="shopee"、action="shop" 调用“店铺资料”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 shop_id、item_id、name、url、image_url、price 等 16 个字段。

Shopee shop 的参数分别是什么意思？

shop必填
店铺用户名或数字 shop ID，可带 @；返回店内商品列表，不是店铺评论。

Shopee 将登录使用的 username 与买家看到的 Shop Name 分别说明；店铺展示名可以含空格，不能直接替代本参数要求的用户名或店铺 ID。官方来源：Shopee：用户名与店铺展示名的区别来源核查：

country可选
店铺所属商城地区代码，支持 id/sg/my/th/ph/vn/br/tw/mx/co/cl；未指定时默认 id。
查看全部 11 个允许值

brclcoidmxmyphsgthtwvn

Shopee 特有返回字段与含义（6）
item_id
商品 ID。
original_price
原价。
discount_pct
折扣百分比。
sold_count
销量。
is_mall
是否为 Shopee Mall 官方店。东南亚电商里辨真假货的第一信号。
shop_id
店铺 ID。

怎么调用 Shopee 商品详情 API？

product_detail

使用 platform="shopee"、action="product_detail" 调用“商品详情”能力；返回单个对象，主要包含 id、url、name、text、price、original_price 等 18 个字段。

Shopee product_detail 的参数分别是什么意思？

url必填
Shopee 商品完整链接，支持标准 i.店铺ID.商品ID 或 /product/店铺ID/商品ID 路径；不是店铺主页。

Shopee 卖家教育资料区分 Shop ID、Item ID、username 和店铺展示名。EveryInfra product_detail 使用完整商品 URL 定位条目是自身适配方式；该来源不证明所有国家站 URL、地区 country 值、变体或商品字段均可解析。官方来源：Shopee：Shop ID、Item ID 与商品定位来源核查：

country可选
可选商城覆盖值，支持 br/id/th/my/sg/ph/vn/mx；通常应省略并由商品 URL 自动识别。
查看全部 8 个允许值

bridmxmyphsgthvn

Shopee 特有返回字段与含义（7）
original_price
原价。
sold_count
销量。
stock
库存。
discount
折扣说明。
variants
规格变体。
shop_name
店铺名。
shop_location
店铺所在地。跨境店和本地店的物流时效差很多。
Shopee search 调用流程一次 Shopee search 调用的全过程：向 POST /api/v1/social 发送 platform="shopee"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 shop_id、item_id、name、url、image_url 等字段；返回列表，单次最多 100 条，计费 $1.39 / 千次，失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "shopee"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表shop_iditem_idnameurlimage_url
一次 Shopee search 调用的全过程：向 POST /api/v1/social 发送 platform="shopee"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 shop_id、item_id、name、url、image_url 等字段；返回列表，单次最多 100 条，计费 $1.39 / 千次，失败与空结果不计费。

Shopee 原始字段名

EveryInfra 统一字段名

左边是 Shopee 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名，减少重复适配； 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

Shopee 的独有字段名（当前目录）

全站 89 个平台的当前目录中，这 5 个字段名只在 Shopee 出现。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

  • is_mall
  • liked_count
  • is_pre_order
  • shop
  • shop_location

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/api/v1/social/fields

shop_id
店铺 ID。
item_id
商品 ID。
name
名称。用于账号/商品/商家类能力，指该对象本身的名字。
url
该记录在原平台上的可访问链接。
image_url
图片链接。多图能力可能返回 image_urls 数组。
price
价格数值，不含货币符号；币种见 currency。
original_price
原价。
discount_pct
折扣百分比。
currency
价格币种代码（如 CNY、USD）。price 存在但 currency 为 null 时不要假定币种。
rating
评分。分制随平台而异，同一行的 rating_scale 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。
rating_scale
上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
rating_count
参与评分的人数。null 表示不公开，不等于 0。
sold_count
销量。
location
地理位置描述，原文透传，格式随平台而异。
is_mall
是否为 Shopee Mall 官方店。东南亚电商里辨真假货的第一信号。
platform
数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
description
简介或描述，通常比 text 短。
price_min
多规格价格下限。
price_max
多规格价格上限。
stock
库存。
liked_count
商品被收藏数。
view_count
浏览/播放数。null 表示不公开，不等于 0。
brand
品牌。
is_pre_order
是否为预售。
has_video
是否有视频。
id
该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
text
正文内容，已去除 HTML 标签。长文可能被截断。
discount
折扣说明。
review_count
评价条数，用于商品/商家类能力。null 表示不公开，不等于 0。
shop_name
店铺名。
shop_location
店铺所在地。跨境店和本地店的物流时效差很多。
variants
规格变体。

当前目录另列出 images · shop，这些字段尚无逐项释义；请先核对 Shopee 对应接口的用例与实际响应，不按字段名猜测类型或含义。

请求填写示例

检索商品；站点市场决定商品价格语境，不等于 API 钱包币种。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

shopee_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"shopee","action":"search","params":{"keyword":"wireless mouse"}}'

记录字段预览（非真实响应）

仅展示 search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "shop_id": null,
  "item_id": null,
  "name": null,
  "url": null,
  "image_url": null,
  "price": null,
  "original_price": null,
  "discount_pct": null,
  "currency": null,
  "rating": null,
  "rating_scale": null,
  "rating_count": null,
  "sold_count": null,
  "location": null,
  "is_mall": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

Shopee 商品搜索 API 如何用 country、价格区间和 sort 选品？

用 search 找商品，区分相关性、销量相关与价格排序的用途。

查看 search 的 sort 参数 →
  • sort=popular 表示销量相关排序；结合 shop_id、item_id、price、currency 与 sold_count 阅读，而不是把它当作评论热度。
  • country 选择商城地区，支持 id/sg/my/th/ph/vn/br/tw/mx/co/cl，未传时默认 id（印度尼西亚）。不将不同地区的价格直接比较，也不把 sold_count 换算成 GMV。

用店铺与商品 ID 定位 Shopee 单品

用 profile 读取商品详情，确保链接指向正确店铺和商品。

查看 profile 的 url 参数 →
  • url 使用包含 i.店铺ID.商品ID 的完整商品链接，结合 shop_id、item_id、price_min、price_max 与 stock 核对目标商品。
  • 短链先转为落地页地址；profile 不是用户主页，价格区间和库存信息也不保证覆盖全部规格。

按 Shopee 店铺读取商品列表

用 shop 观察指定店铺的商品，而不是查询店铺评论或粉丝名单。

查看 shop 的 shop 参数 →
  • shop 填店铺用户名或数字 shop ID，不是带空格的店铺展示名；按 shop_id、item_id、name 与 is_mall 整理结果。
  • 返回条目是商品，is_mall 是结果中的商城标记，不是 EveryInfra 背书；当前没有公开 reviews action，不从评分数量推断可以取得评论正文。

读取 Shopee 商品变体与评分数量

用 product_detail 获取商品规格和店铺相关信息，补充单品比较。

查看 product_detail 的 country 参数 →
  • url 使用完整商品链接，country 应与目标商城一致；结合 id、variants、stock、review_count 与 shop_name 阅读。
  • review_count 是数量，不是评论正文；此路径不包含评论，且与 profile 的 item_id、description 字段不能直接混用。

Shopee API 常见问题

Shopee API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="shopee"、action 和 params。以 search 为例，必填 keyword，可选 country、max_price、min_price、sort。检索商品；站点市场决定商品价格语境，不等于 API 钱包币种。 Shopee 共 4 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Shopee API 怎么收费？

$1.39 / 千次，Shopee 全部 4 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 719 次 Shopee 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

Shopee API 一次能返回多少条数据？

Shopee 有 2 个列表接口，包括 search、shop。其余 2 个接口返回单个对象；对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

Shopee API 返回哪些字段？

当前目录为 search 列出 shop_id、item_id、name、url、image_url、price 等 16 个字段名。按全站当前目录统计，5 个字段名只在 Shopee 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

Shopee 商品搜索 API 如何用 country、价格区间和 sort 选品？

用 search 找商品，区分相关性、销量相关与价格排序的用途。 sort=popular 表示销量相关排序；结合 shop_id、item_id、price、currency 与 sold_count 阅读，而不是把它当作评论热度。 country 选择商城地区，支持 id/sg/my/th/ph/vn/br/tw/mx/co/cl，未传时默认 id（印度尼西亚）。不将不同地区的价格直接比较，也不把 sold_count 换算成 GMV。

「用店铺与商品 ID 定位 Shopee 单品」怎样接入 Shopee API？

用 profile 读取商品详情，确保链接指向正确店铺和商品。 url 使用包含 i.店铺ID.商品ID 的完整商品链接，结合 shop_id、item_id、price_min、price_max 与 stock 核对目标商品。 短链先转为落地页地址；profile 不是用户主页，价格区间和库存信息也不保证覆盖全部规格。

「按 Shopee 店铺读取商品列表」怎样接入 Shopee API？

用 shop 观察指定店铺的商品，而不是查询店铺评论或粉丝名单。 shop 填店铺用户名或数字 shop ID，不是带空格的店铺展示名；按 shop_id、item_id、name 与 is_mall 整理结果。 返回条目是商品，is_mall 是结果中的商城标记，不是 EveryInfra 背书；当前没有公开 reviews action，不从评分数量推断可以取得评论正文。

「读取 Shopee 商品变体与评分数量」怎样接入 Shopee API？

用 product_detail 获取商品规格和店铺相关信息，补充单品比较。 url 使用完整商品链接，country 应与目标商城一致；结合 id、variants、stock、review_count 与 shop_name 阅读。 review_count 是数量，不是评论正文；此路径不包含评论，且与 profile 的 item_id、description 字段不能直接混用。

可以先免费试用 Shopee API 吗？

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 Shopee 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 4 个能力。无需信用卡。

更多电商数据 API

1688 API速卖通 APIAmazon APICraigslist API得物 Dewu APIeBay APIEtsy API京东 JD.com API全部 89 平台 ↗

开始调用 Shopee API

加微信领 $1 免费额度，先选一个 Shopee 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始