Rednote Search Notes
Rednote 노트 검색 결과는 키워드와 일치하는 공개 게시물로, 노트 식별 정보, 텍스트, 작성자 정보, 미디어, 게시 시각, 공개된 참여 지표를 담고 있습니다. 이러한 레코드는 주제 리서치, 형식 비교, 출처 검토, 시점별 검색 결과 분석에 활용할 수 있습니다.
Rednote Search Notes API 주요 기능
- 세 가지 필터를 지원하는 키워드 검색텍스트 검색어 하나에 지원되는 정렬, 미디어 유형, 게시 기간을 선택해 범위를 좁힌 공개 노트 검색을 구성합니다.
- 정규화된 노트 식별 정보와 콘텐츠노트 ID, 공개 URL, 텍스트, 리소스 유형, 게시 시각, 수집 시각을 공통 PostItem 구조로 반환합니다.
- 작성자, 미디어, 공개 참여 지표 정보확인 가능한 공개 작성자 필드, 이미지·동영상 참조, 해시태그, 멘션, 공개된 좋아요·댓글·공유·조회 수를 그대로 보존합니다.
- 범위가 정해진 원본 검색 페이지작업마다 선택한 검색의 1페이지를 한 번 실행하므로, 여러 페이지에 걸친 전수 크롤링이라고 내세우지 않고 정해진 범위의 스냅샷을 제공합니다.
Rednote Search Notes API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
query | 필수 | 공개 Rednote 노트를 검색하는 데 사용하는 텍스트로, 비어 있지 않아야 하는 필수 값입니다. 플레이그라운드에서는 직접 검색어를 입력하기 전까지 비워 둡니다. |
sort_by | 선택 | 결과 정렬 방식이며 선택 값입니다. general, latest, most_liked 중에서 고릅니다. 플레이그라운드의 시작 값은 general입니다. |
media_type | 선택 | 노트 형식 필터이며 선택 값입니다. all, image, video 중에서 고릅니다. 플레이그라운드의 시작 값은 all입니다. |
published_within | 선택 | 게시 기간 필터이며 선택 값입니다. all, day, week, six_months 중에서 고릅니다. 플레이그라운드의 시작 값은 all입니다. |
Rednote Search Notes API 사용 방법
Rednote 검색어와 선택적인 필터를 제출하고, 비동기 작업을 추적한 뒤, 저장된 노트 레코드를 SocQ 커서 페이지네이션으로 읽습니다.
- 비어 있지 않은 query를 준비하고, 지원되는 sort_by, media_type, published_within 값만 선택합니다.
- 페이로드를 /v1/rednote/search-notes로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽고 has_more가 true인 동안 next_cursor를 따라갑니다. 이 커서는 저장된 결과를 넘겨 보는 것이며, Rednote 검색의 추가 페이지를 가져오지는 않습니다.
curl -X POST "https://api.socq.ai/v1/rednote/search-notes" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"query\":\"$REDNOTE_SEARCH_QUERY\",\"sort_by\":\"general\",\"media_type\":\"all\",\"published_within\":\"all\"}"
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueRednote Search Notes API 추천 활용 사례
- 키워드 결과 카탈로그화: 노트 ID, 공개 URL, 텍스트, 작성자 참조, collected_at을 활용해 정해 둔 검색어에 대한 추적 가능한 스냅샷을 만듭니다.
- 이미지·동영상 결과 비교: media_type을 바꿔 가며 따로 실행하고, 그 결과 스냅샷 사이에서 반환된 미디어 참조, 노트 텍스트, 공개된 참여 지표를 비교합니다.
- 최신성 중심의 주제 검토: latest 정렬이나 게시 기간을 published_at, collected_at과 함께 사용해, 한 주제에 대해 최근 노출된 노트를 검토합니다.
- 작성자 정보 분석: 일치한 노트의 텍스트와 미디어를 확인 가능한 작성자 식별 필드와 연결해, 검색어 스냅샷에 어떤 공개 계정이 등장하는지 살펴봅니다.
Rednote Search Notes API 활용 팁
- 필수 필드 검증으로 작업이 거부되지 않도록, 제출 전에 query의 앞뒤 공백을 제거하고 비어 있지 않은지 확인하세요.
- 문서화된 열거값만 사용하세요. 명시적으로 설정할 수 있는 가장 넓은 검색을 원하면 general, all, all을 선택하세요.
- 작업 하나를 원본 검색 페이지 하나로 취급하고, 필터 조합이 다르면 작업을 따로 실행하세요. 스냅샷이 이후 원본 페이지까지 포함한다고 가정하지 마세요.
- 저장된 스냅샷이 SocQ 결과 페이지 여러 개에 걸쳐 있으면 has_more가 false가 될 때까지 next_cursor를 따라가세요. 이 커서는 Rednote 원본의 다른 페이지를 요청하지 않습니다.
- 정렬 순서와 공개된 지표는 수집 시점마다 달라질 수 있으므로, 별도로 실행한 검색 결과를 대조할 때는 노트 ID와 URL을 사용하세요.
- 텍스트, 작성자 필드, 미디어, 게시 시각, 해시태그, 멘션, 개별 지표가 null일 수 있다고 가정하고, 공개 텍스트는 표시하기 전에 이스케이프 처리하세요.
관련 API
Rednote Search Notes API 외에 Rednote의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.