Just One API - Python SDK
官方 Python SDK，用于访问 Just One API。
Just One API 是一个统一的数据服务平台，提供来自社交媒体、电商和内容平台的结构化数据。
支持的平台包括淘宝、天猫、小红书、小红书蒲公英、抖音、抖音星图、快手、微博、哔哩哔哩、京东、微信、豆瓣、TikTok、TikTok Shop、优酷、Instagram、YouTube、Reddit、头条、知乎、亚马逊、Facebook、X(Twitter)、贝壳、IMDb 等接口。想了解更多，可以访问官网。
系统概览
文档中心支持查看接口健康状态、版本化 API 路径、请求参数以及各平台的使用提示。
控制台提供 API 令牌管理、余额展示、接口调用记录、调用量趋势和消费金额分析。
安装
pip install justoneapi
快速开始
from 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)
- 商品详情 (V3)
- 商品详情 (V4)
- 商品详情 (V5)
- 商品详情 (V6)
- 商品详情 (V7)
- 商品详情 (V9)
- 商品评价 (V3)
- 商品问答 (V1)
- 店铺商品列表 (V1)
- 店铺商品列表 (V2)
- 店铺商品列表 (V3)（已弃用）
- 店铺商品列表 (V4)
- 商品销量 (V1)（已弃用）
- 商品搜索 (V1)
小红书
- Ask Dots AI
- 热搜 (V1)
- 热门榜单 (V1)
- 笔记搜索 (V1)
- 笔记搜索 (V2)
- 笔记搜索 (V3)
- 笔记搜索 (V4)
- 用户搜索 (V2)
- 用户发布笔记 (V1)
- 用户发布笔记 (V2)
- 用户发布笔记 (V3)
- 用户发布笔记 (V4)
- 笔记详情 (V1)
- 笔记详情 (V2)
- 笔记详情 (V3)
- 笔记详情 (V4)
- 笔记详情 (V5)
- 笔记详情 (V6)
- 笔记详情 (V7)（已弃用）
- 笔记评论 (V2)
- 笔记评论 (V3)
- 笔记评论 (V4)
- 评论回复 (V2)
- 用户资料 (V3)
- 用户资料 (V4)
- 关键词建议 (V1)
- 话题笔记列表 (V1)
- 分享链接解析 (V1)
小红书电商 (RedNote)
小红书蒲公英
- 创作者搜索 (V1)
- 创作者资料 (V1)
- 数据摘要 (V1)
- 粉丝增长历史 (V1)
- 粉丝摘要 (V1)
- 相似创作者 (V1)
- 创作者特征标签 (V1)
- 创作者内容标签 (V1)
- 笔记表现指标 (V1)
- 粉丝分布 (V1)
- 成本效益分析 (V1)
- 笔记详情 (V1)
- 创作者核心指标 (V1)
- 内容广场笔记 (V1)
- 创作者资料 (V1)（已弃用）
- 笔记表现指标 (V1)（已弃用）
- 粉丝分布 (V1)（已弃用）
- 粉丝摘要 (V1)（已弃用）
- 粉丝增长历史 (V1)（已弃用）
- 创作者笔记列表 (V1)
- 创作者笔记列表 Pro (V1)
- 数据摘要 (V2)（已弃用）
- 成本效益分析 (V1)（已弃用）
- 笔记详情 (V1)（已弃用）
- 创作者核心指标 (V1)（已弃用）
抖音
- 视频搜索 (V1)
- 视频搜索 (V4)
- 图片帖子搜索 (V1)
- 热搜 (V1)
- 用户搜索 (V2)
- 用户发布视频 (V1)
- 用户发布视频 (V3)
- 视频详情 (V2)
- 视频评论 (V1)
- 评论回复 (V1)
- 用户资料 (V3)
- 分享链接解析 (V1)
抖音电商
抖音巨量星图
- 创作者搜索 (V1)
- 创作者资料 (V1)
- 创作者链接结构 (V1)
- 创作者可见性状态 (V1)
- 创作者渠道指标 (V1)
- 创作者订单经验 (V1)
- 创作者链接指标 (V1)
- 视频分布 (V1)
- 受众分布 (V1)
- 营销指标 (V1)
- 传播指标 (V1)
- 转化分析 (V1)
- 展示商品 (V1)
- 转化资源 (V1)
- 性价比分析 (V1)
- 受众触点分布 (V1)
- 推荐视频 (V1)
- 粉丝分布 (V1)
- 创作者搜索轻量版 (V1)（已弃用）
- 商品报告趋势 (V1)
- 视频详情 (V1)
- 商品报告分析 (V1)
- 评论关键词分析 (V1)
- 粉丝增长趋势 (V1)
- 内容关键词分析 (V1)
- 创作者名片 (V1)
- 创作者带货传播信息 (V1)
- 创作者主页视频 (V1)
- 创作者标签 (V1)
- 创作者侧基础信息 (V1)
- 直播统计 (V1)
- 直播观看分布 (V1)
- 带货种草基础信息 (V1)
- 创作者合约基础信息
- 创作者资料 (V1)（已弃用）
- 受众分布 (V1)（已弃用）
- 粉丝分布 (V1)（已弃用）
- 营销指标 (V1)（已弃用）
- 传播指标 (V1)（已弃用）
- 转化分析 (V1)（已弃用）
- 展示商品 (V1)（已弃用）
- 创作者链接指标 (V1)（已弃用）
- 转化资源 (V1)（已弃用）
- 创作者链接结构 (V1)（已弃用）
- 受众触点分布 (V1)（已弃用）
- 性价比分析 (V1)（已弃用）
- 推荐视频 (V1)（已弃用）
- 粉丝增长趋势 (V1)（已弃用）
- 评论关键词分析 (V1)（已弃用）
- 内容关键词分析 (V1)（已弃用）
- 创作者带货传播信息 (V1)（已弃用）
- 带货种草基础信息 (V1)（已弃用）
- 视频详情 (V1)（已弃用）
快手
微信公众号
- 账号今日文章 (V1)（已弃用）
- 账号历史文章 (V1)（已弃用）
- 账号历史文章 (V2)
- 文章指标 (V1)
- 文章指标 (V2)
- 文章详情 (V1)
- 文章详情 (V2)
- 文章详情 (V3)
- 文章详情 (V4)
- 文章详情 (V5)
- 文章评论 (V1)
- 文章评论回复 (V1)
- 热门文章搜索 (V1)（已弃用）
- 文章搜索 (V1)
- 文章搜索 (V2)
- 小程序搜索 (V1)
- 微信指数搜索 (V1)
- 搜索建议 (V1)
- 账号搜索 (V1)
- 账号搜索 (V2)
- 账号原创文章数 (V1)
- 账号主体信息 (V1)
- 账号基本信息 (V1)
- 文章链接转换 (V1)
微信视频号
- 视频搜索 (V1)
- 视频搜索 (V2)
- 账号搜索 (V1)
- 账号搜索 (V2)
- 账号搜索 (V3)
- 账号视频 (V1)
- 获取绑定频道 (V1)
- 视频基本信息 (V1)
- 视频标题 (V1)
- 导出ID转换 (V1)
- 视频下载链接 (V1)
- 视频指标 (V1)
- 视频评论 (V1)
- 视频子评论 (V1)
QQ互选创作者市场
微博
- 关键词搜索 (V2)
- 帖子详情 (V1)
- 用户资料 (V3)
- 用户粉丝 (V1)
- 用户关注者 (V1)
- 用户发布帖子 (V1)
- 用户视频列表 (V1)
- 电视视频详情 (V1)
- 热搜 (V1)
- 帖子评论 (V1)
- 搜索用户发布帖子 (V1)
哔哩哔哩
得物（毒）
京东
- 商品详情 (V1)
- 商品详情 (V2)
- 商品详情 (V3)
- 商品详情 (V4)
- 商品价格 (V1)
- 商品搜索 (V1)
- 商品搜索 (V2)
- 商品评论 (V1)
- 商品评论 (V2)
- 店铺商品列表 (V1)
闲鱼
1688
Temu
Shopee
- 商品详情 (V1)
- 店铺资料与评分摘要 (V1)
- 商品详情 (V2)
- 店铺商品列表 (V1)
- 商品SKU矩阵 (V1)
- 店铺基本资料 (V1)
- 商品搜索 (V1)
- 商品SKU型号 (V1)
- 店铺详情 (V1)
- 丰富店铺评价 (V1)
- 商品展示快照 (V1)
- 店铺评价 (V1)
- 商品评价 (V1)
- 店铺分类 (V1)
- 商品评价模型分布 (V1)
- 商品评价标签 (V1)
- 搜索分类筛选 (V1)
- 商品分期与金额 (V1)
豆瓣电影
TikTok
TikTok Shop
优酷
YouTube
今日头条
知乎
- 专栏文章详情 (V1)
- 回答列表 (V1)
- 关键词搜索 (V1)
- 专栏文章列表 (V1)
- 用户信息 (V1)
- 用户关注 (V1)
- 用户关注者 (V1)
- 用户文章 (V1)
- 用户收录文章 (V1)
- 用户关注专栏 (V1)
- 用户关注问题 (V1)
- 用户关注收藏夹 (V1)
- 用户关注话题 (V1)
- 回答评论 (V1)
- 评论回复 (V1)
亚马逊
领英
贝壳
IMDb
- 发行预期 (V1)
- 扩展详情 (V1)
- 主要演员和工作人员 (V1)
- 基本信息 (V1)
- Redux概览 (V1)
- '你知道吗'洞察 (V1)
- 影评人评论摘要 (V1)
- 奖项摘要 (V1)
- 用户评价摘要 (V1)
- 剧情摘要 (V1)
- 贡献问题 (V1)
- 详情 (V1)
- 票房摘要 (V1)
- 推荐 (V1)
- 关键词搜索 (V1)
- 流媒体精选 (V1)
- 分类新闻 (V1)
- 榜单排名 (V1)
- 原产国 (V1)
LLM
许可证
本项目基于 MIT License 发布。
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
justoneapi-3.0.65.tar.gz
(94.4 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file justoneapi-3.0.65.tar.gz.
File metadata
- Download URL: justoneapi-3.0.65.tar.gz
- Upload date:
- Size: 94.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4ca15520fb5dd6cfb30a02d1184c371d489882d5c67510baa85dd21da3b25abf
|
|
| MD5 |
f976cbe1d9cd857145365fac1c0b999c
|
|
| BLAKE2b-256 |
e2f82d7c9e90b551e56e8d2f6292c1873f27b425c067948778493453118a88ca
|
Provenance
The following attestation bundles were made for justoneapi-3.0.65.tar.gz:
Publisher:
release.yml on justoneapi/justoneapi-python
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
justoneapi-3.0.65.tar.gz -
Subject digest:
4ca15520fb5dd6cfb30a02d1184c371d489882d5c67510baa85dd21da3b25abf - Sigstore transparency entry: 2680570315
- Sigstore integration time:
-
Permalink:
justoneapi/justoneapi-python@c75cca500b98724be2c03461b17e75485ce98af9 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/justoneapi
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@c75cca500b98724be2c03461b17e75485ce98af9 -
Trigger Event:
repository_dispatch
-
Statement type:
File details
Details for the file justoneapi-3.0.65-py3-none-any.whl.
File metadata
- Download URL: justoneapi-3.0.65-py3-none-any.whl
- Upload date:
- Size: 97.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d0f00ef7088bcd8eeea59617b2e8f34304c918a9efdc999929e9b8134903c7e6
|
|
| MD5 |
d28667f3a8af91ff8aa3ad5b41c5aef8
|
|
| BLAKE2b-256 |
148b956a72a977427c141635863d5e774760990234fc9f83111736b5a46943fe
|
Provenance
The following attestation bundles were made for justoneapi-3.0.65-py3-none-any.whl:
Publisher:
release.yml on justoneapi/justoneapi-python
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
justoneapi-3.0.65-py3-none-any.whl -
Subject digest:
d0f00ef7088bcd8eeea59617b2e8f34304c918a9efdc999929e9b8134903c7e6 - Sigstore transparency entry: 2680570374
- Sigstore integration time:
-
Permalink:
justoneapi/justoneapi-python@c75cca500b98724be2c03461b17e75485ce98af9 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/justoneapi
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@c75cca500b98724be2c03461b17e75485ce98af9 -
Trigger Event:
repository_dispatch
-
Statement type:
