Put the room’s restrictions into the query

Suppose you want to improve a small bedroom where drilling is prohibited. A broad bedroom query will produce many unsuitable examples. Include the no-drilling constraint and intended use in keyword, then consider note type, publication-time filtering, and order. Search finds existing accounts of experience; it does not check your tenancy rules, wall materials, or load requirements.

Continue the same search deliberately

page starts at one. For later pages, retain the search_id and search_session_id supplied by the first results. If the keyword or filters change, start a new search rather than presenting the combined material as one continuous sample. Choose sort_type, note_type, and time_filter according to their documented values. The ai_mode switch is not a guarantee that any recommendation is correct.

Record why an example might work for you

Build a comparison sheet with the source, relevant room conditions, proposed method, and unresolved cost. A hypothetical adhesive shelf still requires checking its load and surface compatibility before buying. Repeated appearances in results do not establish customer satisfaction, and a price quoted in a note may have changed. Finish with a few options you can measure and investigate, not a purchase decision based solely on an appealing photograph.

Request URL and parameters

GET https://api.trmesh.com/openapi/api/v1/xiaohongshu/app_v2/search_notes

Parameter Type Required Meaning
keyword string Yes Search keyword
page integer No Page number, start from 1
sort_type string No Sort type
note_type string No Note type: 不限, 视频笔记, 普通笔记, 直播笔记
time_filter string No Time filter: 不限, 一天内, 一周内, 半年内
search_id string No Search ID for pagination
search_session_id string No Search session ID for pagination
source string No Source
ai_mode integer No AI mode: 0=off, 1=on

Run the Python example

Install requests and set TRMESH_API_TOKEN in your environment. Replace the sample identifiers with the public object you intend to inspect. Example IDs may no longer be available.

import os
import requests

# Read your own developer key from the server environment.
url = "https://api.trmesh.com/openapi/api/v1/xiaohongshu/app_v2/search_notes"
params = {
    "keyword": "美食推荐",
    "page": "1",
    "sort_type": "general",
    "note_type": "不限",
    "time_filter": "不限",
    "source": "explore_feed",
    "ai_mode": "0"
}
response = requests.get(
    url, params=params, timeout=30,
    headers={"Authorization": f"Bearer {os.environ['TRMESH_API_TOKEN']}"},
)
response.raise_for_status()
payload = response.json()
print(payload)  # Inspect the actual response before mapping fields

Endpoint documentation · Free profile tool

API calls use your TRMesh account allowance. Check the endpoint price before running a script.