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) JSON
- 商品详情 (V2)
- 商品详情 (V3) JSON
- 商品详情 (V4) JSON
- 商品详情 (V5) JSON
- 商品详情 (V6) JSON
- 商品详情 (V7)（已弃用） JSON
- 商品详情 (V8)
- 商品详情 (V9) JSON
- 商品评价 (V3) JSON
- 商品问答 (V1) JSON
- 店铺商品列表 (V1) JSON
- 店铺商品列表 (V2) JSON
- 店铺商品列表 (V3)
- 店铺商品列表 (V4) JSON
- 商品销量 (V1)（已弃用）
- 商品搜索 (V1) JSON
- 商品搜索 (V2) JSON
小红书
- Ask Dots AI JSON
- 热搜 (V1) JSON
- 热门榜单 (V1)
- 热门灵感信息流 (V1) JSON
- 笔记搜索 (V1)
- 关键词笔记搜索 (V2) JSON
- 笔记搜索 (V3)
- 笔记搜索 (V4) JSON
- 用户搜索 (V2) JSON
- 用户发布笔记 (V1)
- 用户发布笔记 (V2)
- 用户发布笔记 (V3)
- 用户笔记 (V4) JSON
- 用户收藏的笔记 (V1)
- 笔记详情 (V1) JSON
- 笔记详情 (V2)
- 笔记详情 (V3)
- 笔记详情 (V4)
- 笔记详情 (V5)
- 笔记详情 (V6) JSON
- 笔记详情 (V7)（已弃用）
- 笔记评论 (V2) JSON
- 笔记评论 (V3)
- 笔记评论 (V4)
- 评论回复 (V2) JSON
- 用户资料 (V3) JSON
- 用户资料 (V4)
- 关键词建议 (V1) JSON
- 话题笔记列表 (V1) JSON
- 分享链接解析 (V1) JSON
小红书电商 (RedNote)
小红书蒲公英
- 创作者搜索 (V1) JSON
- 创作者资料 (V1) JSON
- 数据摘要 (V1) JSON
- 粉丝增长历史 (V1) JSON
- 粉丝摘要 (V1) JSON
- 相似创作者 (V1) JSON
- 创作者特征标签 (V1) JSON
- 创作者内容标签 (V1) JSON
- 笔记表现指标 (V1) JSON
- 粉丝分布 (V1) JSON
- 成本效益分析 (V1) JSON
- 笔记详情 (V1) JSON
- 创作者核心指标 (V1) JSON
- 内容广场笔记 (V1) JSON
- 创作者资料 (V1)（已弃用）
- 笔记表现指标 (V1)（已弃用）
- 粉丝分布 (V1)（已弃用）
- 粉丝摘要 (V1)（已弃用）
- 粉丝增长历史 (V1)（已弃用）
- 创作者笔记列表 (V1) JSON
- 创作者笔记列表 Pro (V1) JSON
- 数据摘要 (V2)（已弃用）
- 成本效益分析 (V1)（已弃用）
- 笔记详情 (V1)（已弃用）
- 创作者核心指标 (V1)（已弃用）
抖音
- 视频搜索 (V1)
- 视频搜索 (V4) JSON
- 图片帖子搜索 (V1) JSON
- 热搜 (V1) JSON
- 用户搜索 (V2) JSON
- 用户发布视频 (V1) JSON
- 用户发布视频 (V3) JSON
- 视频详情 (V2) JSON
- 视频评论 (V1) JSON
- 评论回复 (V1) JSON
- 用户资料 (V3) JSON
- 分享链接解析 (V1)
抖音电商
- 商品详情 (V1)（已弃用）
- 商品详情 (V2) JSON
- 商品SKU信息 (V1) JSON
- 商品SKU信息 (V2) JSON
- 商品搜索 (V1) JSON
- 商品评论 (V1) JSON
- 店铺商品列表 (V1) JSON
抖音巨量星图
- 创作者搜索 (V1) JSON
- 创作者资料 (V1) JSON
- 创作者链接结构 (V1) JSON
- 创作者可见性状态 (V1) JSON
- 创作者渠道指标 (V1) JSON
- 创作者订单经验 (V1) JSON
- 创作者链接指标 (V1) JSON
- 视频分布 (V1) JSON
- 受众分布 (V1) JSON
- 营销指标 (V1) JSON
- 传播指标 (V1) JSON
- 转化分析 (V1) JSON
- 展示商品 (V1) JSON
- 转化资源 (V1) JSON
- 性价比分析 (V1) JSON
- 受众触点分布 (V1) JSON
- 推荐视频 (V1) JSON
- 粉丝分布 (V1) JSON
- 创作者搜索轻量版 (V1)（已弃用）
- 商品报告趋势 (V1) JSON
- 视频详情 (V1) JSON
- 商品报告分析 (V1) JSON
- 评论关键词分析 (V1) JSON
- 粉丝增长趋势 (V1) JSON
- 内容关键词分析 (V1) JSON
- 创作者名片 (V1) JSON
- 创作者带货传播信息 (V1) JSON
- 创作者主页视频 (V1) JSON
- 创作者标签 (V1) JSON
- 创作者侧基础信息 (V1) JSON
- 直播统计 (V1) JSON
- 直播观看分布 (V1) JSON
- 带货种草基础信息 (V1) JSON
- 创作者合约基础信息 JSON
- 创作者资料 (V1)（已弃用）
- 受众分布 (V1)（已弃用）
- 粉丝分布 (V1)（已弃用）
- 营销指标 (V1)（已弃用）
- 传播指标 (V1)（已弃用）
- 转化分析 (V1)（已弃用）
- 展示商品 (V1)（已弃用）
- 创作者链接指标 (V1)（已弃用）
- 转化资源 (V1)（已弃用）
- 创作者链接结构 (V1)（已弃用）
- 受众触点分布 (V1)（已弃用）
- 性价比分析 (V1)（已弃用）
- 推荐视频 (V1)（已弃用）
- 粉丝增长趋势 (V1)（已弃用）
- 评论关键词分析 (V1)（已弃用）
- 内容关键词分析 (V1)（已弃用）
- 创作者带货传播信息 (V1)（已弃用）
- 带货种草基础信息 (V1)（已弃用）
- 视频详情 (V1)（已弃用）
快手
- 视频搜索 (V1) JSON
- 视频搜索 (V2) JSON
- 用户搜索 (V2) JSON
- 用户发布视频 (V2) JSON
- 视频详情 (V2) JSON
- 视频评论 (V1) JSON
- 用户资料 (V1) JSON
- 分享链接解析 (V1)
微信公众号
- 账号今日文章 (V1)（已弃用）
- 账号历史文章 (V1) JSON
- 账号历史文章 (V2) JSON
- 文章指标 (V1)
- 文章指标 (V2)
- 文章详情 (V1) JSON
- 文章详情 (V2) JSON
- 文章详情 (V3) JSON
- 文章详情 (V4) JSON
- 文章详情 (V5) JSON
- 文章评论 (V1) JSON
- 文章评论回复 (V1)
- 热门文章搜索 (V1)（已弃用） JSON
- 文章搜索 (V1) JSON
- 文章搜索 (V2)
- 小程序搜索 (V1)
- 微信指数搜索 (V1) JSON
- 搜索建议 (V1)
- 账号搜索 (V1) JSON
- 账号搜索 (V2) JSON
- 账号原创文章数 (V1)
- 账号主体信息 (V1)
- 账号基本信息 (V1) JSON
- 文章链接转换 (V1)
微信视频号
- 视频搜索 (V1) JSON
- 视频搜索 (V2)
- 账号搜索 (V1) JSON
- 账号搜索 (V2)
- 账号搜索 (V3)
- 账号视频 (V1)
- 获取绑定频道 (V1) JSON
- 视频基本信息 (V1)
- 视频标题 (V1)
- 导出ID转换 (V1) JSON
- 视频下载链接 (V1)
- 视频指标 (V1)
- 视频评论 (V1)
- 视频子评论 (V1)
QQ互选创作者市场
- 视频号创作者搜索 (V1) JSON
- 公众号创作者搜索 (V1) JSON
- 视频号创作者详情 (V1) JSON
- 视频号最新视频 (V1) JSON
- 公众号创作者详情 (V1) JSON
- 公众号文章列表 (V1) JSON
微博
- 关键词搜索 (V2) JSON
- 帖子详情 (V1) JSON
- 用户资料 (V3) JSON
- 用户粉丝 (V1) JSON
- 用户关注者 (V1) JSON
- 用户发布帖子 (V1) JSON
- 用户视频列表 (V1) JSON
- 电视视频详情 (V1) JSON
- 热搜 (V1) JSON
- 帖子评论 (V1) JSON
- 搜索用户发布帖子 (V1) JSON
哔哩哔哩
- 视频详情 (V2) JSON
- 用户发布视频 (V2) JSON
- 用户资料 (V2) JSON
- 视频弹幕 (V2) JSON
- 视频评论 (V2) JSON
- 视频搜索 (V2) JSON
- 分享链接解析 (V1)
- 用户关系统计 (V1) JSON
- 视频字幕 (V2) JSON
得物（毒）
京东
- 商品详情 (V1) JSON
- 商品详情 (V2)
- 商品详情 (V3) JSON
- 商品详情 (V4)
- 商品价格 (V1) JSON
- 商品搜索 (V1) JSON
- 商品搜索 (V2)（已弃用） JSON
- 商品评论 (V1) JSON
- 商品评论 (V2) JSON
- 店铺商品列表 (V1) JSON
闲鱼
1688
AliExpress
Temu
- 首页商品信息流 (V1)（已弃用） JSON
- 完整商品详情 (V1)（已弃用）
- 商品核心快照 (V1)（已弃用）
- 分类热销商品 (V1)（已弃用）
- 商品分类树 (V1)（已弃用）
- 商品评价列表 (V1)（已弃用）
- 店铺评价列表 (V1)（已弃用）
- 商品评价摘要 (V1)（已弃用）
- 店铺商品列表 (V1)（已弃用）
- 商品关键词搜索 (V1)（已弃用）
Shopee
- 商品详情 (V1) JSON
- 店铺资料与评分摘要 (V1) JSON
- 商品详情 (V2) JSON
- 店铺商品列表 (V1) JSON
- 商品SKU矩阵 (V1) JSON
- 店铺基本资料 (V1) JSON
- 商品搜索 (V1) JSON
- 商品SKU型号 (V1) JSON
- 店铺详情 (V1) JSON
- 丰富店铺评价 (V1) JSON
- 商品展示快照 (V1) JSON
- 店铺评价 (V1) JSON
- 商品评价 (V1) JSON
- 店铺分类 (V1) JSON
- 商品评价模型分布 (V1) JSON
- 商品评价标签 (V1) JSON
- 搜索分类筛选 (V1) JSON
- 商品分期与金额 (V1) JSON
豆瓣电影
TikTok
- 用户发布帖子 (V1) JSON
- 帖子详情 (V1) JSON
- 用户资料 (V1) JSON
- 帖子评论 (V1) JSON
- 评论回复 (V1) JSON
- 用户搜索 (V1)（已弃用） JSON
- 作品搜索 (V1) JSON
TikTok Shop
优酷
- 用户资料 (V1) JSON
- 用户资料 (V2) JSON
- 帖子详情 (V1) JSON
- 用户发布帖子 (V1) JSON
- 通用搜索 (V1)
- Reels 搜索 (V1) JSON
- 话题标签帖子搜索 (V1) JSON
- 帖子评论列表 (V1) JSON
- 评论回复列表 (V1) JSON
YouTube
- 通用搜索 (V1) JSON
- 视频详情 (V1) JSON
- 频道视频 (V1) JSON
- 视频字幕 (V1) JSON
- 频道短视频 (V1) JSON
- 视频评论列表 (V1) JSON
- 视频子评论列表 (V1) JSON
今日头条
知乎
- 专栏文章详情 (V1) JSON
- 回答列表 (V1) JSON
- 关键词搜索 (V1) JSON
- 专栏文章列表 (V1) JSON
- 用户信息 (V1) JSON
- 用户关注 (V1) JSON
- 用户关注者 (V1) JSON
- 用户文章 (V1) JSON
- 用户收录文章 (V1) JSON
- 用户关注专栏 (V1) JSON
- 用户关注问题 (V1)
- 用户关注收藏夹 (V1) JSON
- 用户关注话题 (V1) JSON
- 回答评论 (V1) JSON
- 评论回复 (V1) JSON
亚马逊
领英
- 人员搜索 (V1)（已弃用） JSON
- 用户资料 (V1) JSON
- 公司员工 (V1)（已弃用） JSON
- 用户发布帖子 (V1) JSON
- 帖子反应 (V1)（已弃用） JSON
- 帖子评论 (V1) JSON
贝壳
IMDb
- 发行预期 (V1) JSON
- 扩展详情 (V1) JSON
- 主要演员和工作人员 (V1) JSON
- 基本信息 (V1) JSON
- Redux概览 (V1) JSON
- '你知道吗'洞察 (V1) JSON
- 影评人评论摘要 (V1) JSON
- 奖项摘要 (V1) JSON
- 用户评价摘要 (V1) JSON
- 剧情摘要 (V1) JSON
- 贡献问题 (V1) JSON
- 详情 (V1) JSON
- 票房摘要 (V1) JSON
- 推荐 (V1) JSON
- 关键词搜索 (V1)
- 流媒体精选 (V1) JSON
- 分类新闻 (V1) JSON
- 榜单排名 (V1) JSON
- 原产国 (V1) JSON
LLM
ZCOOL
许可证
本项目基于 MIT License 发布。
1 maintainer
Metadata
1 maintainer
Release files for justoneapi 3.0.84
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| justoneapi-3.0.84.tar.gz | 113.2 kB | With provenance | Details for justoneapi-3.0.84.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| justoneapi-3.0.84-py3-none-any.whl | Python 3 | none | any | Details for justoneapi-3.0.84-py3-none-any.whl |
Total release size: 219.6 kB
Release files / justoneapi-3.0.84.tar.gz
| Download URL | justoneapi-3.0.84.tar.gz |
|---|---|
| Size | 113.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
60adbbd47b3b6759811f96adb097c7f2181ca9ccadfbcc222943711c69f73a60
|
|
BLAKE2b-256 checksum How to use checksums |
ae34e5859f282ec13079710647f094d37e1727e7b6ec63c5092963e702d2a128
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 12, 2026.
Transparency logRelease files / justoneapi-3.0.84-py3-none-any.whl
| Download URL | justoneapi-3.0.84-py3-none-any.whl |
|---|---|
| Size | 106.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a3ca9a343c2caa0c6d7956e71135461ab5b0580ac621082a689abd22a29a63e3
|
|
BLAKE2b-256 checksum How to use checksums |
7efd6e2c48e38fd81f2ad2a9eccc0ec8e8b0ae027775b1c97c573f0e2dbc42da
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 12, 2026.
Transparency logSecurity for justoneapi 3.0.84
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for justoneapi-3.0.84.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 12, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
