How many trends fit a page, and how do I get more?
One page of Weibo hot search returns up to the requested count items, where count defaults to 20 and accepts values from 1 to 50. Start at page:1, keep the category, city, and count unchanged, and increment page by 1 to read more trends from the same board.
Page size and advancing page
- Per-page limit (
count): Defaults to20and allows any integer from1through50. - Same board pagination: Start at
page:1and increasepageby1on each subsequent request while keeping category, city, andcountidentical. - Switching boards: When changing the category or city, reset
pageback to1and treat the new board as a separate run.
Recording, deduplicating, and stop conditions
- Report actual returned items: If a request asks for
count:20and receives12items, report “12 trends observed on page one.” - Deduplicate across pages: When combining multiple pages, deduplicate by the actual topic ID or a verified source while preserving each page’s collection timestamp.
- Record the stop reason: Stop paging and record the reason whenever you encounter an empty page, repeated results, a failed request, or your configured page limit.
Scope boundaries and related Weibo lists
Weibo hot search boards use different request inputs from keyword search. Always read board fields from the actual response returned by the API, and budget usage by the total number of pages requested—see BeatAPI pricing.

