Xiaohongshu Keyword Search
Search one Xiaohongshu keyword and return matching content identifiers with collection metadata.
Original · en-USZur Übersetzung
meme_todayÜbersicht
Researching how a topic appears in Xiaohongshu search often starts with finding a dependable set of matching content identifiers. This app turns one search keyword into a structured collection of matching items, keeping the keyword and collection context beside each identifier so the dataset remains understandable after it is exported or joined with other research material.
The result is useful as a discovery index: it shows which content items were associated with a brand, product, topic, or campaign at collection time. It is especially suited to building repeatable monitoring sets, comparing the content populations found for different terms, and preparing identifiers for later analysis without manually recording items from search pages.
Data notes
Each record represents one item associated with the submitted Xiaohongshu keyword. Content identifiers are de-duplicated within the returned dataset. Matched keyword, Source item, and Business ID preserve the collection context and may repeat across many records from the same search. Effective update time is returned without timezone information, so it should not be treated as an absolute cross-region timestamp without additional context. Account unique ID may be unavailable for some records.
The collection contains identifiers and collection metadata, not the full post body, title, media, engagement totals, comments, or a complete author profile. A No-data marker distinguishes task metadata that reports no matching content from ordinary matched records.
What a result looks like
Each row is one matched content item or a no-data marker associated with the search keyword.
| Content ID | Matched keyword | Effective update time | Business ID | No-data marker |
|---|---|---|---|---|
| 6a8ffa18000000000402a03c | 蓝牙耳机 | 2026-08-27T16:56:13 | 蓝牙耳机 | No |
| 6a8ff9c900000000260068c2 | 蓝牙耳机 | 2026-08-27T16:56:13 | 蓝牙耳机 | No |
Account unique ID and Source item are also available when supplied with the record.
Use cases
- For topic discovery, group rows by Matched keyword and count distinct Content ID values to compare the searchable content population associated with each term.
- For monitoring, repeat a keyword collection and compare Content ID sets while using Effective update time as source-provided context for newly observed items.
- For provenance checks, compare Matched keyword, Source item, and Business ID to confirm which search context produced each content item before combining datasets.
- For data-quality review, filter on No-data marker and missing Account unique ID values to separate empty-search metadata from usable matched records.
Anwendungsbereich & Grenzen
One keyword per task with an expected result count from 1 to 200; results are returned in complete batches of 20 and may be rounded up; coverage is limited to records available through Xiaohongshu keyword search.
- Geeignet für
- When you need content identifiers returned by a Xiaohongshu keyword search for a brand, product, topic, or campaign.
- When you need a structured list that connects each matched content item with its search keyword and collection metadata.
- Nicht verwenden für
- When you need full post text, media, engagement metrics, comments, or complete author profiles.
- When you need an immediate single-record lookup rather than a background keyword collection task.
Fehlerbehandlung
Vom Entwickler deklariertes Fehler- und Wiederholungsverhalten. Wir empfehlen, es bei der Integration in Ihren System-Prompt aufzunehmen.
- 1If no matching records are returned, verify the keyword or try a shorter and broader search phrase.
- 2Keep completed records after a partial success; resubmit the same input after a failed or expired task.
- 3Retry later after rate limiting, temporary service unavailability, or a timeout.
- 4If authentication fails, verify the API Key configured for the execution environment.
Eingabe
Parameter, die zum Aufruf dieser App erforderlich sind, generiert aus dem input.schema in der manifest.json.
- Search keyword
keywordErforderlichstringA brand, product, topic, or phrase to search on Xiaohongshu. Each task accepts one keyword from 1 to 512 characters.Beispiel蓝牙耳机 - Expected result count
crawl_countErforderlichintegerExpected number of search results, from 1 to 200. Results are returned in complete batches of 20, so the actual count may be rounded up.Bereich1–200Beispiel20
Ausgabe
Feldstruktur eines einzelnen Datensatzes, generiert aus dem output.schema in der manifest.json.
- Content ID
content_idstringUnique identifier of the matched Xiaohongshu content item.Beispiel6a8ffa18000000000402a03c - Matched keyword
keywordstringSearch keyword associated with the collected content item.Beispiel蓝牙耳机 - Effective update time
effective_update_timestringTimestamp associated with the collected record; the source does not specify a timezone.Beispiel2026-08-27T16:56:13 - Account unique ID
account_unique_idstringUnique account identifier when available; this value may be missing.Beispielaccount_example_001
Beispieldaten
Aus output.schema erzeugt. Felder ohne Beispielwert verwenden strukturelle Platzhalter.
{
"content_id": "6a8ffa18000000000402a03c",
"keyword": "蓝牙耳机",
"effective_update_time": "2026-08-27T16:56:13",
"account_unique_id": "account_example_001",
"biz_id": "蓝牙耳机",
"source_item": "蓝牙耳机",
"no_data": false
}Integration
Diese App kann über MCP, API, SDK oder Dateiexport integriert werden — alle Kanäle teilen sich dieselben Fähigkeiten und Preise. Jede Anfrage authentifiziert sich über den Authorization: Bearer-Header mit einem API Key (langlebig, in der Data Hub Konsole erstellt); MCP-Clients können sich zusätzlich per OAuth ohne Key anmelden. Weitere Optionen wie CLI und Skill sind in Vorbereitung. Diese App läuft asynchron und kann zwischendurch abgebrochen werden: Nach dem Abbruch stoppt der Lauf. Bereits gelieferte Datensätze bleiben erhalten und werden abgerechnet.
Über das MCP (Model Context Protocol) können Sie diese App direkt aus KI-Clients wie Claude und Cursor aufrufen. Wählen Sie Ihren Client und den Authentifizierungsmodus und kopieren Sie dann die Konfiguration unten.
Client-Konfiguration
Ersetzen Sie den Wert nach Bearer durch Ihren langlebigen API Key. Funktioniert in jedem Client, in CI und in Headless-Umgebungen.
{
"mcpServers": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=meme_today/xiaohongshu-keyword-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}Lassen Sie die KI die Einrichtung übernehmen
Sie möchten Konfigurationen nicht von Hand bearbeiten? Kopieren Sie den Installations-Prompt und fügen Sie ihn in einen beliebigen KI-Client ein — er schließt die Einrichtung auf seine eigene Weise ab. (Der Prompt weist die KI an, Ihren API Key bei Ihnen zu erfragen, damit Zugangsdaten nie im Chatverlauf oder in geteilten Konfigurationen landen.)
detail.access.mcp.composeHint
Preise
Berechnet nach der Anzahl der erfolgreich zurückgegebenen Datensätze. Fehlgeschlagene Läufe werden nicht berechnet. Abgerechnet in Einheiten von 20 Datensätze; jede angefangene Einheit wird auf 20 Datensätze aufgerundet.
Wird pro übermitteltem Lauf einmal berechnet, unabhängig davon, wie viele Datensätze zurückgegeben werden.
Mehrere Abrechnungsereignisse werden unabhängig voneinander kumuliert. Details siehe jeweilige Position. Fehlgeschlagene Läufe werden nicht berechnet.
Credits ansehenJetzt ausprobieren
Füllen Sie die Parameter aus und starten Sie — die Ergebnisse stammen aus einem echten Aufruf.