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 키는 서버에 보관하고 브라우저 코드에 노출하지 마세요. 비공개, 삭제됨, 제한됨 또는 사용할 수 없는 링크는 예상 가능한 분석 실패로 처리해야 합니다.