PyPI version

Just One API - Python SDK

Official Python SDK for accessing Just One API — a unified data service platform offering structured data from Social, E-commerce platforms such as Xiaohongshu, Taobao, Douyin, Kuaishou, Bilibili, and Weibo.

This SDK simplifies API integration and request signing, allowing developers to easily retrieve platform-specific data with minimal setup.

🧧 Featured Project (Separate Service)

Just Serp API

Note: This is an independent project and not part of the Just One API Python SDK.

Need search engine data? Check out Just Serp API — a high-performance SERP API providing structured data from Google, Bing, and other search engines.

🚀 Installation

Install via PyPI:

pip install justoneapi

🛠 Quick Start

from justoneapi.client import JustOneAPIClient

# By default, the client uses the "cn" (Mainland China) environment.
client = JustOneAPIClient(token="your_token")
# If you are located outside Mainland China and experience slow responses,
# you can switch to the "global" environment for better performance:
# client = JustOneAPIClient(token="your_token", env="global")

# Example: Get Douyin Video detail
result, data, message = client.douyin.get_video_detail_v2(video_id="7428906452091145483")
print(result)
print(data)
print(message)

# Example: Douyin Video Search
result, data, message, has_next_page = client.douyin.search_video_v4(keyword="deepseek", sort_type="_0", publish_time="_0", duration="_0", page=1)
print(result)
print(data)
print(message)
print(has_next_page)

📦 Return Value Description

Each API method returns one or more of the following values:

Variable	Type	Description
`result`	`bool`	Whether the request was successful. `True` means success, `False` means failure.
`data`	`dict` / `list`	The actual data returned from the API. Structure varies by endpoint.
`message`	`str`	Message from the server. Contains error info when request fails.
`has_next_page`	`bool`	Present in paginated APIs. Indicates whether more data is available.

🔐 Authentication

All API requests require a valid API token.
👉 Register

📚 Documentation

👉 Full API docs: API Document

Includes:

Request parameters
Response fields
Error codes

🏠 Official Website

👉 Home Page

Learn more about the project, data sources, and commercial integration opportunities.

📬 Contact Us

If you have any questions, feedback, or partnership inquiries:

👉 Contact

🪪 License

This project is licensed under the MIT License.
See the LICENSE file for details.