reddit/
search

검색어와 게시 기간으로 공개 Reddit 게시물을 검색하고, 정규화된 제목, 본문, 작성자, 커뮤니티 정보, 타임스탬프, 미디어, 공개된 참여 지표를 반환합니다.

Reddit Search API

게시물 검색
게시 기간
탐색 컨텍스트
결과당 0.6 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Reddit Search

Reddit 검색 결과는 텍스트 검색어와 일치하는 공개 게시물로, 제목, 본문, 작성자, 서브레딧 정보, 미디어, 게시 시각, 공개된 투표 수와 댓글 수를 담고 있습니다. 이러한 레코드는 주제 탐색, 출처 검토, 기간별 리서치, 정해 둔 검색어 간 참여도 비교에 활용할 수 있습니다.

Reddit Search API 주요 기능

  • 검색어 기반 게시물 탐색게시물이나 서브레딧 URL을 지정하지 않고도, 비어 있지 않은 텍스트 검색어 하나로 공개 Reddit 게시물을 찾습니다.
  • 게시 기간 필터최근 1시간, 1일, 1주, 1개월, 1년으로 탐색 범위를 제한하거나, all로 지원되는 전체 기간을 대상으로 합니다.
  • 결과 수 상한 지정results_limit 값을 1에서 2,000 사이로 설정해 검색어 하나에 대해 요청할 최대 게시물 수를 제어합니다.
  • 정규화된 게시물과 탐색 컨텍스트게시물 내용, 작성자·커뮤니티 필드, 미디어, 타임스탬프, 공개된 참여 지표, 탐색 입력값을 일관된 레코드로 반환합니다.

Reddit Search API 매개변수

매개변수필수설명
query필수공개 Reddit 게시물을 찾는 데 사용하는 텍스트로, 비어 있지 않아야 하는 필수 값입니다.
results_limit선택요청할 최대 게시물 수입니다. 기본값은 100이며 1에서 2,000 사이의 정수를 사용할 수 있습니다.
published_within선택일치하는 게시물의 게시 기간입니다. 기본값은 all이며 hour, day, week, month, year, all을 지원합니다.

Reddit Search API 사용 방법

원하는 기간과 결과 수 상한을 지정해 구체적인 검색어를 제출하고, 완료된 비동기 작업에서 정규화된 게시물 레코드를 읽습니다.

  1. 비어 있지 않은 텍스트 검색어 하나를 준비하고, 필요하면 published_within 기간과 results_limit을 선택합니다.
  2. 매개변수를 /v1/reddit/search로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽고, has_more가 true인 동안 반환된 next_cursor로 다음 결과를 요청합니다.
curl -X POST "https://api.socq.ai/v1/reddit/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"machine learning","results_limit":100,"published_within":"month"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Reddit Search API 추천 활용 사례

  • 주제별 토론 탐색: 게시물 제목, 본문 텍스트, 커뮤니티 이름, 출처 URL을 활용해 정해 둔 주제와 맞는 공개 토론을 찾습니다.
  • 출처를 추적할 수 있는 리서치 데이터셋: 게시물 ID, URL, 작성자, 게시 시각, discovery_input을 보존해 수집한 모든 레코드가 출처와 검색어에 연결된 상태를 유지합니다.
  • 기간별 참여도 비교: published_within을 created_at, collected_at, upvotes_count, comments_count, upvote_ratio와 함께 사용해 범위가 정해진 결과 샘플끼리 비교합니다.

Reddit Search API 활용 팁

  • 일치하는 게시물 텍스트와 커뮤니티 정보를 해석하기 쉽도록, 하나의 리서치 질문을 나타내는 구체적인 검색어를 사용하세요.
  • 필요한 기간에 맞춰 published_within을 고르세요. 기간 제한 때문에 관련 있는 오래된 게시물이 빠질 수 있다면 all로 두세요.
  • results_limit은 요청 상한으로 취급하고, 저장된 결과를 모두 읽으려면 has_more가 false가 될 때까지 작업 결과 커서를 따라 계속 요청하세요.
  • 검색을 반복할 때는 게시물 ID로 중복을 제거하되, 검색어와 관측 시점을 알 수 있도록 extra.discovery_input과 collected_at은 유지하세요.
  • 공개 원본에서 일부 값이 빠질 수 있으므로 작성자, 미디어, 커뮤니티, 타임스탬프, 참여 지표 필드는 null을 허용하도록 처리하세요.

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

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

다른 플랫폼 둘러보기

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

Reddit Search API — 자주 묻는 질문

Reddit Search API는 비어 있지 않은 텍스트 검색어에 선택적인 게시 기간과 결과 수 상한을 더해 공개 게시물을 찾습니다. 정규화된 게시물 내용, 작성자, 서브레딧 정보, 미디어, 타임스탬프, 공개된 참여 지표, 탐색 입력값을 반환합니다.

요청은 query, results_limit, published_within을 받으며 query는 필수입니다. 서브레딧 URL, 콘텐츠 유형, 정렬 옵션은 제공하지 않습니다.

정규화된 게시물마다 ID, URL, 제목, 본문, 작성자, 커뮤니티 정보, 미디어, 게시·수집 시각, 공개된 추천 수와 댓글 수, 추천 비율, 탐색 입력값이 포함될 수 있습니다.

published_within은 hour, day, week, month, year, all을 받습니다. 기본값은 all입니다.

results_limit의 기본값은 100이며, 요청 최대치로 1에서 2,000 사이의 정수를 사용할 수 있습니다. 작업이 성공하면 has_more가 true인 동안 next_cursor로 계속 요청해 저장된 모든 결과 페이지를 읽습니다.

반환된 정규화 검색 결과 1건마다 0.6 SocQ 크레딧이 차감됩니다. 결과가 비어 있으면 결과 요금이 청구되지 않습니다.