Xiaohongshu / RedNote notes Open API連携ガイド

TapSave Open APIで公開Xiaohongshu / RedNote notesリンクを解析し、返されたメディアリソースをアプリケーションで処理する方法を説明します。

連携の流れ

https://api.videotool.cc/openapi/parse にPOSTリクエストを送ります。Content-Type: application/json、X-API-Keyヘッダー、公開リンクを含むJSONの url フィールドを指定します。

レスポンスの処理

まず code === 200、data.resultCode === 0、data.hasResource === true を確認します。その後、このレスポンスに実際に返されたリソース配列だけを処理し、URLを推測したり固定形式を前提にしたりしないでください。

Xiaohongshu / RedNote notes resources

Xiaohongshu のノートには画像セット、動画、本文が含まれる場合があります。imgList、videoList、descList をそれぞれ個別に処理してください。上流から提供される場合は、API は author（投稿者名）、publishTime（yyyy-MM-dd HH:mm:ss 形式の投稿日時）、publishTimestamp（秒単位の Unix タイムスタンプ）も返します。これらのフィールドは空の場合があり、互換性のため descList は変更されません。

制限とセキュリティ

APIキーはサーバー側に保管し、ブラウザーコードへ公開しないでください。非公開、削除済み、制限付き、利用不可のリンクは想定内の解析失敗として扱います。