> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Search notes

> Search notes

Search notes

**Pricing** — base \$0.0145 per successful call (provider cost × 1.45; final charge scales by your plan multiplier). Charged only when the upstream response body `code` is `200`.

## Example

```bash theme={null}
curl "https://api.aisa.one/apis/v1/tikhub/xiaohongshu/app_v2/search_notes?keyword=food recommendations" \
  -H "Authorization: Bearer YOUR_API_KEY"
```


## OpenAPI

````yaml openapi/tikhub-en.json GET /tikhub/xiaohongshu/app_v2/search_notes
openapi: 3.1.0
info:
  title: AIsa API
  description: >-
    Capability layer for the agentic economy. Models, skills, payments, and
    deployment — everything AI agents need to reason, act, and transact. This
    spec consolidates all AIsa API endpoints into a single reference.
  version: 1.0.0
  contact:
    name: AIsa
    url: https://aisa.one
    email: developer@aisa.one
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  termsOfService: https://aisa.one/tos
servers:
  - url: https://api.aisa.one/apis/v1
    description: AIsa Data APIs (Bearer auth — register at https://aisa.one)
  - url: https://api.aisa.one/apis/v2
    description: >-
      AIsa Data APIs (x402 pay-per-call) — same surface as /apis/v1, mirrored.
      No registration; receive HTTP 402 challenge, settle with stablecoin
      micropayment. Spec: https://www.x402.org. Open-source gateway
      implementation: https://github.com/AIsa-team/aisa-proxy
    x-implementation: https://github.com/AIsa-team/aisa-proxy
  - url: https://api.aisa.one/v1
    description: AIsa LLM Inference (OpenAI-compatible, Bearer auth)
  - url: https://api.aisa.one/v1beta
    description: AIsa Gemini-compatible GenerateContent (Bearer auth)
security:
  - BearerAuth: []
tags:
  - name: AI Models
    description: >-
      Access 50+ LLMs via OpenAI-compatible, Anthropic, and Google Gemini
      interfaces
  - name: Account & Usage
    description: >-
      Programmatic account balance and usage endpoints for cost monitoring and
      alerting
  - name: Agent Email
    description: >-
      AI-agent email accounts, inboxes, threads, drafts, and message send/reply
      via AgentMail.to
  - name: Crypto Data
    description: Cryptocurrency prices, markets, and exchange data via CoinGecko
  - name: Financial Data
    description: Stock prices, financials, analyst estimates, SEC filings, and macro data
  - name: Image Generation
    description: Generate and edit images using AI models
  - name: Instagram
    description: >-
      Read public Instagram data — profiles, posts, reels, highlights, comments,
      and Google-backed search
  - name: Market Intelligence
    description: ''
  - name: Other
    description: ''
  - name: Pinterest
    description: >-
      Read public Pinterest data — search pins, fetch pin details, and browse
      boards
  - name: Prediction Markets
    description: Query prediction markets — Polymarket, Kalshi, and matching markets
  - name: Reddit
    description: >-
      Read public Reddit data — search posts, browse subreddits, and fetch
      comments
  - name: SEO & Search Data
    description: >-
      SERP, keywords, backlinks, domain and competitor analysis — DataForSEO,
      Semrush, and Ahrefs
  - name: Sales Intelligence
    description: B2B contact and company enrichment, search, and outreach via Apollo.io
  - name: Scholar Search
    description: Search academic papers and research
  - name: Twitter / X
    description: >-
      Read, search, and interact with Twitter/X — profiles, tweets, communities,
      trends, and engagement
  - name: WaveInflu
    description: ''
  - name: Web & News Search
    description: >-
      Search the web and news — Tavily search, Oxylabs AI-answer-engine queries,
      and model-grounded search
  - name: YouTube Search
    description: Search YouTube videos
paths:
  /tikhub/xiaohongshu/app_v2/search_notes:
    get:
      tags:
        - Other
      summary: Search notes
      description: Search notes
      operationId: get_tikhub_xiaohongshu_app_v2_search_notes
      parameters:
        - name: keyword
          in: query
          required: true
          schema:
            type: string
            title: Keyword
            description: Search keyword
          description: Search keyword
          example: Food Recommendations
        - name: page
          in: query
          required: false
          schema:
            type: integer
            description: Page number, start from 1
            default: 1
            title: Page
          description: Page number, start from 1
          example: 1
        - name: sort_type
          in: query
          required: false
          schema:
            type: string
            description: Sort type
            default: general
            title: Sort Type
          description: Sort type
          example: general
        - name: note_type
          in: query
          required: false
          schema:
            type: string
            description: 'Note type: Unlimited, Video note, Standard note, Live note'
            default: No filter
            title: Note Type
          description: 'Note type: Unlimited, Video note, Standard note, Live note'
          example: No filter
        - name: time_filter
          in: query
          required: false
          schema:
            type: string
            description: >-
              Publish time filter: Unlimited, Within 1 day, Within 1 week,
              Within 6 months
            default: No filter
            title: Time Filter
          description: >-
            Publish time filter: Unlimited, Within 1 day, Within 1 week, Within
            6 months
          example: No filter
        - name: search_id
          in: query
          required: false
          schema:
            type: string
            title: Search Id
            description: Search ID for pagination
            default: ''
          description: Search ID for pagination
          example: ''
        - name: search_session_id
          in: query
          required: false
          schema:
            type: string
            description: Search session ID for pagination
            default: ''
            title: Search Session Id
          description: Search session ID for pagination
          example: ''
        - name: source
          in: query
          required: false
          schema:
            type: string
            description: Source
            default: explore_feed
            title: Source
          description: Source
          example: explore_feed
        - name: ai_mode
          in: query
          required: false
          schema:
            type: integer
            description: 'AI mode: 0=off, 1=on'
            default: 0
            title: Ai Mode
          description: 'AI mode: 0=off, 1=on'
          example: 0
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
components:
  schemas:
    ResponseModel:
      properties:
        code:
          type: integer
          title: Code
          description: HTTP status code
          default: 200
        request_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Request Id
          description: Unique request identifier
        message:
          type: string
          title: Message
          description: Response message (EN-US)
          default: Request successful. This request will incur a charge.
        message_zh:
          type: string
          title: Message Zh
          description: Response message (ZH-CN)
          default: Request successful; this request will be billed.
        support:
          type: string
          title: Support
          description: Support message
          default: 'Discord: https://discord.gg/aMEAS8Xsvz'
        time:
          type: string
          title: Time
          description: The time the response was generated
        time_stamp:
          type: integer
          title: Time Stamp
          description: The timestamp the response was generated
        time_zone:
          type: string
          title: Time Zone
          description: The timezone of the response time
          default: America/Los_Angeles
        docs:
          anyOf:
            - type: string
            - type: 'null'
          title: Docs
          description: Link to the API Swagger documentation for this endpoint
        cache_message:
          anyOf:
            - type: string
            - type: 'null'
          title: Cache Message
          description: Cache message (EN-US)
          default: >-
            This response is cached and accessible via the URL below for 24
            hours at no extra cost. The cache is for request tracing only — it
            doesn't affect the API's data freshness and won't be returned
            through the API again.
        cache_message_zh:
          anyOf:
            - type: string
            - type: 'null'
          title: Cache Message Zh
          description: Cache message (ZH-CN)
          default: >-
            This response has been cached and can be viewed directly via the URL
            below; it is valid for 24 hours and accessing the cached link incurs
            no additional charge. The cache is for request tracing only and does
            not affect the freshness of the API data, nor will it be returned
            again through the API.
        cache_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Cache Url
          description: The URL to access the cached result
        router:
          type: string
          title: Router
          description: The endpoint that generated this response
          default: ''
        params:
          title: Params
          description: The parameters used in the request
          default: {}
        data:
          anyOf:
            - {}
            - type: 'null'
          title: Data
          description: The response data
      type: object
      title: ResponseModel
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: AIsa API key. Get yours at https://aisa.one

````