Rednote Home Recommendations
홈 추천 요청은 프로필, 노트 URL, 검색어 없이도 공개 Rednote 피드 한 페이지를 가져옵니다. 확인 가능한 항목은 모두 원본 식별 정보, 텍스트, 작성자, 미디어, 공개된 참여 지표, 게시 시각, 수집 시각을 갖춘 표준 게시물 레코드로 변환됩니다.
Rednote Home Recommendations API 주요 기능
- 시드 없는 홈 피드 요청빈 본문 또는 검증된 homefeed_recommend 카테고리를 제출하면 사용자나 검색어 입력을 따로 만들지 않고도 현재 추천 페이지 하나를 요청할 수 있습니다.
- 한정된 페이지 크기1에서 40 사이의 정수를 요청하며, 생략하면 20이 사용됩니다. 반환되는 페이지에는 그보다 적은 공개 항목이 들어 있을 수 있습니다.
- 제공처에 독립적인 게시물 구조제공처의 필드 이름 대신 공통 게시물 스키마로 확인 가능한 노트 식별 정보, 텍스트, 작성자, 미디어, 타임스탬프, 공개된 지표를 읽습니다.
- 유지되는 비동기 결과한 번 제출하고 작업 상태를 따라가면, 제공처의 단일 응답을 정규화한 뒤 SocQ가 저장한 레코드를 페이지 단위로 읽을 수 있습니다.
Rednote Home Recommendations API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
category | 선택 | 비어 있지 않은 문자열이며 선택 값입니다. 생략하면 제공처 매핑이 homefeed_recommend를 넣습니다. 여기에 문서화된 백엔드 정의 카테고리는 이것뿐이며, 다른 문자열을 검증된 카테고리로 소개하지는 않습니다. |
media_type | 선택 | all, image, video 중 하나인 선택형 열거값입니다. 현재 매핑은 image일 때만 제공처의 이미지 플래그를 설정하고 all과 video는 둘 다 false로 매핑하므로, video가 동영상만 반환하는 것을 보장하지는 않습니다. |
results_limit | 선택 | 1에서 40 사이의 양의 정수이며 선택 값입니다. 기본값은 20이고 요청하는 제공처 페이지 크기를 정하며, 명시적으로 지정하면 저장되는 행 수의 상한도 됩니다. |
Rednote Home Recommendations API 사용 방법
검증된 선택 값만 골라 비동기 요청을 제출하고, 저장된 표준 결과를 읽습니다.
- 백엔드 기본값으로 시작하거나, category, media_type, results_limit을 직접 지정합니다.
- JSON 본문을 /v1/rednote/home-recommendations로 POST하고, 제출 응답의 data.task_id를 저장합니다.
- 작업이 성공하거나 실패를 보고할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽습니다. has_more가 SocQ에 저장된 추가 레코드를 가리킬 때만 next_cursor를 따라갑니다.
curl -X POST "https://api.socq.ai/v1/rednote/home-recommendations" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"category":"homefeed_recommend","media_type":"all","results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; next_cursor paginates stored results onlyRednote Home Recommendations API 추천 활용 사례
- 추천 페이지 스냅샷: 범위가 정해진 공개 홈 피드 페이지를 collected_at과 함께 수집해 모든 항목이 하나의 관측 시점에 묶이게 합니다.
- 편집용 탐색 대기열: 정규화된 게시물 텍스트, 작성자, 미디어 참조를 사람이 검토하거나 분류하는 워크플로로 보냅니다.
- 노출 콘텐츠 점검: 별도로 제출한 추천 작업들 사이에서 확인 가능한 미디어 구성과 공개된 참여 지표 필드를 비교합니다.
Rednote Home Recommendations API 활용 팁
- 제공처 기본값을 모두 쓰고 싶다면 {}를 사용하세요. 공개 요청 검증기는 어떤 필드도 필수로 요구하지 않습니다.
- 다른 제공처 카테고리를 직접 검증하지 않았다면 category는 homefeed_recommend로 유지하세요. 런타임은 비어 있지 않은 문자열을 받지만 카테고리 열거값은 공개하지 않습니다.
- media_type=video는 현재 all과 같은 제공처 플래그로 매핑되므로 신중하게 다루세요. 이 플래그를 바꾸는 값은 image뿐입니다.
- results_limit은 1에서 40 사이로 정하되, 제공처가 요청한 수만큼 정확히 공개 항목을 반환한다고 가정하지 마세요.
- 제공처 커서는 보내지 마세요. 업스트림 실행기는 요청을 한 번만 보내고 그 단일 응답에서 items, notes, feeds를 읽습니다.
- next_cursor는 성공 후 SocQ에 저장된 결과를 이어서 읽을 때만 사용하세요. Rednote의 다른 페이지를 가져오지는 않습니다.
- 작업 1건당 고정 1.00 SocQ 크레딧으로 예산을 잡으세요. 선택한 결과 수 제한이나 반환된 항목 수에 따라 요금이 늘어나지 않습니다.
관련 API
Rednote Home Recommendations API 외에 Rednote의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.