Xiaohongshu tools

Xiaohongshuxiaohongshu_image_search

Xiaohongshu image search

Search Xiaohongshu images, returning matched images, attached Live Photo videos and note summaries. Does not include the note's full media list. Returns one page at a time with an encrypted continuation cursor.

Start with your agent

Claude CodeCodexCursor

Download and install the dedicated Mouter Skill for “Xiaohongshu image search”: https://mouter.ai/skills/xiaohongshu_image_search.zip

Pricing

How credits work

0.01 credits per call

Each additional page is billed as a separate call.

Usage example

Agent

Example input

Use xiaohongshu_image_search. Look up Xiaohongshu image search using query city skyline at night and summarize matching image posts and their sources. Confirm inputs and estimated cost before running.

Example output

Example only: Xiaohongshu image search has not been run. Once a task succeeds, its result contains these fields:

  1. platformtext
  2. querytext
  3. itemslist: image, live_photo_video, note
  4. returned_countnumber
  5. paginationobject: has_more, next_cursor, total
  6. retrieved_atnumber

Values depend on your input. The matching JSON example structure is in the API tab.

Continue this example

For the first batch, omit cursor. When pagination.has_more indicates more results and pagination.next_cursor is present, pass the returned pagination.next_cursor as cursor in the next call. Keep the original identifiers, filters and ordering unchanged. Each request retrieves one batch. Illustrative requests and response fragment; no calls are executed.

1. Initial request

{
  "name": "xiaohongshu_image_search",
  "arguments": {
    "query": "city skyline at night"
  }
}

2. Returned continuation

{
  "pagination": {
    "next_cursor": "<NEXT_CURSOR>",
    "has_more": true
  }
}

3. Follow-up request

{
  "name": "xiaohongshu_image_search",
  "arguments": {
    "query": "city skyline at night",
    "cursor": "<NEXT_CURSOR>"
  }
}
  • Getting started: provide search term. Adjust continuation cursor as needed.

FAQ

How do I search by keyword with Xiaohongshu image search?

Xiaohongshu image search: Getting started: provide search term. Adjust continuation cursor as needed. query: 1–4096 characters; format \S Illustrative values on this page: query="city skyline at night".

Which result details can I use from Xiaohongshu image search?

Search Xiaohongshu images, returning matched images, attached Live Photo videos and note summaries. Does not include the note's full media list. Returns one page at a time with an encrypted continuation cursor. The result includes query, items, returned_count, pagination. Read result.items[]: image, live_photo_video, note. result.retrieved_at records retrieval time; content publication times are separate source fields. Optional fields depend on what the source returns; retain null or missing values when combining results.

How do I retrieve more results from Xiaohongshu image search?

Xiaohongshu image search: For the first batch, omit cursor. When pagination.has_more indicates more results and pagination.next_cursor is present, pass the returned pagination.next_cursor as cursor in the next call. Keep the original identifiers, filters and ordering unchanged. Each request retrieves one batch.

How is Xiaohongshu image search billed for each request?

Published reference rates: Standard rate: 0.01 credits · Per call. Each additional page is billed as a separate call. Final charges use your account’s rates and actual usage.