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.
The documentation center helps you browse endpoint health, versioned API paths, request parameters, and platform-specific usage notes.
The console provides API token management, balance visibility, request logs, usage trends, and spending analytics.
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:
The API list below is generated from OpenAPI and shows the current public API categories, endpoint names, and versions. See the online API documentation for full request and response details.
- Product Details (V1)
- Product Details (V2)
- Product Details (V4)
- Product Details (V5)
- Product Details (V9)
- Product Reviews (V3)
- Shop Product List (V1)
- Shop Product List (V2)
- Shop Product List (V3)
- Product Search (V1)
- User Profile (V3)
- User Profile (V4) (Deprecated)
- User Published Notes (V2) (Deprecated)
- User Published Notes (V4)
- Note Details (V1)
- Note Details (V3) (Deprecated)
- Note Details (V7) (Deprecated)
- Note Comments (V2)
- Note Comments (V4)
- Comment Replies (V2)
- Note Search (V2)
- Note Search (V3)
- User Search (V2)
- Share Link Resolution (V3)
- Keyword Suggestions (V1)
- Creator Profile (V1)
- Data Summary (V1)
- Follower Growth History (V1)
- Follower Summary (V1)
- Similar Creators (V1)
- Creator Feature Tags (V1)
- Creator Content Tags (V1)
- Note Performance Metrics (V1)
- User Published Notes (V1)
- Follower Distribution (V1)
- Cost Effectiveness Analysis (V1)
- Note Details (V1)
- Creator Search (V1)
- Creator Core Metrics (V1)
- Creator Profile (V1) (Deprecated)
- Note Performance Metrics (V1) (Deprecated)
- Follower Distribution (V1) (Deprecated)
- Follower Summary (V1) (Deprecated)
- Follower Growth History (V1) (Deprecated)
- Creator Note List (V1)
- Data Summary (V2) (Deprecated)
- Cost Effectiveness Analysis (V1) (Deprecated)
- Note Details (V1) (Deprecated)
- Creator Core Metrics (V1) (Deprecated)
- User Profile (V3)
- User Published Videos (V3)
- Video Details (V2)
- Video Search (V4)
- User Search (V2)
- Video Comments (V1)
- Comment Replies (V1)
- Share Link Resolution (V1)
- Creator Profile (V1)
- Creator Link Structure (V1)
- Creator Visibility Status (V1)
- Creator Channel Metrics (V1)
- Creator Order Experience (V1)
- Creator Link Metrics (V1)
- Video Distribution (V1)
- Audience Distribution (V1)
- Marketing Metrics (V1)
- Spread Metrics (V1)
- Conversion Analysis (V1)
- Showcase Items (V1)
- Conversion Resources (V1)
- Cost Performance Analysis (V1)
- Audience Touchpoint Distribution (V1)
- Recommended Videos (V1)
- Follower Distribution (V1)
- Creator Search (V1)
- Item Report Trends (V1)
- Item Report Details (V1)
- Item Report Analysis (V1)
- KOL Comment Keyword Analysis (V1)
- Follower Growth Trend (V1)
- KOL Content Keyword Analysis (V1)
- Author Commerce Spread Info (V1)
- Author Commerce Seeding Base Info (V1)
- Creator Profile (V1) (Deprecated)
- Audience Distribution (V1) (Deprecated)
- Follower Distribution (V1) (Deprecated)
- Marketing Metrics (V1) (Deprecated)
- Spread Metrics (V1) (Deprecated)
- KOL Keyword Search (V1)
- Conversion Analysis (V1) (Deprecated)
- Showcase Items (V1) (Deprecated)
- Creator Link Metrics (V1) (Deprecated)
- Conversion Resources (V1) (Deprecated)
- Creator Link Structure (V1) (Deprecated)
- Audience Touchpoint Distribution (V1) (Deprecated)
- Cost Performance Analysis (V1) (Deprecated)
- Recommended Videos (V1) (Deprecated)
- Follower Growth Trend (V1) (Deprecated)
- KOL Comment Keyword Analysis (V1) (Deprecated)
- KOL Content Keyword Analysis (V1) (Deprecated)
- Author Commerce Spread Info (V1) (Deprecated)
- Author Commerce Seeding Base Info (V1) (Deprecated)
- Video Details (V1) (Deprecated)
- User Search (V2)
- User Published Videos (V2)
- Video Details (V2)
- Video Search (V2)
- User Profile (V1)
- Share Link Resolution (V1)
- Video Comments (V1)
- Keyword Search (V2)
- Post Details (V1)
- User Profile (V3)
- User Fans (V1)
- User Followers (V1)
- User Published Posts (V1)
- User Video List (V1)
- TV Video Details (V1)
- Hot Search (V1)
- Post Comments (V1)
- Search User Published Posts (V1)
- Video Details (V2)
- User Published Videos (V2)
- User Profile (V2)
- Video Danmaku (V2)
- Video Comments (V2)
- Video Search (V2)
- Share Link Resolution (V1)
- User Relation Stats (V1)
- Video Captions (V2)
- User Published Posts (V1)
- Article Engagement Metrics (V1)
- Article Comments (V1)
- Keyword Search (V1)
- Article Details (V1)
- Movie Reviews (V1)
- Review Details (V1)
- Subject Details (V1)
- Comments (V1)
- Recent Hot Movie (V1)
- Recent Hot Tv (V1)
- User Published Posts (V1)
- Post Details (V1)
- User Profile (V1)
- Post Comments (V1)
- Comment Replies (V1)
- User Search (V1)
- Post Search (V1)
- User Profile (V1)
- Post Details (V1)
- User Published Posts (V1)
- Reels Search (V1)
- Hashtag Posts Search (V1)
- Release Expectation (V1)
- Extended Details (V1)
- Top Cast and Crew (V1)
- Base Info (V1)
- Redux Overview (V1)
- 'Did You Know' Insights (V1)
- Critics Review Summary (V1)
- Awards Summary (V1)
- User Reviews Summary (V1)
- Plot Summary (V1)
- Contribution Questions (V1)
- Details (V1)
- Box Office Summary (V1)
- Recommendations (V1)
- Keyword Search (V1)
- Streaming Picks (V1)
- News by Category (V1)
- Chart Rankings (V1)
- Countries of Origin (V1)
This project is licensed under the MIT License.