justoneapi 1.15.2

Official Python SDK for Just One API

English | 简体中文

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.

---

🚀 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.