---
title: "Weibo API Docs &amp; Endpoint Directory"
description: "Choose third-party Weibo data APIs for time-based post search, details, MID-based comments, user posts, and hot search. Includes a Python workflow."
---

# Weibo API Docs & Endpoint Directory

JustOneAPI provides third-party Weibo data APIs for topic research, social listening, and account content analysis. Start with the keyword, post ID, MID, or UID you already have.

## Choose a Weibo data endpoint by task

- Find posts about a topic: [Keyword Search V2](./keyword-search-v2) requires `q`, `startDay`, `endDay`, `startHour`, and `endHour`. Continue with `page` while keeping the same search conditions.
- Look up a known post: [Post Details V1](./post-details-v1) takes `id`.
- Read a discussion: [Post Comments V1](./post-comments-v1) takes `mid`; [Comment Replies V1](./comment-replies-v1) takes `commentId`. Both support optional `maxId` pagination, with each request flow retaining its own cursor.
- Research an account: use its `uid` with [User Profile V3](./user-profile-v3) or [User Published Posts V1](./user-published-posts-v1). Check the endpoint's continuation parameters before requesting another page.
- Discover current topics: [Hot Search V1](./hot-search-v1) retrieves the current Weibo hot-search ranking.

## Connect search, post details and comments

Follow the existing [Python tutorial for time-based search, post details and comments](https://justoneapi.com/en/blog/weibo-search-post-comments-api-tutorial). It explains ID/MID handling, comment cursors, deduplication, and saving bounded results as JSON.

The detail endpoint's `id` and the comment endpoint's `mid` are different request parameters; do not assume they are interchangeable. Keep search pages and comment cursors separate. A bounded search or comment sample does not establish complete coverage of a topic or discussion.

## Authentication and request scope

Read the [API usage guide](../../usage) for authentication. Endpoint permissions, pricing, and available trial allowance are shown in the Dashboard. This directory covers reading data; it does not provide posting, liking, or account-login endpoints.

## Available APIs

<div class="api-doc-table api-doc-table--platform">

| Endpoint | Method | Description |
| --- | --- | --- |
| [Keyword Search \(V2\)](./keyword-search-v2) | `GET` | Searches Weibo posts by keyword within a required day-and-hour time range, with page-based pagination, hot or time sorting, and filters for pictures, video, mu… |
| [Post Details \(V1\)](./post-details-v1) | `GET` | Retrieves details for a Weibo post identified by its post ID. Use it to look up a known post for content review, archiving, or related engagement analysis. |
| [User Profile \(V3\)](./user-profile-v3) | `GET` | Retrieves a Weibo user profile identified by UID. Use it to look up a known account for creator research, profile review, or subsequent retrieval of that user'… |
| [User Fans \(V1\)](./user-fans-v1) | `GET` | Retrieves a page of fan accounts that follow a Weibo user identified by UID. Use it to browse the account's follower audience or continue through its fan list. |
| [User Followers \(V1\)](./user-followers-v1) | `GET` | Retrieves a page of accounts followed by a Weibo user identified by UID. Use it to examine the account's outgoing follow network or continue through its follow… |
| [User Published Posts \(V1\)](./user-published-posts-v1) | `GET` | Retrieves posts published by a Weibo user identified by UID, using page numbers and a required sinceId cursor after the first page. Use it to browse an account… |
| [User Video List \(V1\)](./user-video-list-v1) | `GET` | Retrieves a Weibo user's video waterfall feed by UID, with an optional cursor from a prior response. Use it to browse videos published by a known account or co… |
| [TV Video Details \(V1\)](./tv-video-details-v1) | `GET` | Retrieves Weibo TV video details for a colon-delimited object ID (OID). Use it to look up a known TV video for content review, cataloging, or downstream proces… |
| [Hot Search \(V1\)](./hot-search-v1) | `GET` | Retrieves the current Weibo hot-search ranking. Use it to identify trending topics for newsroom monitoring, content planning, or timely topic discovery. |
| [Post Comments \(V1\)](./post-comments-v1) | `GET` | Retrieves comments for a Weibo post identified by MID, with optional maxId cursor pagination and time or hot sorting. Use it to review audience discussion, con… |
| [Comment Replies \(V1\)](./comment-replies-v1) | `GET` | Retrieves replies under a Weibo top-level comment identified by commentId, with optional maxId cursor pagination. Use it to follow a comment thread for discuss… |
| [Search User Published Posts \(V1\)](./search-user-published-posts-v1) | `GET` | Searches posts published by a specific Weibo user, using a keyword, optional date range, and page-based pagination. Use it to find historical posts from a know… |

</div>

