Reddit Trending Searches
Reddit 트렌드 검색어는 Reddit이 오늘의 트렌드로 표시하는 짧은 검색어 목록으로, 보통 6개 안팎이며 각각 목록 내 순위와 해당 검색 결과 링크가 붙어 있고 진행 중인 뉴스, 제품 출시, 문화적 화제를 가리키는 경우가 많습니다. 하루 동안 여러 번 기록하면 Reddit 사용자들이 지금 무엇을 찾아보는지 드러나므로 트렌드 대시보드, 시의성 있는 콘텐츠 기획, 관심 주제가 떠오를 때의 알림에 활용할 수 있습니다.
Reddit Trending Searches API 주요 기능
- 준비할 입력값 없음요청 본문이 비어 있으므로 별도 설정 없이 스케줄러에서 그대로 호출할 수 있습니다.
- Reddit 목록 순서 그대로의 순위rank 값은 1부터 시작하며 Reddit이 트렌드 검색어를 나열하는 순서를 따릅니다.
- 검색어마다 붙는 검색 링크keyword 값에는 검색어가, url 값에는 해당 Reddit 검색 결과 주소가 담겨 있어 각 트렌드에서 그 뒤의 대화로 바로 이동할 수 있습니다.
Reddit Trending Searches API 매개변수
바로 실행 가능
이 엔드포인트는 요청 매개변수가 필요하지 않습니다. 빈 JSON 객체를 그대로 전송하세요.
{}Reddit Trending Searches API 사용 방법
빈 요청을 보내고 현재 트렌드 목록을 읽습니다.
- 빈 JSON 본문 {}을 /v1/reddit/trending-searches로 POST합니다.
- GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
- results.items에서 keyword와 rank 값을 읽고, has_more 값이 true이면 results.next_cursor로 나머지를 가져옵니다.
curl -X POST "https://api.socq.ai/v1/reddit/trending-searches" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'Reddit Trending Searches API 추천 활용 사례
- 트렌드 이력 쌓기: 실행할 때마다 keyword, rank, collected_at 값을 저장해 주제가 목록에 얼마나 오래 머물고 순위가 어떻게 오르내리는지 차트로 그립니다.
- 시의성 있는 게시물·기사 기획: 매일 아침 현재 keyword 목록을 확인해 그날 게시물, 뉴스레터 항목, 해설 글로 다룰 만한 진행 중인 주제를 정합니다.
- 관심 주제 트렌드 알림: 각 keyword 값을 브랜드, 제품, 업계 용어 목록과 대조하고, 그중 하나가 트렌드에 오르면 팀에 알립니다.
Reddit Trending Searches API 활용 팁
- 저장한 행은 keyword와 collected_at 값을 함께 키로 쓰세요. id 값이 검색어와 같아서 같은 검색어가 이후 스냅숏에 다시 나타납니다.
- 트렌드 뒤에 있는 게시물과 그 텍스트, 작성자, 참여도가 필요하면 keyword 값을 Reddit Search API의 query로 넘기세요.
관련 API
Reddit Trending Searches API 외에 Reddit의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Reddit Posts API — 지원되는 Reddit URL에서 공개 게시물 텍스트, 작성자, 커뮤니티 맥락, 미디어, 타임스탬프, 공개된 참여도를 수집합니다.
- Reddit Search API — 텍스트 검색어와 게시 기간으로 공개 Reddit 게시물을 검색하고, 정규화된 콘텐츠, 작성자, 커뮤니티 맥락, 타임스탬프, 미디어, 공개된 참여도를 반환합니다.
- Reddit Subreddit Details API
- Reddit Subreddit Search API
- Reddit Popular Feed API — r/popular 게시물을 hot, best, new, rising, top 순으로 수집하며 제목과 본문, 작성자, 점수, 댓글 수, 미디어를 포함합니다.
- Reddit Answers API — 질문을 보내면 인용 댓글, 출처 게시물, 추천 서브레딧과 함께 Reddit의 AI 답변을 받습니다.