reddit/
subreddit-search

검색어, 기간, 정렬 방식으로 특정 서브레딧 한 곳 안의 공개 토론과 게시물을 검색합니다.

Reddit Subreddit Search API

커뮤니티 내 검색
집중형 게시물 탐색
서브레딧 토론
결과당 0.6 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Reddit Subreddit Search

지정한 서브레딧 안에서 검색하면 플랫폼 전체의 잡음에서 벗어나 관련 있는 대화만 골라낼 수 있습니다. 범위를 좁힌 커뮤니티 검색은 정규화된 게시물 제목, 본문, 작성자 핸들, 댓글 수, 추천 수, 미디어 링크를 반환합니다.

Reddit Subreddit Search API 주요 기능

  • 범위를 좁힌 커뮤니티 검색플랫폼 전체가 아니라 지정한 /r/{subreddit} 커뮤니티로 키워드 검색 범위를 제한합니다.
  • 세분화된 정렬 옵션리서치 목적에 맞게 일치한 게시물을 relevance, hot, top, new, 댓글 수 기준으로 정렬합니다.
  • 유연한 기간 필터게시 기간을 1시간, 1일, 1주, 1개월, 1년 또는 전체 기간으로 지정해 결과를 거릅니다.
  • 풍부한 게시물 정보제목, 본문, 작성자, 추천 수, 댓글 수, 퍼머링크가 담긴 정규화된 게시물 레코드를 받습니다.

Reddit Subreddit Search API 매개변수

매개변수필수설명
query필수지정한 서브레딧 커뮤니티 안에서 실행할 검색 키워드입니다.
urls필수검색 범위가 되는 커뮤니티를 정의하는 공개 Reddit /r/{subreddit} URL의 배열입니다.
results_limit선택커뮤니티마다 반환할 최대 게시물 수입니다. 기본값은 100이며 1에서 2,000 사이의 값을 사용할 수 있습니다.
sort_by선택일치한 게시물의 정렬 방식입니다. relevance(기본값), hot, top, new, comments 중에서 선택합니다.
published_within선택게시 기간 필터입니다. all(기본값), year, month, week, day, hour 중에서 선택합니다.

Reddit Subreddit Search API 사용 방법

검색어를 대상 커뮤니티 URL과 함께 비동기 작업으로 제출한 뒤, 일치한 게시물을 가져옵니다.

  1. 검색어를 정하고 urls에 /r/{subreddit} 커뮤니티 URL을 하나 이상 입력합니다.
  2. 필요하면 sort_by(relevance, hot, top, new, comments)와 published_within(hour부터 all까지)을 선택합니다.
  3. SocQ API 키로 /v1/reddit/subreddit-search에 POST 요청을 보냅니다.
  4. /v1/tasks/{task_id}를 폴링하고 next_cursor로 data.results.items를 페이지 단위로 읽습니다.
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"AI agents","urls":["https://www.reddit.com/r/technology/"],"results_limit":20,"sort_by":"relevance"}'

# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.

Reddit Subreddit Search API 추천 활용 사례

  • 커뮤니티 여론 추적: 기술, 금융, 게임 전문 서브레딧의 구성원들이 내 브랜드나 경쟁사에 대해 어떤 이야기를 하는지 모니터링합니다.
  • 고객 문제 발굴: 특정 제품 전문 서브레딧에서 문제 해결과 질문 키워드를 검색해 사용자의 불편 사항을 파악합니다.
  • 특정 분야 아카이브 리서치: 신뢰할 만한 커뮤니티로 범위를 좁혀 특정 기술·문화 주제에 대한 과거의 인기 토론을 가져옵니다.

Reddit Subreddit Search API 활용 팁

  • urls 배열에는 항상 /r/{subreddit} 전체 URL을 넣으세요. 백엔드가 커뮤니티 이름을 자동으로 추출합니다.
  • 커뮤니티 간 잡음을 피하고 서브레딧 한 곳에 집중하고 싶을 때는 Reddit Search 대신 이 엔드포인트를 사용하세요.
  • comments 기준으로 정렬하면 커뮤니티의 의견이 깊이 드러나는 참여도 높은 토론 스레드를 찾는 데 도움이 됩니다.
  • Reddit Comments와 함께 사용하면 찾아낸 가장 관련성 높은 게시물에서 전체 댓글 트리를 가져올 수 있습니다.

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

  • Reddit Comments API — 지원되는 게시물 URL에서 공개 댓글 텍스트, 작성자, 게시물 및 상위 댓글 참조, 커뮤니티 맥락, 타임스탬프, 공개된 참여도를 수집합니다.
  • Reddit Subreddit Posts API — 서브레딧 URL에서 new, top, hot 정렬로 공개 게시물을 찾으며, 서브레딧별 결과 수 제한과 정규화된 커뮤니티 및 참여도 맥락을 포함합니다.
  • Reddit Search API — 텍스트 검색어와 게시 기간으로 공개 Reddit 게시물을 검색하고, 정규화된 콘텐츠, 작성자, 커뮤니티 맥락, 타임스탬프, 미디어, 공개된 참여도를 반환합니다.
  • Reddit Subreddit Details API
  • Reddit Trending Searches API — 입력 없이 오늘 Reddit에서 뜨는 검색어를 순위, Reddit 검색 결과 링크와 함께 가져옵니다.
  • Reddit Answers API — 질문을 보내면 인용 댓글, 출처 게시물, 추천 서브레딧과 함께 Reddit의 AI 답변을 받습니다.

다른 플랫폼 둘러보기

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

Reddit Subreddit Search API — 자주 묻는 질문

Reddit Subreddit Search API는 특정 Reddit 커뮤니티 안의 게시물을 대상으로 키워드를 검색할 수 있게 해 줍니다. 정규화된 게시물 항목, 작성자 데이터, 타임스탬프, 추천 수, 댓글 수를 반환합니다.

Reddit Search는 모든 공개 서브레딧을 한꺼번에 검색하지만, Reddit Subreddit Search는 urls 매개변수에 지정한 커뮤니티로만 검색 범위를 제한합니다.

네. urls 배열에 커뮤니티 링크를 여러 개 넣으면 엔드포인트가 지정한 서브레딧을 각각 검색해 결과를 합쳐 반환합니다.