rednote/
search-users

텍스트 검색어 하나로 공개 Rednote 계정을 검색하고, 제공처의 한 페이지에서 정규화된 계정 정보, 소개, 계정 플래그, 공개된 오디언스 지표를 반환합니다.

Rednote Search Users API

텍스트 검색어
원본 1페이지
정규화된 계정
요청당 1 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Rednote Search Users

공개 Rednote 계정 검색은 텍스트 검색어 하나와 일치하는 사용자의 식별 정보, 소개, 프로필 상태, 공개된 오디언스·콘텐츠 수를 보여 줄 수 있습니다. 정규화된 계정 레코드는 확인 가능한 원본 필드를 그대로 유지하고 collected_at을 붙여, 추적 가능한 탐색과 비교에 쓸 수 있게 합니다.

Rednote Search Users API 주요 기능

  • 검색어 하나로 계정 탐색원본 페이지 제어나 추가 필터 없이, 제공처 키워드에 매핑되는 비어 있지 않은 검색어 하나를 고정된 첫 페이지에 대해 제출합니다.
  • 정규화된 공개 식별 정보확인 가능한 ID, 사용자 이름, 표시 이름, 소개, 공개 URL, 프로필 이미지, 웹사이트, 인증·비공개 필드를 안정적인 계정 구조로 받습니다.
  • 공개된 계정 스냅샷확인 가능한 팔로워·팔로잉·게시물 수를 collected_at과 함께 보관해 반환된 모든 값이 관측 시점에 묶여 있게 합니다.

Rednote Search Users API 매개변수

매개변수필수설명
query필수제공처 키워드에 매핑되는 비어 있지 않은 문자열로, 필수 값입니다. 이 엔드포인트에는 열거형, results_limit, 제공처 커서, 정렬, 미디어 필터 필드가 없습니다.

Rednote Search Users API 사용 방법

계정 검색어 하나를 제출하고, 비동기 작업을 따라가며, 저장된 정규화 계정 레코드를 읽습니다.

  1. 찾으려는 공개 계정, 크리에이터 이름, 브랜드, 주제를 나타내는 비어 있지 않은 검색어 하나를 고릅니다.
  2. query를 /v1/rednote/search-users로 보내고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패를 보고할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽습니다. 저장된 결과 응답이 has_more를 반환하면 그 next_cursor로 이어서 읽습니다.
curl -X POST "https://api.socq.ai/v1/rednote/search-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"photography"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; next_cursor paginates stored results only

Rednote Search Users API 추천 활용 사례

  • 크리에이터 후보 목록 만들기: 이름이나 주제어로 공개 계정을 찾은 다음, 후보를 고르기 전에 확인 가능한 식별 정보와 소개 필드를 검토합니다.
  • 계정 디렉터리 정보 보강: 정규화된 ID, 사용자 이름, 표시 이름, 프로필 텍스트, 이미지, URL, 웹사이트, 계정 플래그를 탐색 목록에 추가합니다.
  • 공개 계정 지표 비교: 확인 가능한 팔로워·팔로잉·게시물 수를 collected-at 시점의 스냅샷으로 활용하되, 비공개 분석 자료나 실시간 합계로 취급하지 않습니다.

Rednote Search Users API 활용 팁

  • query만 제출하세요. results_limit, cursor, page, sort, filter, media_type, 그 밖의 추가 필드는 이 엔드포인트가 거부합니다.
  • 제공처 호출은 고정된 첫 페이지 하나로 취급하세요. 공통 작업 리더의 next_cursor는 저장된 SocQ 행을 넘겨 볼 뿐, Rednote 원본의 추가 페이지를 가져오지 않습니다.
  • 공개 응답에서 생략되면 ID, 사용자 이름, 이름, 소개 텍스트, 이미지, 웹사이트, 계정 플래그, 개별 지표가 null일 수 있다고 가정하세요.
  • 공개된 수치는 collected_at과 함께 저장하고, 성공한 작업마다 반환된 계정 수와 관계없이 고정 1.00 SocQ 크레딧으로 예산을 잡으세요.

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

다른 플랫폼 둘러보기

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

Rednote Search Users API — 자주 묻는 질문

Rednote Search Users API는 텍스트 검색어 하나로 공개 Rednote 계정을 찾아 정규화된 계정 레코드를 반환합니다.

필수이며 비어 있지 않은 query 문자열 하나만 받습니다. 열거형, results_limit, 제공처 커서, 정렬, 필터 필드는 지원하지 않습니다.

아니요. 제공처 입력은 1페이지로 고정되어 있으며, 공통 작업 결과의 next_cursor와 has_more는 이미 저장된 SocQ 레코드에 대한 페이지네이션만 나타냅니다.

계정 스키마에는 식별 정보, 사용자 이름, 표시 이름, 소개, 공개 URL, 프로필 이미지, 웹사이트, 인증·비공개 플래그, 위치, 공개된 팔로워·팔로잉·게시물 수가 포함될 수 있으며, 값이 있으면 수집 맥락도 함께 제공됩니다.

성공한 작업 1건마다 고정으로 1.00 SocQ 크레딧이 차감되며, 결과 수나 선택 필드의 제공 여부와는 관계가 없습니다.