temu-api 0.2.1

temu 开发者sdk temu api

temu_api

temu 开发者sdk temu api

pip install temu_api

模块说明

1. Auth 认证模块

from temu_api import TemuClient

APP_KEY = 'your_app_key'
APP_SECRET = 'your_app_secret'
ACCESS_TOKEN = 'your_access_token'
BASE_URL = 'https://openapi-b-us.temu.com'

temu_client = TemuClient(APP_KEY, APP_SECRET, ACCESS_TOKEN, BASE_URL)

# 获取当前 access_token 的权限信息
res = temu_client.auth.get_access_token_info()
print(res)

# 创建 access_token（授权回调）
res = temu_client.auth.create_access_token_info()
print(res)

• get_access_token_info(**kwargs)：获取当前 access_token 的 API 权限列表。
• create_access_token_info(**kwargs)：通过授权回调获取 access_token。

2. Order 订单模块

from temu_api import TemuClient

APP_KEY = 'your_app_key'
APP_SECRET = 'your_app_secret'
ACCESS_TOKEN = 'your_access_token'
BASE_URL = 'https://openapi-b-us.temu.com'

temu_client = TemuClient(APP_KEY, APP_SECRET, ACCESS_TOKEN, BASE_URL)

# 批量获取订单列表
res = temu_client.order.list_orders_v2()
print('list_orders_v2', res)

# 获取订单详情
res = temu_client.order.detail_order_v2(parent_order_sn='PO-211-00822146499192890')
print('detail_order_v2', res)

# 获取订单收货地址
res = temu_client.order.shippinginfo_order_v2(parent_order_sn='PO-211-00822146499192890')
print('shippinginfo_order_v2', res)

# 获取可合并发货的父订单分组
res = temu_client.order.combinedshipment_list_order()
print('combinedshipment_list_order', res)

# 批量获取订单定制商品内容
res = temu_client.order.customization_order(order_sn_list=['xxx', 'yyy'])
print('customization_order', res)

# 获取订单敏感收货地址
res = temu_client.order.decryptshippinginfo_order(parent_order_sn='PO-211-20063653668472890')
print('decryptshippinginfo_order', res)

• list_orders_v2(...)：批量获取订单列表，支持多种筛选参数。
• detail_order_v2(parent_order_sn, ...)：获取指定父订单的详细信息。
• shippinginfo_order_v2(parent_order_sn, ...)：获取指定父订单的收货地址信息。
• combinedshipment_list_order(...)：获取可合并发货的父订单分组。
• customization_order(order_sn_list, ...)：批量获取订单定制商品内容信息。
• decryptshippinginfo_order(parent_order_sn, ...)：获取指定父订单的敏感收货地址信息。

3. Price 价格模块

from temu_api import TemuClient

temu_client = TemuClient(APP_KEY, APP_SECRET, ACCESS_TOKEN, BASE_URL)

# 查询商品推荐供货价
res = temu_client.price.recommended_price_query(
    recommended_price_type=10,  # 10-低流量，20-限流
    goods_id_list=[123456789],
    language="zh-CN"
)
print('recommended_price_query', res)

# 查询定价单列表
res = temu_client.price.priceorder_query(page=1, size=10)
print('priceorder_query', res)

• recommended_price_query(...)：查询商品推荐供货价。
• priceorder_query(...)：查询定价单列表。

4. Promotion 活动模块

from temu_api import TemuClient

temu_client = TemuClient(APP_KEY, APP_SECRET, ACCESS_TOKEN, BASE_URL)

# 查询本地活动列表
res = temu_client.promotion.activity_query(page_number=1, page_size=10, activity_type=2)
print('activity_query', res)

# 报名活动商品
enroll_goods = {
    "goodsId": 123456,
    "enrollSkuList": [
        {"skuId": 654321, "activitySupplierPrice": 100, "activityQuantity": 10}
    ]
}
res = temu_client.promotion.activity_goods_enroll(activity_id=1100000022644, enroll_goods=enroll_goods)
print('activity_goods_enroll', res)

• activity_query(...)：查询本地活动列表。
• activity_goods_enroll(...)：报名活动商品。

5. Product 商品模块

from temu_api import TemuClient

temu_client = TemuClient(APP_KEY, APP_SECRET, ACCESS_TOKEN, BASE_URL)

# 删除商品
res = temu_client.product.delete_goods(goods_id=123456789)
print('delete_goods', res)

# 查询商品SKU列表
res = temu_client.product.sku_list_retrieve(goods_id_list=[123456789], page_size=10)
print('sku_list_retrieve', res)

• delete_goods(goods_id, ...)：删除商品。
• sku_list_retrieve(goods_id_list, ...)：查询商品SKU列表。

6. Logistics 物流模块

from temu_api import TemuClient

temu_client = TemuClient(APP_KEY, APP_SECRET, ACCESS_TOKEN, BASE_URL)

# 获取仓库信息
res = temu_client.logistics.warehouse_list()
print('warehouse_list', res)

# 获取区域物流公司
res = temu_client.logistics.companies(region_id=211)
print('companies', res)

• warehouse_list()：获取仓库信息。
• companies(region_id, ...)：获取区域物流公司。

7. Aftersales 售后模块

from temu_api import TemuClient

temu_client = TemuClient(APP_KEY, APP_SECRET, ACCESS_TOKEN, BASE_URL)

# 查询售后服务请求列表
res = temu_client.aftersales.aftersales_list(parent_after_sales_sn_list=['PO-128-01453433636470441'])
print('aftersales_list', res)

• aftersales_list(parent_after_sales_sn_list, ...)：查询售后服务请求列表。

8. Ads 广告模块

from temu_api import TemuClient

temu_client = TemuClient(APP_KEY, APP_SECRET, ACCESS_TOKEN, BASE_URL)

# 广告ROAS预测
res = temu_client.ads.roas_pred(goods_info_list=[{"goodsId": 123456789}])
print('roas_pred', res)

# 创建广告
create_ad_reqs = [{"roas": 2.0, "goodsId": 123456789, "budget": 1000}]
res = temu_client.ads.ad_create(create_ad_reqs=create_ad_reqs)
print('ad_create', res)

• roas_pred(goods_info_list, ...)：广告ROAS预测。
• ad_create(create_ad_reqs, ...)：创建广告。

---

如需更多用法和参数说明，请参考源码注释及各模块的 docstring。

测试用例说明

本项目自带简单的接口测试用例，位于 tests 目录下。

运行测试

1. 安装依赖：

pip install -r requirements.txt

2. 运行测试脚本（以 auth 和 order 为例）：

python tests/test_auth.py
python tests/test_order.py

tests/test_auth.py 示例

from temu_api import TemuClient

temu_client = TemuClient(APP_KEY, APP_SECRET, ACCESS_TOKEN, BASE_URL)
res = temu_client.auth.get_access_token_info()
print(res)
res = temu_client.auth.create_access_token_info()
print(res)

tests/test_order.py 示例

from temu_api import TemuClient

temu_client = TemuClient(APP_KEY, APP_SECRET, ACCESS_TOKEN, BASE_URL)
res = temu_client.order.list_orders_v2()
# 写入 json 文件
import json
with open('order_list.json', 'w', encoding='utf-8') as f:
    json.dump(res, f, ensure_ascii=False, indent=2)
print(res)
# 其它接口调用见源码

如需自定义参数或更多接口测试，请参考 tests 目录下的源码。