rednote/
search-notes

텍스트 검색어와 선택적인 정렬·미디어·기간 필터로 공개 Rednote 노트를 검색하고, 정규화된 콘텐츠, 작성자, 미디어, 타임스탬프, 공개된 참여 지표를 반환합니다.

Rednote Search Notes API

키워드 노트 검색
정렬·미디어 필터
1페이지 공개 스냅샷
요청당 1 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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 커서 페이지네이션으로 읽습니다.

  1. 비어 있지 않은 query를 준비하고, 지원되는 sort_by, media_type, published_within 값만 선택합니다.
  2. 페이로드를 /v1/rednote/search-notes로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 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 true

Rednote 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일 수 있다고 가정하고, 공개 텍스트는 표시하기 전에 이스케이프 처리하세요.

Rednote Search Notes API 외에 Rednote의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

다른 플랫폼 둘러보기

Rednote 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Rednote Search Notes API — 자주 묻는 질문

Rednote Search Notes API는 텍스트 검색어 하나에 선택적인 정렬, 미디어 유형, 게시 기간 필터를 적용해 공개 Rednote 노트를 찾고, 정규화된 노트 식별 정보, 텍스트, 작성자 정보, 미디어, 타임스탬프, 공개된 참여 지표 필드를 반환합니다.

query는 필수입니다. sort_by는 general, latest, most_liked를, media_type은 all, image, video를, published_within은 all, day, week, six_months를 받습니다.

기본 예시의 query 값은 '旅行攻略'이고 sort_by는 general, media_type은 all이며, published_within은 생략합니다. 이 엔드포인트는 results_limit, 페이지 번호, 원본 커서를 받지 않습니다.

PostItem에는 노트 ID, URL, 텍스트, 작성자 정보, 미디어, 게시·수집 타임스탬프, 해시태그, 멘션, 공개된 좋아요·댓글·공유·조회 수가 포함될 수 있습니다. 원본에서 제공되지 않는 선택 값은 null로 유지됩니다.

아니요. 작업마다 원본 1페이지를 한 번만 요청하며, next_cursor는 SocQ에 이미 저장된 결과의 다음 페이지를 읽을 뿐입니다. 작업 결과 limit은 1에서 500까지이고 기본값은 50입니다.

작업 1건마다 고정으로 1 SocQ 크레딧이 사용됩니다. 저장되거나 반환된 노트 수는 이 고정 요금을 바꾸지 않습니다.