官方 Python SDK，用于访问 Just One API。
Just One API 是一个统一的数据服务平台，提供来自社交媒体、电商和内容平台的结构化数据。
支持的平台包括淘宝、天猫、小红书、小红书蒲公英、抖音、抖音星图、快手、微博、哔哩哔哩、京东、微信、豆瓣、TikTok、TikTok Shop、优酷、Instagram、YouTube、Reddit、头条、知乎、亚马逊、Facebook、X(Twitter)、贝壳、IMDb 等接口。想了解更多，可以访问官网。
文档中心支持查看接口健康状态、版本化 API 路径、请求参数以及各平台的使用提示。
控制台提供 API 令牌管理、余额展示、接口调用记录、调用量趋势和消费金额分析。
pip install justoneapifrom justoneapi import JustOneAPIClient
client = JustOneAPIClient(token="your_token")
# 示例：搜索抖音视频
response = client.douyin.search_video_v4(keyword="deepseek")
print(response.success) # 仅当 code == 0 时为 True
print(response.code) # 服务端返回的业务码
print(response.message) # 服务端消息
print(response.data) # 实际业务数据每个 API 方法都会返回一个 ApiResponse 对象，包含以下字段：
| 字段 | 类型 | 说明 |
|---|---|---|
success |
bool |
仅当 code == 0 时为 True。 |
code |
Any |
服务端返回的业务码。 |
message |
str |
服务端消息。 |
data |
Any |
API 返回的业务数据。 |
raw_json |
dict |
SDK 处理前的完整 JSON 响应。 |
默认情况下，业务失败不会抛异常，你可以通过 response.success、response.code 和 response.message 自行判断。
如果你希望业务失败时直接抛异常：
from justoneapi import JustOneAPIClient, BusinessError
client = JustOneAPIClient(
token="your_token",
raise_on_business_error=True,
)
try:
response = client.douyin.search_video_v4(keyword="deepseek")
except BusinessError as exc:
print(exc.response.code)
print(exc.response.message)所有 API 请求都需要有效的 API Token。
注册链接：
完整接口文档：
文档中包含：
- 请求参数说明
- 返回字段说明
- 错误码说明
- 各平台调用示例
如果你有任何问题、反馈或合作需求：
完整请求参数和响应说明请以在线接口文档为准。
- 商品详情 (V1)
- 商品详情 (V2)
- 商品详情 (V4)
- 商品详情 (V5)
- 商品详情 (V9)
- 商品评价 (V3)
- 店铺商品列表 (V1)
- 店铺商品列表 (V2)
- 店铺商品列表 (V3)
- 商品搜索 (V1)
- 用户资料 (V3)
- 用户资料 (V4)（已弃用）
- 用户发布笔记 (V2)（已弃用）
- 用户发布笔记 (V4)
- 笔记详情 (V1)
- 笔记详情 (V3)（已弃用）
- 笔记详情 (V7)（已弃用）
- 笔记评论 (V2)
- 笔记评论 (V4)
- 评论回复 (V2)
- 笔记搜索 (V2)
- 笔记搜索 (V3)
- 用户搜索 (V2)
- 分享链接解析 (V3)
- 关键词建议 (V1)
- 创作者资料 (V1)
- 数据摘要 (V1)
- 粉丝增长历史 (V1)
- 粉丝摘要 (V1)
- 相似创作者 (V1)
- 创作者特征标签 (V1)
- 创作者内容标签 (V1)
- 笔记表现指标 (V1)
- 用户发布笔记 (V1)
- 粉丝分布 (V1)
- 成本效益分析 (V1)
- 笔记详情 (V1)
- 创作者搜索 (V1)
- 创作者核心指标 (V1)
- 创作者资料 (V1)（已弃用）
- 笔记表现指标 (V1)（已弃用）
- 粉丝分布 (V1)（已弃用）
- 粉丝摘要 (V1)（已弃用）
- 粉丝增长历史 (V1)（已弃用）
- 创作者笔记列表 (V1)
- 数据摘要 (V2)（已弃用）
- 成本效益分析 (V1)（已弃用）
- 笔记详情 (V1)（已弃用）
- 创作者核心指标 (V1)（已弃用）
- 创作者资料 (V1)
- 创作者链接结构 (V1)
- 创作者可见性状态 (V1)
- 创作者渠道指标 (V1)
- 创作者订单经验 (V1)
- 创作者链接指标 (V1)
- 视频分布 (V1)
- 受众分布 (V1)
- 营销指标 (V1)
- 传播指标 (V1)
- 转化分析 (V1)
- 展示商品 (V1)
- 转化资源 (V1)
- 性价比分析 (V1)
- 受众触点分布 (V1)
- 推荐视频 (V1)
- 粉丝分布 (V1)
- 创作者搜索 (V1)
- 商品报告趋势 (V1)
- 商品报告详情 (V1)
- 商品报告分析 (V1)
- KOL 评论关键词分析 (V1)
- 粉丝增长趋势 (V1)
- KOL 内容关键词分析 (V1)
- 作者商业传播信息 (V1)
- 作者商业种草基础信息 (V1)
- 创作者资料 (V1)（已弃用）
- 受众分布 (V1)（已弃用）
- 粉丝分布 (V1)（已弃用）
- 营销指标 (V1)（已弃用）
- 传播指标 (V1)（已弃用）
- KOL 关键词搜索 (V1)
- 转化分析 (V1)（已弃用）
- 展示商品 (V1)（已弃用）
- 创作者链接指标 (V1)（已弃用）
- 转化资源 (V1)（已弃用）
- 创作者链接结构 (V1)（已弃用）
- 受众触点分布 (V1)（已弃用）
- 性价比分析 (V1)（已弃用）
- 推荐视频 (V1)（已弃用）
- 粉丝增长趋势 (V1)（已弃用）
- KOL 评论关键词分析 (V1)（已弃用）
- KOL 内容关键词分析 (V1)（已弃用）
- 作者商业传播信息 (V1)（已弃用）
- 作者商业种草基础信息 (V1)（已弃用）
- 视频详情 (V1)（已弃用）
- 关键词搜索 (V2)
- 帖子详情 (V1)
- 用户资料 (V3)
- 用户粉丝 (V1)
- 用户关注者 (V1)
- 用户发布帖子 (V1)
- 用户视频列表 (V1)
- 电视视频详情 (V1)
- 热搜 (V1)
- 帖子评论 (V1)
- 搜索用户发布帖子 (V1)
- 发行预期 (V1)
- 扩展详情 (V1)
- 主要演员和工作人员 (V1)
- 基本信息 (V1)
- Redux概览 (V1)
- '你知道吗'洞察 (V1)
- 影评人评论摘要 (V1)
- 奖项摘要 (V1)
- 用户评价摘要 (V1)
- 剧情摘要 (V1)
- 贡献问题 (V1)
- 详情 (V1)
- 票房摘要 (V1)
- 推荐 (V1)
- 关键词搜索 (V1)
- 流媒体精选 (V1)
- 分类新闻 (V1)
- 榜单排名 (V1)
- 原产国 (V1)
本项目基于 MIT License 发布。