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 사용 방법
계정 검색어 하나를 제출하고, 비동기 작업을 따라가며, 저장된 정규화 계정 레코드를 읽습니다.
- 찾으려는 공개 계정, 크리에이터 이름, 브랜드, 주제를 나타내는 비어 있지 않은 검색어 하나를 고릅니다.
- query를 /v1/rednote/search-users로 보내고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패를 보고할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 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 onlyRednote 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 크레딧으로 예산을 잡으세요.
관련 API
Rednote Search Users API 외에 Rednote의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.