小紅書 post API

一次 REST 呼叫取得小紅書 post 資料——以 FetchPI 全平台共用的穩定 JSON 結構標準化輸出。

1 個已發布端點
GET /v1/xhs/posts/{id}

契約摘要（英文）: Get a normalized Xiaohongshu note (capability xhs.post)

標準化回應實體: xiaohongshu/post
capability: xhs.post

每個回應都附帶新鮮度（cache / default / live）與計費中繼資料。

使用場景

為內容分析管線提供結構化的 {{platform}} 貼文：內文、指標、時間戳記與媒體引用。
支撐需要原始內容與互動數據的審核、研究與監測流程。
以穩定的標準化 JSON 歸檔 {{platform}} 內容，告別脆弱的網頁爬取。

回應欄位

Xiaohongshu Post (normalized)

Normalized Xiaohongshu note — image (图文) and video (视频) notes unify onto this shape. Provider-private fields MUST NOT appear. Metric names are frozen (likes/collects/comments/shares — 赞/藏/评/转); provider synonyms map in the Normalizer; missing counts normalize to 0. author and created_at are nullable: list/search cards ship the note without a user block and often without a timestamp (a present-but-incomplete user block still fails).

欄位	類型	必填	說明
id	string	必填	Note id (note_id).
platform	"xiaohongshu"	必填	—
type	"post"	必填	—
author.id	string	必填	Numeric user_id.
author.username	string	必填	red_id; the numeric user id when red_id is absent.
author.display_name	string \| null	可選	—
author.verified	boolean	可選	—
title	string \| null	可選	The note title.
text	string \| null	可選	The note body (desc).
created_at	string \| null	必填	Note creation time, UTC RFC3339; null when the list card omits the timestamp.
metrics.likes	integer	必填	Liked count (赞).
metrics.collects	integer	必填	Collected count (藏).
metrics.comments	integer	必填	Comment count (评).
metrics.shares	integer	必填	Share count (转).
attachments	object[]	可選	The note images and/or the video (cover preview).
fetched_at	string	必填	—

欄位備註為契約英文原文。

回應中繼資料

欄位	類型	必填	說明
mode	cache \| default \| live	必填	Effective mode after merging param > max_age > source policy (D-004).
age_seconds	integer \| null	可選	Age of served data; null when unknown.
source_layer	cache \| db \| upstream	必填	Which layer served the response (PRD §10).
stale	boolean	可選	True when stale data was served under stale_if_error / SWR (D-004).
billing.amount_credits	integer	必填	Micro-USD (1e-6 USD) actually charged for this request.
billing.cache_hit	boolean	必填	—

欄位備註為契約英文原文。

請求與回應範例

GET/v1/xhs/posts/{id}

curl -H "Authorization: Bearer $MESHDATA_API_KEY" \
  "https://api.fetchpi.com/v1/xhs/posts/1842951234567890123"

{
  "data": {
    "id": "66f2b1de000000001f0167a1",
    "platform": "xiaohongshu",
    "type": "post",
    "author": {
      "id": "66f2a1de000000001e0167a1",
      "username": "creatordev",
      "display_name": "Creator Dev",
      "verified": true
    },
    "title": "One API for every feed.",
    "text": "One API for every platform.",
    "created_at": "2026-09-17T12:34:56Z",
    "metrics": {
      "likes": 1204,
      "collects": 310,
      "comments": 42,
      "shares": 87
    },
    "attachments": [
      {
        "type": "video",
        "url": "https://cdn.example.com/note.mp4",
        "preview_image_url": "https://cdn.example.com/note-cover.jpg"
      }
    ],
    "fetched_at": "2026-09-18T07:30:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 3600,
      "source_layer": "cache",
      "stale": false
    },
    "billing": {
      "amount_credits": 0,
      "cache_hit": true
    }
  }
}

免費試用

註冊免費帳號、取得 API Key，即可在瀏覽器版 Playground 直接呼叫該端點。

在 Playground 試用

該端點的參數表、錯誤碼與回應語義見 API 文件。

查看端點參考

常見問題

回應包含哪些內容欄位？

回應攜帶標準化的內容實體（內文、作者、時間戳記、互動指標與媒體引用），欄位見下方欄位表，並附帶新鮮度與計費中繼資料。

可以免費試用該端點嗎？

可以——註冊帳號、取得 API Key 後，即可在主控台的 Playground 呼叫該端點。

post 能力怎麼計費？

Data API 按請求以點數計費，cache/live 新鮮度有不同倍率。目前各能力的價格以價格頁為準。

價格

按請求以點數計費，支援 cache/live 新鮮度選項——最新價格以價格頁為準。

查看價格瀏覽全部 API