> 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 do I retrieve Douyin and Xiaohongshu search suggestions for content research?

> Retrieve suggestions by platform and seed, distinguish autocomplete from related terms and indices, then check actual content before choosing an angle.

**To get search-suggestion candidates for a seed term, query each platform's search-suggestion action separately: `data:douyin.search.fetch_search_suggest` for Douyin and `data:xiaohongshu.web_v3.fetch_search_suggest` for Xiaohongshu.** Use the candidates to find more specific wording: a how-to question, a selection condition or a usage situation.

For example, for a coffee-machine topic, keep the candidates each platform actually returns, and pick the terms relevant to your audience before searching notes or videos. A term that appears in the suggestions does not show the highest demand or an absolute search volume.

## Request each platform separately

Both actions take `keyword`. The bodies below are request bodies for `POST /v1/social-data/call`; save each actual response.

Douyin: `data:douyin.search.fetch_search_suggest`.

```json
{"action":"douyin.search.fetch_search_suggest","params":{"keyword":"coffee machine"}}
```

Xiaohongshu: `data:xiaohongshu.web_v3.fetch_search_suggest`.

```json
{"action":"xiaohongshu.web_v3.fetch_search_suggest","params":{"keyword":"coffee machine"}}
```

Keep each platform's results separate, because the same seed can produce different suggestions on Douyin and Xiaohongshu. This page covers these two routes, whose inputs are verified. WeChat Search has no search-box suggestion action; see the last section.

## Choose suggestions, related terms or an index

| Question                                         | Material                                                   |
| ------------------------------------------------ | ---------------------------------------------------------- |
| How might readers complete or phrase this query? | Search-suggestion candidates                               |
| Which directions relate to a PGY keyword?        | `xiaohongshu.pgy.get_keyword_related`                      |
| How does interest in a term change over time?    | [Daily keyword index](/faq/xiaohongshu-keyword-index)      |
| What are people actually discussing?             | Search notes/videos and read relevant content and comments |

Suggestions are not search counts. Keep the returned order as an observation, and record a rank only when the response explicitly provides one. Do not label array position as search popularity.

## Organize a 30-term task

Send one query per platform–seed pair. Thirty seeds on two platforms mean 60 planned queries, not one request with 30 terms. Review a small first batch before continuing within the chosen scope.

A review table can include the platform, seed, returned suggestion, explicit rank if provided, query time, request ID and response source. Group identical terms within one platform, and keep the seeds that produced each term. Record seeds that returned no suggestions separately from failed requests.

The two actions' outputs have no unified term and rank mapping yet. This page gives the request routes; you or your assistant build the table from the actual responses. Do not assume the competitor's `keyword/related_to/rank` paths are BeatAPI output.

## Turn expanded terms into angles

To hand the task to an assistant with BeatAPI tools configured:

> Retrieve suggestions for these terms on Douyin and Xiaohongshu, retaining platform sources. Select concrete questions relevant to the audience and review a small set of actual content. Deliver angles, representative sources and verification needed.

If a returned suggestion concerns cleaning steps, find out which step readers struggle with before proposing an explanation or checklist. Titles are editorial proposals; reader questions and original excerpts are the supporting material. To combine trends and comments, continue with [keyword-to-brief research](/guides/xiaohongshu-keyword-research).

Estimate the cost from the current [pricing](https://beatapi.io/pricing) and the actual number of term–platform queries. Editing saved results needs no new retrieval.

[Xiaohongshu questions](/faq/xiaohongshu) · [Douyin questions](/faq/douyin)

Suppose one platform suggests “coffee machine cleaning steps” and the other platform suggests “which coffee machine tablets to buy.” Record the platform and the original seed for both terms. File “coffee machine cleaning steps” under how-to and “which coffee machine tablets to buy” under shopping. If you already have a step-by-step article, review the buying question before commissioning another tutorial.

## Identify what your WeChat keyword material represents

BeatAPI's public WeChat Search actions search content by keyword; WeChat Search has no separate search-box suggestion action. If you already saved WeChat suggestions, group them by seed term and keep the original wording, the observation date and any explicit rank. If phrases such as “coffee machine cleaning” or “steam wand cleaning” came from article titles or video captions, label the phrases' origin as content wording.

Use the candidates to find relevant articles or videos, and confirm the underlying question before shortlisting a topic. See the [WeChat topic-search workflow](/guides/wechat-topic-search).