rednote/
home-recommendations

시드 검색어 없이 공개 Rednote 홈 추천 페이지를 한 페이지 분량 수집하고, 정규화된 게시물, 작성자, 미디어, 참여 지표, 수집 시각 필드를 읽습니다.

Rednote Home Recommendations API

시드 불필요
1페이지 피드
정규화된 게시물
요청당 1 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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 사용 방법

검증된 선택 값만 골라 비동기 요청을 제출하고, 저장된 표준 결과를 읽습니다.

  1. 백엔드 기본값으로 시작하거나, category, media_type, results_limit을 직접 지정합니다.
  2. JSON 본문을 /v1/rednote/home-recommendations로 POST하고, 제출 응답의 data.task_id를 저장합니다.
  3. 작업이 성공하거나 실패를 보고할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 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 only

Rednote 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 크레딧으로 예산을 잡으세요. 선택한 결과 수 제한이나 반환된 항목 수에 따라 요금이 늘어나지 않습니다.

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

다른 플랫폼 둘러보기

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

Rednote Home Recommendations API — 자주 묻는 질문

Rednote Home Recommendations API는 공개 Rednote 홈 추천 페이지 하나를 정규화된 게시물 레코드로 수집합니다.

아니요. 지원되는 세 필드는 모두 선택 값이며, 빈 JSON 본문을 보내면 제공처의 homefeed_recommend 카테고리와 20개 항목 요청 크기가 사용됩니다.

공개 검증기는 비어 있지 않은 category 문자열을 받지만, 백엔드가 안정적인 기본값으로 정의한 것은 homefeed_recommend뿐입니다. 이 페이지는 외부 조사로 알게 된 추가 category 값을 보장하지 않습니다.

검증기는 video를 받지만, 현재 제공처 변환은 video와 all을 같은 false 플래그로 매핑합니다. 이 플래그를 바꾸는 값은 image뿐이므로 동영상만 반환된다는 보장은 없습니다.

아니요. 제공처 호출은 단일 페이지이며, next_cursor는 공통 SocQ 작업 결과 리더에 속해 완료된 작업에 이미 저장된 레코드만 넘겨 봅니다.

아니요. 로그인 상태, 사용자 신원, 계정 작업, 게시 명령, 모더레이션 설정은 받지 않습니다.

작업 1건마다 고정으로 1.00 SocQ 크레딧이 사용되며, results_limit이나 반환된 레코드 수와는 관계가 없습니다.