Reddit Popular Feed
Reddit의 인기 피드인 r/popular는 사이트 곳곳의 커뮤니티에서 동시에 떠오르는 게시물의 흐름으로, 게시물마다 제목과 본문, 작성자, 점수, 댓글 수, 게시 시각, 첨부 이미지나 동영상이 담겨 있습니다. 정렬 방식과 기간을 바꿔 가며 읽으면 플랫폼 전체에서 어떤 이야기와 형식, 주제가 퍼지고 있는지 보이므로 뉴스 조기 포착, 콘텐츠 형식 리서치, Reddit 화제 샘플링에 활용할 수 있습니다.
Reddit Popular Feed API 주요 기능
- r/popular를 읽는 다섯 가지 정렬sort_by 값으로 피드를 best, hot, new, rising, top 중 하나의 순서로 읽으며, 생략하면 hot이 적용됩니다.
- top 정렬용 기간 설정published_within 값은 top 정렬 범위를 지난 1시간, 하루, 1주, 1개월, 1년 또는 전체 기간으로 좁히며 기본값은 day입니다.
- 작성자와 미디어까지 담긴 게시물 레코드각 행에는 제목과 본문이 담긴 text, 게시물 url, 작성자 사용자 이름과 프로필 링크, likes_count 값의 점수, comments_count, 픽셀 크기가 포함된 media가 들어 있습니다.
Reddit Popular Feed API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
sort_by | 선택 | r/popular 정렬 순서로 best, hot(기본값), new, rising, top 중 하나입니다. |
published_within | 선택 | sort_by 값이 top일 때 적용되는 기간으로 hour, day(기본값), week, month, year, all 중 하나입니다. |
results_limit | 선택 | 수집할 최대 게시물 수로 1~500 사이 정수이며 기본값은 25입니다. |
Reddit Popular Feed API 사용 방법
정렬 순서와 수량을 고르거나 빈 본문을 보낸 뒤 피드를 페이지별로 읽습니다.
- {"sort_by": "hot", "results_limit": 25}을 /v1/reddit/popular-feed로 POST합니다.
- GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
- results.items에서 게시물을 읽고, has_more 값이 true인 동안 results.next_cursor로 다음 페이지를 불러옵니다.
curl -X POST "https://api.socq.ai/v1/reddit/popular-feed" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"sort_by":"hot","results_limit":25}'Reddit Popular Feed API 추천 활용 사례
- 정점 전에 뜨는 이야기 포착: sort_by rising이나 new로 주기적으로 조회하며 published_at, likes_count, comments_count 값을 지켜보고 r/popular에서 속도가 붙는 게시물을 찾습니다.
- 주간 인기 게시물 정리: sort_by top과 published_within week로 요청해 지난 7일 동안 떠오른 게시물의 url, text, 점수를 목록으로 만듭니다.
- r/popular에 오르는 게시물 형식 연구: 게시물을 미디어 유형에 따라 이미지, 동영상, 텍스트 전용으로 나누고 그룹별 likes_count와 comments_count 값을 비교합니다.
Reddit Popular Feed API 활용 팁
- published_within을 쓸 때는 sort_by를 top으로 지정하세요. 기간 설정은 top 정렬에만 적용됩니다.
- 스냅숏마다 collected_at 값을 기록하고 id 기준으로 중복을 제거하세요. 빠르게 움직이는 피드에서는 같은 게시물이 연이은 수집에 다시 나타날 수 있습니다.
- 자주 등장하는 작성자가 있으면 author.username 값을 Reddit User Profile API에 보내 카르마와 계정 나이를 확인하세요.
관련 API
Reddit Popular Feed API 외에 Reddit의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Reddit Posts API — 지원되는 Reddit URL에서 공개 게시물 텍스트, 작성자, 커뮤니티 맥락, 미디어, 타임스탬프, 공개된 참여도를 수집합니다.
- Reddit Comments API — 지원되는 게시물 URL에서 공개 댓글 텍스트, 작성자, 게시물 및 상위 댓글 참조, 커뮤니티 맥락, 타임스탬프, 공개된 참여도를 수집합니다.
- Reddit Subreddit Posts API — 서브레딧 URL에서 new, top, hot 정렬로 공개 게시물을 찾으며, 서브레딧별 결과 수 제한과 정규화된 커뮤니티 및 참여도 맥락을 포함합니다.
- Reddit Search API — 텍스트 검색어와 게시 기간으로 공개 Reddit 게시물을 검색하고, 정규화된 콘텐츠, 작성자, 커뮤니티 맥락, 타임스탬프, 미디어, 공개된 참여도를 반환합니다.
- Reddit User Posts API — 사용자 이름 하나로 Reddit 사용자의 게시물 기록을 new, top, hot 순으로 수집하며 제목과 본문, 점수, 댓글 수, 미디어를 포함합니다.
- Reddit Trending Searches API — 입력 없이 오늘 Reddit에서 뜨는 검색어를 순위, Reddit 검색 결과 링크와 함께 가져옵니다.