# temu_api **Repository Path**: chaojie/temu_api ## Basic Information - **Project Name**: temu_api - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-11-29 - **Last Updated**: 2025-11-29 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ## 如果这个项目让你有所收获，记得 Star 关注哦，这对我是非常不错的鼓励与支持。 # temu_api temu 开发者sdk temu api ```shell pip install temu_api ``` ## 模块说明 ### 1. Auth 认证模块 ```python 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 订单模块 ```python 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 价格模块 ```python 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 活动模块 ```python 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 商品模块 ```python 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 物流模块 ```python 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 售后模块 ```python 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 广告模块 ```python 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. 安装依赖： ```bash pip install -r requirements.txt ``` 2. 运行测试脚本（以 auth 和 order 为例）： ```bash python tests/test_auth.py python tests/test_order.py ``` ### tests/test_auth.py 示例 ```python 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 示例 ```python 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 目录下的源码。