抖音巨量星图转化资源 API (V1)
GET
接口健康状态
健康 可用 少量可用 基本不可用 暂无数据
正在加载健康状态…
获取抖音巨量星图转化资源数据，包括与抖音星图创作者转化活动相关的商品，用于商业分析和活动优化。
请求参数
| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
token | query | string | 是 | - | 用户鉴权令牌。 |
oAuthorId | query | string | 是 | - | 作者唯一ID。 |
platform | query | string | 否 | SHORT_VIDEO | 平台类型。 可用值： - SHORT_VIDEO: 短视频- LIVE_STREAMING: 直播- PICTURE_TEXT: 图文- SHORT_DRAMA: 短剧 |
industryId | query | string | 否 | ALL | 行业分类。 可选值： - ALL: 不限- ELECTRONICS_AND_APPLIANCES: 3C及电器- SHOPPING: 购物- FOOD_AND_BEVERAGE: 食品饮料- CLOTHING_AND_ACCESSORIES: 服装配饰- HEALTHCARE_AND_MEDICAL: 医药健康- MEDICAL_INSTITUTIONS: 医疗机构- HOME_AND_BUILDING_MATERIALS: 家居建材- LOCAL_SERVICES: 生活服务- BUSINESS_SERVICES: 商务服务- CULTURE_SPORTS_ENTERTAINMENT: 休闲娱乐- BEAUTY_SERVICES: 丽人- REAL_ESTATE: 房地产- EDUCATION_AND_TRAINING: 教育培训- TRAVEL_AND_TOURISM: 出行旅游- PUBLIC_SERVICES: 社会公共- GAMES: 游戏- RETAIL: 互联网电商服务- TRANSPORTATION_EQUIPMENT: 交通工具- AUTOMOTIVE: 汽车- AGRICULTURE_FORESTRY_FISHERY: 农资园艺- CHEMICAL_AND_ENERGY: 化工能源- ELECTRONICS_AND_ELECTRICAL: 电子电工- MACHINERY_EQUIPMENT: 机械设备- MEDIA_AND_INFORMATION: 传媒资讯- LOGISTICS: 物流- TELECOMMUNICATIONS: 通信- FINANCIAL_SERVICES: 金融业- CATERING_SERVICES: 餐饮服务- SOFTWARE_TOOLS: 工具类软件- FRANCHISING_AND_INVESTMENT: 招商加盟- BEAUTY_AND_COSMETICS: 美妆- MOTHER_BABY_AND_PET: 母婴宠物- DAILY_CHEMICALS: 日化- PHYSICAL_BOOKS: 实体书籍- SOCIAL_AND_COMMUNICATION: 社交通讯- CULTURAL_SUPPLIES: 文化用品- SPORTS_OUTDOOR: 运动户外 |
range | query | string | 否 | DAY_30 | 时间范围。 可用值： - DAY_30：最近 30 天- DAY_90：最近 90 天 |
detailType | query | string | 否 | VIDEO | 资源类型。 可用值： - VIDEO: 视频- PRODUCT: 商品 |
page | query | integer | 否 | 1 | 页码。 |
代码示例
💡 环境说明
默认使用 https://api.justoneapi.com；中国大陆用户也可以改用 http://47.117.133.51:30015。
bash
curl -X GET "https://api.justoneapi.com/api/douyin-xingtu/gw/api/data_sp/get_author_convert_videos_or_products/v1?token=YOUR_API_KEY&oAuthorId=VALUE"text
我想使用 Just One API 提供的“转化资源 (V1)”接口。
接入地址: 默认使用 https://api.justoneapi.com；中国大陆用户也可以改用 http://47.117.133.51:30015。
接口路径: /api/douyin-xingtu/gw/api/data_sp/get_author_convert_videos_or_products/v1?token=YOUR_API_KEY&oAuthorId=VALUE
接口地址: BASE_URL + /api/douyin-xingtu/gw/api/data_sp/get_author_convert_videos_or_products/v1?token=YOUR_API_KEY&oAuthorId=VALUE
HTTP 方法: GET
身份验证: 在 URL 中传入 token 查询参数。
OpenAPI 定义: https://docs.justoneapi.com/openapi/douyin-creator-marketplace-xingtu/conversion-resources-v1-zh.json
请求参数说明:
- token (query): 用户鉴权令牌。 (必填)
- oAuthorId (query): 作者唯一ID。 (必填)
- platform (query): 平台类型。
可用值：
- `SHORT_VIDEO`: 短视频
- `LIVE_STREAMING`: 直播
- `PICTURE_TEXT`: 图文
- `SHORT_DRAMA`: 短剧
- industryId (query): 行业分类。
可选值：
- `ALL`: 不限
- `ELECTRONICS_AND_APPLIANCES`: 3C及电器
- `SHOPPING`: 购物
- `FOOD_AND_BEVERAGE`: 食品饮料
- `CLOTHING_AND_ACCESSORIES`: 服装配饰
- `HEALTHCARE_AND_MEDICAL`: 医药健康
- `MEDICAL_INSTITUTIONS`: 医疗机构
- `HOME_AND_BUILDING_MATERIALS`: 家居建材
- `LOCAL_SERVICES`: 生活服务
- `BUSINESS_SERVICES`: 商务服务
- `CULTURE_SPORTS_ENTERTAINMENT`: 休闲娱乐
- `BEAUTY_SERVICES`: 丽人
- `REAL_ESTATE`: 房地产
- `EDUCATION_AND_TRAINING`: 教育培训
- `TRAVEL_AND_TOURISM`: 出行旅游
- `PUBLIC_SERVICES`: 社会公共
- `GAMES`: 游戏
- `RETAIL`: 互联网电商服务
- `TRANSPORTATION_EQUIPMENT`: 交通工具
- `AUTOMOTIVE`: 汽车
- `AGRICULTURE_FORESTRY_FISHERY`: 农资园艺
- `CHEMICAL_AND_ENERGY`: 化工能源
- `ELECTRONICS_AND_ELECTRICAL`: 电子电工
- `MACHINERY_EQUIPMENT`: 机械设备
- `MEDIA_AND_INFORMATION`: 传媒资讯
- `LOGISTICS`: 物流
- `TELECOMMUNICATIONS`: 通信
- `FINANCIAL_SERVICES`: 金融业
- `CATERING_SERVICES`: 餐饮服务
- `SOFTWARE_TOOLS`: 工具类软件
- `FRANCHISING_AND_INVESTMENT`: 招商加盟
- `BEAUTY_AND_COSMETICS`: 美妆
- `MOTHER_BABY_AND_PET`: 母婴宠物
- `DAILY_CHEMICALS`: 日化
- `PHYSICAL_BOOKS`: 实体书籍
- `SOCIAL_AND_COMMUNICATION`: 社交通讯
- `CULTURAL_SUPPLIES`: 文化用品
- `SPORTS_OUTDOOR`: 运动户外
- range (query): 时间范围。
可用值：
- `DAY_30`：最近 30 天
- `DAY_90`：最近 90 天
- detailType (query): 资源类型。
可用值：
- `VIDEO`: 视频
- `PRODUCT`: 商品
- page (query): 页码。
返回格式: JSON
响应处理与错误码：
1. 需通过返回体中的 "code" 字段判断业务结果（code 为 0 表示成功）。
2. 超时建议：建议将请求超时时间设置为 120 秒；如果 120 秒偏长，请至少设置为 60 秒，但可能会有少量请求因超时而未接收到结果。
3. 业务码说明：
- 0: 成功
- 100: Token 无效或已失效
- 301: 采集失败，请重试
- 302: 超出速率限制
- 303: 超出每日配额
- 400: 参数错误
- 500: 内部服务器错误
- 600: 权限不足
- 601: 账户余额不足
- 602: TOKEN 限额超限
4. code 601 表示账户共享余额不足。code 602 表示当前 API TOKEN 自身的累计消费上限已达到。TOKEN 限额不是资金划拨，多个 TOKEN 仍共享同一个账户余额。
请帮我用我擅长的编程语言写一个脚本来调用这个接口，并处理返回结果。python
import requests
BASE_URL = "https://api.justoneapi.com" # 大陆用户可改为 "http://47.117.133.51:30015"
url = BASE_URL + "/api/douyin-xingtu/gw/api/data_sp/get_author_convert_videos_or_products/v1?token=YOUR_API_KEY&oAuthorId=VALUE"
response = requests.get(url)
print(response.json())js
const BASE_URL = "https://api.justoneapi.com"; // 大陆用户可改为 "http://47.117.133.51:30015"
const url = BASE_URL + "/api/douyin-xingtu/gw/api/data_sp/get_author_convert_videos_or_products/v1?token=YOUR_API_KEY&oAuthorId=VALUE";
const response = await fetch(url, {
method: "GET"
});
const data = await response.json();
console.log(data);java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
final String BASE_URL = "https://api.justoneapi.com"; // 大陆用户可改为 "http://47.117.133.51:30015"
final String url = BASE_URL + "/api/douyin-xingtu/gw/api/data_sp/get_author_convert_videos_or_products/v1?token=YOUR_API_KEY&oAuthorId=VALUE";
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}go
package main
import (
"fmt"
"io"
"net/http"
)
const BASE_URL = "https://api.justoneapi.com" // 大陆用户可改为 "http://47.117.133.51:30015"
func main() {
client := &http.Client{}
url := BASE_URL + "/api/douyin-xingtu/gw/api/data_sp/get_author_convert_videos_or_products/v1?token=YOUR_API_KEY&oAuthorId=VALUE"
req, _ := http.NewRequest("GET", url, nil)
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}php
<?php
$BASE_URL = "https://api.justoneapi.com"; // 大陆用户可改为 "http://47.117.133.51:30015"
$url = $BASE_URL . "/api/douyin-xingtu/gw/api/data_sp/get_author_convert_videos_or_products/v1?token=YOUR_API_KEY&oAuthorId=VALUE";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;响应结果示例
正在加载最新成功示例…