> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# How many trends fit a page, and how do I get more?

> Weibo hot search returns up to count items per page (default 20, range 1–50), starts at page:1, and advances by incrementing page while keeping category, city, and count fixed.

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 to `20` and allows any integer from `1` through `50`.
* **Same board pagination:** Start at `page:1` and increase `page` by `1` on each subsequent request while keeping category, city, and `count` identical.
* **Switching boards:** When changing the category or city, reset `page` back to `1` and treat the new board as a separate run.

## Recording, deduplicating, and stop conditions

1. **Report actual returned items:** If a request asks for `count:20` and receives `12` items, report "12 trends observed on page one."
2. **Deduplicate across pages:** When combining multiple pages, deduplicate by the actual topic ID or a verified source while preserving each page's collection timestamp.
3. **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](/faq/weibo-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](https://beatapi.io/pricing).

[General trends](/faq/weibo-hot-search) · [Category trends](/faq/weibo-trend-categories) · [City trends](/faq/weibo-local-trends)