Official Python SDK for accessing Just One API - a unified data service platform that provides structured data from social media, e-commerce, and content platforms.
Supported platforms include Taobao & Tmall, Xiaohongshu, Xiaohongshu Pugongying, Douyin, Douyin Xingtu, Kuaishou, Weibo, Bilibili, JD, WeChat, Douban, TikTok, TikTok Shop, Youku, Instagram, YouTube, Reddit, Toutiao, Zhihu, Amazon, Facebook, X (Twitter), Beike, IMDb, and more. To explore the full API catalog, visit the official website.
pip install justoneapifrom justoneapi import JustOneAPIClient
client = JustOneAPIClient(token="your_token")
# Example: Douyin video search
response = client.douyin.search_video_v4(keyword="deepseek")
print(response.success) # True only when code == 0
print(response.code) # Business code returned by the API
print(response.message) # Server message
print(response.data) # Actual payloadEvery API method returns an ApiResponse instance with these fields:
| Field | Type | Description |
|---|---|---|
success |
bool |
True only when code == 0. |
code |
Any |
Raw business code returned by the API. |
message |
str |
Server message. |
data |
Any |
Response payload from the API. |
raw_json |
dict |
Full response payload before SDK normalization. |
By default, business failures do not raise exceptions. You can check response.success, response.code, and response.message.
If you prefer exceptions for non-zero business codes:
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)All API requests require a valid API token.
Register here:
Full API documentation:
The documentation includes:
- Request parameters
- Response fields
- Error codes
- Platform-specific examples
If you have questions, feedback, or partnership inquiries:
This project is licensed under the MIT License.