A friend asks whether a short drama is good for unwinding after work, but your searches keep revealing ending screenshots. A useful reference needs to separate story information from viewing impressions.

Verify the title and version

Search the full title, adding a character when needed, and inspect appropriate image or video details. Keep query conditions and date. A recommendation may concern another version or only an edited scene rather than a complete viewing experience.

Mark spoiler boundaries first

Manually distinguish general style comments, opening context and major turns. Use only material within the agreed boundary for your friend. Check images too: the detail endpoint does not automatically remove spoilers, and unconstrained AI summaries may reveal crucial events.

Preserve preference differences

A table can contain source, reason, covered section, likely preference fit and unverified claim. One viewer's appealing pace may be another's complaint. Those preferences can coexist without an overall verdict. Verify plot claims against the work, and do not equate search order with universal opinion.

Offer an informed entry point

Describe the style, suitable viewing mood and supported limitations, with sources for optional reading. Review AI-assisted wording for spoilers and unsupported information. Verify viewing channels separately; retrieval does not provide a complete download or distribution assurance. Help your friend decide whether the style fits their evening rather than deciding the verdict for them.

Requests used in this project

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.