reddit/
trending-searches

아무 입력 없이 오늘 Reddit에서 뜨는 검색어를 가져오며, 검색어마다 Reddit 목록상의 순위와 해당 검색 결과로 가는 링크를 반환합니다.

Reddit Trending Searches API

입력 없이 사용 가능
순위 목록
검색 결과 링크
요청당 0.5 크레딧
준비됨
README

SocQ 작성 · 업데이트

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

빈 요청을 보내고 현재 트렌드 목록을 읽습니다.

  1. 빈 JSON 본문 {}을 /v1/reddit/trending-searches로 POST합니다.
  2. GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
  3. 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로 넘기세요.

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 답변을 받습니다.

다른 플랫폼 둘러보기

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

Reddit Trending Searches API — 자주 묻는 질문

Reddit Trending Searches API는 입력 없이 Reddit이 오늘의 트렌드로 나열하는 검색어를 가져오는 프로그래밍 인터페이스입니다. 검색어마다 순위와 해당 Reddit 검색 결과 링크를 반환합니다.

보통 6개이며, Reddit이 보여 주는 현재 목록 그대로 1위부터 Reddit의 나열 순서에 따라 순위가 매겨집니다.

목록에 있는 검색어 수와 관계없이 호출 한 번에 0.5 크레딧이 고정으로 청구됩니다.