电商数据 · 数据 API

Temu

Temu API

Temu API 提供商品关键词搜索与产品详情查询功能。 调用 POST /api/v1/social ;返回结构化 JSON,$1.39 / 千次;失败不计费。

2

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Temu 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordsort默认 40 · 最多 100同步$1.39 / 千次product_id · title · url · price · original_price · discount_pct · currency · rating · rating_scale · review_count · sold_count · sold_text · shop_id · image_url · platform
profileurlproduct_url—同步$1.39 / 千次product_id · title · url · price · original_price · discount_pct · currency · rating · rating_scale · review_count · sold_count · sold_text · shop_name · category · keywords · description · shipping · availability · in_stock · free_shipping · is_trending · image_url · images · options · platform

Temu 每个接口分别做什么

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

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

怎么调用 Temu 主页或对象详情 API?

profile

使用 platform="temu"、action="profile" 调用“主页或对象详情”能力;返回单个对象,主要包含 product_id、title、url、price、original_price、discount_pct 等 25 个字段。

Temu profile 的参数分别是什么意思?

url必填
profile 需要 url。接受完整商品链接、goods.html?goods_id=...、-g-ID.html 或纯数字商品 ID。有效 ID 也可能没有数据。

Temu 提醒消费者核对商品图片、描述、商家评分和配送信息,并通过官方交易渠道付款。本接口的资料和汇总计数不等于商品鉴真、商家认证或购物授权,也不能替代最终商品页。官方来源:Temu:核对商品描述、商家信息与交易入口来源核查:

product_url可选
url 的商品链接兼容输入,优先级低于 url;公开接口仍要求 url。
Temu 特有返回字段与含义(13)
product_id
商品 ID。
original_price
原价。
discount_pct
折扣百分比。
sold_count
销量数值。
sold_text
销量展示文本(如 "10K+ sold"),是区间不是精确值。
images
商品页实际返回的图片列表,可能不完整。
options
选项名称、属性及其图片。仅供展示,不是平台 SKU 标识,也不含各选项的价格或库存。
in_stock
是否有货。
availability
库存状态。
free_shipping
是否包邮。
shipping
配送说明。
is_trending
是否为趋势商品。
shop_name
店铺名。
Temu search 调用流程一次 Temu search 调用的全过程:向 POST /api/v1/social 发送 platform="temu"、action="search",以及必填参数 keyword;返回结构化 JSON,含 product_id、title、url、price、original_price 等字段;返回列表,单次最多 100 条,计费 $1.39 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "temu"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表product_idtitleurlpriceoriginal_price
一次 Temu search 调用的全过程:向 POST /api/v1/social 发送 platform="temu"、action="search",以及必填参数 keyword;返回结构化 JSON,含 product_id、title、url、price、original_price 等字段;返回列表,单次最多 100 条,计费 $1.39 / 千次,失败与空结果不计费。

Temu 原始字段名

EveryInfra 统一字段名

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

Temu 的独有字段名(当前目录)

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

  • sold_text
  • is_trending
  • options

返回字段含义

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

product_id
商品 ID。
title
标题。平台无标题概念时(如纯文本帖)为 null。
url
该记录在原平台上的可访问链接。
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 时出现。
review_count
评价条数,用于商品/商家类能力。null 表示不公开,不等于 0。
sold_count
销量数值。
sold_text
销量展示文本(如 "10K+ sold"),是区间不是精确值。
shop_id
店铺 ID。
image_url
图片链接。多图能力可能返回 image_urls 数组。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
shop_name
店铺名。
category
分类名称,取值为原平台的分类体系,未做跨平台归一。
description
简介或描述,通常比 text 短。
shipping
配送说明。
availability
库存状态。
in_stock
是否有货。
free_shipping
是否包邮。
is_trending
是否为趋势商品。
images
商品页实际返回的图片列表,可能不完整。
options
选项名称、属性及其图片。仅供展示,不是平台 SKU 标识,也不含各选项的价格或库存。

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

请求填写示例

这里只演示商品检索词,不表示当前线上供给已经实测可用。

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

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

记录字段预览(非真实响应)

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

fields.preview.json
{
  "product_id": null,
  "title": null,
  "url": null,
  "price": null,
  "original_price": null,
  "discount_pct": null,
  "currency": null,
  "rating": null,
  "rating_scale": null,
  "review_count": null,
  "sold_count": null,
  "sold_text": null,
  "shop_id": null,
  "image_url": null,
  "platform": null
}

常见用例

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

关键词搜索用例

输入关键词获取匹配商品列表。

查看 search 的 keyword 参数 →
  • 支持指定关键词、排序(相关性/热门/最新/价格升序/降序)和数量限制。输出结果包含产品ID、标题、URL、价格及货币。异步模式下返回job_id和轮询URL,轮询不重新提交任务,无分页。

搜索结果到详情用例

使用URL获取产品详细属性。

查看 profile 的 url 参数 →
  • profile 需要 url。接受完整商品链接、goods.html?goods_id=...、-g-ID.html 或纯数字商品 ID。有效 ID 也可能没有数据。
  • 商品页实际返回的图片列表,可能不完整。

显示选项图片用例

选项名称、属性及其图片。

查看 profile 的 url 参数 →
  • 仅供展示,不是平台 SKU 标识,也不含各选项的价格或库存。

Temu API 常见问题

Temu API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="temu"、action 和 params。以 search 为例,必填 keyword,可选 sort。这里只演示商品检索词,不表示当前线上供给已经实测可用。 Temu 共 2 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Temu API 怎么收费?

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

Temu API 一次能返回多少条数据?

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

Temu API 返回哪些字段?

当前目录为 search 列出 product_id、title、url、price、original_price、discount_pct 等 15 个字段名。按全站当前目录统计,3 个字段名只在 Temu 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

「关键词搜索用例」怎样接入 Temu API?

输入关键词获取匹配商品列表。 支持指定关键词、排序(相关性/热门/最新/价格升序/降序)和数量限制。输出结果包含产品ID、标题、URL、价格及货币。异步模式下返回job_id和轮询URL,轮询不重新提交任务,无分页。

「搜索结果到详情用例」怎样接入 Temu API?

使用URL获取产品详细属性。 profile 需要 url。接受完整商品链接、goods.html?goods_id=...、-g-ID.html 或纯数字商品 ID。有效 ID 也可能没有数据。 商品页实际返回的图片列表,可能不完整。

「显示选项图片用例」怎样接入 Temu API?

选项名称、属性及其图片。 仅供展示,不是平台 SKU 标识,也不含各选项的价格或库存。

可以先免费试用 Temu API 吗?

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

开始调用 Temu API

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

免费开始