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과 함께 비동기 작업으로 제출한 뒤, 일치한 게시물을 가져옵니다.
- 검색어를 정하고 urls에 /r/{subreddit} 커뮤니티 URL을 하나 이상 입력합니다.
- 필요하면 sort_by(relevance, hot, top, new, comments)와 published_within(hour부터 all까지)을 선택합니다.
- SocQ API 키로 /v1/reddit/subreddit-search에 POST 요청을 보냅니다.
- /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와 함께 사용하면 찾아낸 가장 관련성 높은 게시물에서 전체 댓글 트리를 가져올 수 있습니다.
관련 API
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 답변을 받습니다.