小紅書 post API

REST 呼び出し1回で小紅書の post データを取得——全プラットフォーム共通の安定した 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 キーを取得すれば、ブラウザ版 Playground からこのエンドポイントを呼び出せます。

Playground で試す

このエンドポイントのパラメータ表・エラーコード・レスポンスの詳細は API ドキュメントにあります。

エンドポイントリファレンスを開く

よくある質問

レスポンスにはどんなコンテンツ項目が含まれますか？

正規化されたコンテンツエンティティ（本文・投稿者・タイムスタンプ・エンゲージメント指標・メディア参照）を下記フィールド表の定義どおりに返し、新鮮度と課金メタデータも付きます。

このエンドポイントを無料で試せますか？

はい——アカウント登録後に API キーを取得すれば、コンソールの Playground から呼び出せます。

post ケイパビリティの課金は？

Data API はリクエスト単位のクレジット課金で、cache/live の新鮮度により倍率が変わります。最新のケイパビリティ別価格は料金ページをご確認ください。

料金

リクエスト単位のクレジット課金、cache/live の新鮮度オプション対応——最新価格は料金ページをご確認ください。

料金を見るすべての API を見る