SORFTIME API · 全量数据接口

把跨境数据
接进你自己的系统

用代码向 Sorftime 取数,返回结构化 JSON。适合要自建数据平台、 做竞品监控系统、或把跨境数据嵌进自有产品的团队。 按调用量计费,一次购买全接口可用。

全接口可用按量计费赠送专用积分支持企业定制
小问号
接入前你要知道
  • 鉴权走 HttpHeader:BasicAuth + Account-SK
  • 先判 Code = 0 再取值,别直接读数据
  • 字段名不是标准英文,以官方字段表为准
💡 只是想查数据、要结论?那用 MCP 更快,不用写代码。
L1 · 认识它

给你的程序,开一个取数窗口

API 是一组用代码调用的取数地址。你的程序发一个请求过去,Sorftime 返回一段结构化 JSON。

卖家 & 运营场景

MCP

对话即用,不用写代码

  • 用法:在 AI 对话框说需求
  • 适合:查数据、要分析结论
  • 上手最快,10 分钟能用
系统 & 集成场景

API

面向开发与数据团队

  • 用法:程序调用,自己处理鉴权 / 分页 / 重试
  • 适合:接进自建 SaaS、后台、BI 看板
  • 调用量大时更稳、更省事
什么时候该上 API:① 调用量很大(每天几万次以上); ② 要把数据接进自己的 SaaS / 后台 / BI 看板;③ 需要企业级稳定性与定制字段。 用量不大的话,用 CLI 更省事。
L1 · 能干什么

典型用法与四大数据板块

📊

自建数据看板

把关注的类目、竞品数据定时拉进自己的 BI 工具,做成团队内部的运营看板。

🚨

竞品监控系统

监控竞品的价格、排名、销量变化,异动时自动告警,接入企业微信 / 钉钉。

🧮

自有工具集成

你有自己的选品工具或服务?把 Sorftime 数据作为底层能力嵌进去。

产品

详情、趋势、子体、评论、流量词

市场

类目大盘、竞争格局、头部集中度

达人

达人带货表现、合作品牌

视频

热门带货视频、视频商品关联

专业版能看到的数据,API 侧基本都能取;部分更深层端点(如类目树全量、历史评论库)仅开放数据侧。

L1 · 接入

接入四步

代码示例可直接点击复制,把 Account-SK 换成你自己的就能跑。

1

注册并拿到 Account-SK

通过官方入口注册后,在「购买开通」页复制 Account-SK。

2

按参数结构发起请求

统一风格:端点名 + JSON 参数 + 站点代码。

3

先判 Code 再取值

Code = 0 才是成功,非 0 是业务异常。

4

做好限流与重试

请求之间留间隔,失败请求做有限次重试。

开放平台:Account-SK、剩余次数与鉴权示例代码
图①:Account-SK 就在这里;下方「权限认证」区块给出了 Java / C# / Python / Node.js / curl 五种语言的调用示例,直接照着改。 前往官方入口 →

鉴权:所有接口都需要设置 HttpHeader

curlcurl -X POST "https://standardapi.sorftime.com/api/你的端点" \ -H "Content-Type: application/json;charset=UTF-8" \ -H "Authorization: BasicAuth 你的AccountSK" \ -d '{"asin":"B08N5WRWNW","domain":1}'

请求参数结构(以查询单个产品为例)

// 端点名 + 业务参数 + 站点代码
{
  "endpoint": "ProductRequest",
  "asin":     "B08N5WRWNW",
  "domain":   1          // 1 = Amazon 美国站
}

// 站点代码与 CLI 完全一致:
// Amazon 1–14 / Shopee 201–208 / Walmart 21 / Temu 701 / 1688 601 / TikTok 301–312
企业级定制:如果你需要专属并发、字段定制或私有化对接,请提前告知顾问,我们会给你并发建议与方案。
L1 · 最容易踩的坑

判返回、认字段:新手最常栽的两个地方

① 响应体里先看 Code

响应里有一个状态字段:Code = 0 表示成功;非 0 表示业务异常。 先判 Code 再取值,是接入时的必要习惯。

Code = 0

成功,正常读取业务数据。

Code = 11

翻页超出范围,没有更多数据了——不是出错,是到底了。

Code = 97

异步任务进行中(评论采集、榜单采集),需要轮询状态,最长约 90 秒。

401 / 404

多为站点代码(domain)填错或 Key 不合法,先查这两个再怀疑接口。

② 字段名不是标准英文,别凭直觉猜

例如「价格」是 SalesPrice、「月销量」是 ListingSalesVolumeOfMonth。 请以官方字段表为准,接错了不会报错,只会静默返回空值。

字段别名表:官方文档里提供了跨平台字段对照。同一含义在 Amazon / Shopee / Walmart 上命名不同, 做多平台聚合时务必先对照,别用一套字段名硬套所有平台。

③ 第三方请求示例

# Python 示例(requests)
import requests

url = "https://standardapi.sorftime.com/api/ProductRequest"
headers = {
    "Content-Type": "application/json;charset=UTF-8",
    "Authorization": "BasicAuth 你的AccountSK",
}
payload = {"asin": "B08N5WRWNW", "domain": 1}

r = requests.post(url, json=payload, headers=headers, timeout=30)
data = r.json()
if data.get("Code") == 0:      # 先判 Code 再取值
    print(data.get("Data"))
else:
    print("业务异常:", data.get("Code"), data.get("Message"))
L2 · 用好

费用与额度

「一次」怎么算?

一次 = 一次接口调用。异步接口因为要轮询状态,会消耗多次。

买一次能用多久?

资源包购买后 1 年有效,按调用量扣减,用不完不过期那么快。

赠送的积分是什么?

高金额档位会赠送专用积分,用于部分高阶能力,与 Request 分开计算。

在哪对账?

官网「充值·使用记录」,可按平台 / 站点 / 任务筛选每一笔。

充值记录与 Request 使用记录列表
图②:每一笔调用消耗多少、花在哪个平台哪个站点,都能逐条对账。 查看记录 →
🛠 API 档位明细(与 CLI 同表) 去开放平台开通 API →
购买金额Request 数赠送专用积分并发限制有效期
¥39.9 特惠购买购买 →1,3000100 QPM购买后 1 年
¥500购买 →6,5000200 QPM购买后 1 年
¥998购买 →13,9000200 QPM购买后 1 年
¥2,980购买 →46,8001,000200 QPM购买后 1 年
¥5,988购买 →120,0003,000200 QPM购买后 1 年
¥16,888购买 →420,00010,000200 QPM购买后 1 年
¥27,688购买 →695,00050,000200 QPM购买后 1 年
¥56,888购买 →1,470,000100,000200 QPM购买后 1 年
📌 API 用于系统集成与批量取数,资源包按量购买、长期有效(1 年);开发 / 数据团队常见选择。 去开放平台开通 / 购买 →
常见问题

关于 API,你可能想问

我需要请开发同学吗?

如果你的用量不大、只是想把数据导出来,用 CLI 就够了,不必专门招人。 只有当数据要接进自建系统、做成产品时,才需要开发参与。

按量计费,会不会算错?

每一笔调用都能在官网「充值·使用记录」逐条查到(可按平台、站点、任务筛选)。 先判 Code 再取值也能帮你避免把失败请求当成功数据用。

支持哪些语言?

接口本身与语言无关——只要能发 HTTP 请求就行。官方文档提供 Java / C# / Python / Node.js / curl 五种示例。

数据多久更新一次?

不同数据的更新频率不一样,具体以官方文档说明为准。做监控类应用时,建议先用小批量验证更新节奏再放大。

价格 · 购买

先把接口跑通,再按用量选档位

API 不提供免费试用。先用官方文档验证鉴权与返回结构,再按调用量购买。

✓
🛠 API
当前页 · 系统集成与批量取数
按调用量购买 · 一次购买全接口可用
  • 全量数据接口,可编程批量调用
  • 资源包 ¥39.9 起 · 按量购买 · 1 年有效
  • 适合自建报表 / 看板 / 内部系统
去开放平台开通 →
⌨️ CLI
用量不大、想省事选这个
🎁 新用户可领 CLI 7 天 100 次试用
  • 终端一条命令批量取数 / 定时任务
  • 不用写代码,命令直接跑
  • CLI 专享连续包月 ¥99 / 月
了解 CLI →
🤖 MCP
不做系统、只想让 AI 帮你查
🎁 新用户可领 MCP 7 天 200 次试用
  • 把数据交给 AI,说人话就出分析
  • 新客首购 ¥39.9(1,300 次 / 1 年)
  • 不需要任何开发资源
了解 MCP →
不知道选哪个?一句话判断:只想随手查、要结论 → MCP;要批量跑、要定时任务 → CLI; 要接进自己的系统、用量很大 → API。三者数据同源,同一账号可随时补购或升级。

以上价格与权益以 Sorftime 官方最新公布为准。

扫码加入 Sorftime 卖家交流群

我是 Jennifer,你的跨境好帮手

接口联调卡住、想确认并发策略、需要企业定制——都可以直接找我,我帮你对接技术同学。

扫码进群 · 领取试用 / 咨询开通

💗 💙 💛 💚 💗 🧡
感谢您!❤️ 520 笔芯
比心送给每一位信任我的卖家朋友

六种方式用的是同一份数据,差别只在「你打算怎么用」。 不确定?回首页做一次 30 秒选型,或看 完整对比表。