독립 아카이브로 커뮤니티의 토론 언어 비교하기

gardening의 soil 검색부터 시작해 커뮤니티별 응답을 같은 조건으로 살펴보세요. Subreddit API의 과거 아카이브, 조회 한도, 비용과 비교 연구의 주의점을 설명합니다.

요청 예제

cURL

curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.subredditapi.com/v1/search?q=soil&subreddit=gardening&limit=3"

커뮤니티 쿼리 준비 공간

이 로컬 목록은 쿼리 대상이며 검증된 아카이브 목록이 아닙니다. Gardening은 예시이고 기록이 없을 수 있습니다. 같은 필터도 동일한 범위나 대표 표본을 증명하지 않습니다.

이름은 이 페이지 안에서만 알파벳순으로 묶습니다. 이동 링크가 없는 색인 글자는 아카이브 상태를 뜻하지 않습니다.

로컬 쿼리 대상

G

gardening

코드 미리보기만 제공합니다. q=soil과 limit=3은 고정되며 API로 전송하지 않습니다. 키를 요청하거나 저장하지 않습니다.

첫 번째 요청: gardening

curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.subredditapi.com/v1/search?q=soil&subreddit=gardening&limit=3"

다른 커뮤니티 이름을 추가해 별도의 두 번째 요청을 준비하세요.

두 번째 요청:

API 키 받기

역사적 아카이브의 본질과 구조적 한계

Subreddit API는 Reddit 공식 서비스가 아닌 독립적인 과거 아카이브입니다. 실시간 업데이트를 제공하지 않으며, 기록이 영구히 저장되거나 바뀌지 않는다고 보장하지 않습니다. 연구자는 실제로 받은 응답과 선택 조건을 보관하고 그 범위 안에서 해석해야 합니다. 같은 검색이 나중에 동일한 결과나 순서를 반환한다고 가정하지 마세요. 저장한 입력을 다시 분석하는 것과 원격 검색을 다시 실행하는 것은 서로 다릅니다.

레코드는 아카이브 문서 순서로 반환되며 시간순, 관련도순, 점수순이 아닙니다. 요청당 최대 100개 레코드, 쿼리당 최대 100페이지를 허용합니다. 이 범위를 반복해도 모든 일치 기록을 얻는다는 뜻은 아닙니다. 제한의 원인을 물리적 저장 구조로 추정하거나 전체 수집을 보장한다고 해석하지 마세요. 응답과 페이지 기록을 함께 남기면 무엇을 실제로 분석했는지 나중에 확인하는 데 도움이 됩니다.

Reddit OAuth, 게시, 투표, 비공개 메시지는 지원하지 않습니다. 응답은 서버가 만든 대화 트리가 아닌 평면 JSON 레코드입니다. parent_id나 link_id가 있으면 클라이언트에서 로컬로 묶을 수 있지만 부모 기록이나 대화의 앞부분이 없을 수도 있습니다. 없는 맥락을 추정으로 채우지 말고 불명으로 기록하세요. API는 감정 분석이나 커뮤니티 비교 지표를 만들지 않으며, 연구자가 받은 텍스트를 직접 분석할 수 있습니다.

연구자를 위한 고급 필터링 워크플로

첫 요청 예시는 https://api.subredditapi.com/v1/search?q=soil&subreddit=gardening&limit=3입니다. q=soil은 텍스트 검색, subreddit=gardening은 대상 커뮤니티, limit=3은 최대 결과 수입니다. 3개의 존재나 대표성을 보장하지 않습니다. 비교할 두 번째 커뮤니티에는 별도 요청을 보내고 subreddit만 바꾸며 선택한 다른 조건은 맞추세요. 두 응답의 출처를 로컬 파일에 구분해서 적으면 이후 단어를 세거나 주제를 분류할 때 출처가 섞이는 일을 줄일 수 있습니다.

/v1/subreddits의 prefix와 limit는 커뮤니티 이름을 찾는 용도입니다. 본문 접두어 검색이나 author, kind 필터를 제공하는 경로가 아닙니다. 토론 검색은 /v1/search에서 q, subreddit, author, kind, from, to, min_score, limit, page를 사용합니다. kind는 post 또는 comment입니다. min_score는 필터일 뿐 정렬이나 중요도 판정이 아닙니다. 커뮤니티마다 점수 관행이 다를 수 있으므로 같은 임곗값이 같은 의견의 중요성을 뜻한다고 보지 마세요.

/v1/item에는 알려진 기록의 id가 필요하며 이는 API 인증 키와 다른 값입니다. /v1/posts와 /v1/comments에는 id를 사용하지 않습니다. 총수 관계 eq는 정확한 값, gte는 하한, unknown은 알 수 없음을 뜻하고 총수가 null일 수 있습니다. 정확한 총수도 클라이언트가 모두 저장했다는 증거는 아닙니다. 동일한 날짜 조건을 적용해도 범위 편향이 사라지거나 두 표본이 전체 커뮤니티를 대표한다고 보장되지 않습니다.

투명한 가격 정책 및 계정 구조

성공한 조회는 빈 결과도 1크레딧을 사용합니다. 1000회는 $1, 1크레딧은 $0.001이며 최소 유료 충전 $50은 50000크레딧입니다. 구독은 없고 유료 크레딧은 만료되지 않습니다. 가입과 키 표시에 결제는 필요하지 않습니다. 네트워크 전체 남용 방지 조건을 충족하는 계정은 100크레딧 체험을 받을 수 있으나 모든 신규 가입에 보장되지 않습니다. 두 커뮤니티를 각각 성공적으로 조회하면 각각의 요청이 과금됩니다.

조회에는 Authorization: Bearer YOUR_API_KEY 또는 X-API-Key: YOUR_API_KEY를 사용할 수 있습니다. 둘 다 유효하며 실제 키는 비공개 서버 설정에 보관하세요. 충전하려면 로그인 후 청구서를 만들고 USDT TRON TRC20 또는 USDC 이더리움 메인넷 ERC20을 선택합니다. 현재 청구서의 주소와 정확한 금액으로 송금한 뒤 거래 해시를 제출해 검증을 요청하세요. 확인된 실제 송금을 서버가 검증해야 잔액에 반영되며 정해진 확인 시간은 없습니다.

키는 결제 전 가입 직후 한 번 표시되고, 로그인 후 비밀번호 확인으로 재생성하면 이전 키가 즉시 무효화됩니다. 키와 잔액은 subredditapi.com 전용입니다. localStorage의 사용자 ID와 청구서 ID는 청구서 복구용이며, 로그인은 Secure HttpOnly 쿠키를 사용합니다. 잘못된 요청은 차감하지 않고 상위 실패는 예약분을 반환합니다. 클라이언트가 응답을 잃어도 과금된 성공이 있을 수 있어 성공한 재시도는 새 크레딧을 사용합니다.