독립적 역사 아카이브의 특성과 비교 분석의 필요성
서브레딧 API는 공식 레딧 서비스와 직접적인 연관이 없는 독립적인 역사적 아카이브입니다. 실시간 데이터가 아닌 과거에 수집된 레코드에 접근하므로, 최신 뉴스나 현재 진행 중인 토론을 실시간으로 추적하는 용도와는 다릅니다. 이러한 아카이브의 성격을 이해하는 것은 연구자가 데이터를 올바르게 해석하는 데 가장 먼저 필요한 기본 전제입니다.
Reddit OAuth, 게시, 투표, 비공개 메시지는 지원하지 않습니다. 연구자는 실제 응답의 범위에서만 비교하고 자료의 정확성이나 완전성을 가정하지 않아야 합니다. 필터를 맞춰도 범위 편향이 사라지거나 대표성이 보장되지는 않습니다. 같은 조건이 항상 같은 결과를 주지도 않습니다. 받은 응답, 요청 조건, 수신 시각, 분석 규칙을 로컬에 남기면 이후 해석을 검토할 수 있습니다. 이는 원격 아카이브의 불변성을 증명하는 절차가 아닙니다.
아카이브 문서 순서는 시간순, 관련도순, 점수순이 아닙니다. 날짜 조건을 사용해 범위를 정할 수 있지만 전체 대화의 시간 흐름을 복원한다고 단정하지 마세요. 먼저 어떤 텍스트를 비교할지, 빈 값과 언어 혼합을 어떻게 처리할지 정합니다. 로컬에서 단어 빈도나 주제 라벨을 만들 수 있지만 API가 분석 지표를 제공하는 것은 아닙니다. 계산하지 않은 차이나 전체 커뮤니티의 의견을 결과로 제시하지 마세요.
일관된 필터를 활용한 서브레딧 비교 방법론
첫 예시는 https://api.subredditapi.com/v1/search?q=soil&subreddit=gardening&limit=3입니다. q는 검색어, subreddit은 한 커뮤니티, limit는 최대 결과 수를 지정합니다. 비교할 두 번째 커뮤니티에는 이름만 바꾼 별도 요청을 보내고 나머지 선택 조건은 맞추세요. 한 필터 값에 여러 이름을 넣을 수 있다고 가정하지 마세요. 이 작은 예시는 요청을 설명하기 위한 것이며 3개의 존재, 대표성이나 실제 분석 결과를 뜻하지 않습니다.
from과 to는 UTC 달력의 YYYY-MM-DD 형식이며 to 날짜도 포함됩니다. 두 커뮤니티에 같은 기간과 kind, min_score, limit 및 페이지 예산을 적용하세요. kind는 post 또는 comment입니다. 조건의 일치는 비교 의도를 설명하지만 표본의 범위를 같게 하거나 순서 및 누락 편향을 제거하지는 않습니다. 받은 기록 수가 다르면 그대로 보고하고, 곧바로 전체 활동량의 차이로 해석하지 마세요. 어떤 페이지가 실패했는지도 적어 두세요.
min_score는 지정된 점수의 하한으로 필터링하며 정렬하지 않습니다. 임곗값은 낮은 점수의 문장을 제외하므로 비교 대상의 어휘 구성을 바꿀 수 있습니다. 같은 점수가 두 커뮤니티에서 같은 지지나 중요도를 나타낸다고 가정하지 마세요. 점수만으로 중요한 논거 또는 대표 의견이라고 판단할 수 없습니다. 주제를 분류했다면 라벨 기준, 제외된 문장과 문맥 부족 사례를 기록하고, 결론을 실제로 받은 자료의 범위로 한정하세요.
연구의 효율성을 높이는 모범 사례 및 한계
커뮤니티 이름을 찾을 때는 /v1/subreddits의 prefix와 limit를 사용하세요. 이 경로는 kind나 author를 받는 토론 검색이 아닙니다. 발견한 이름을 선택한 뒤 /v1/search나 해당 목록 경로로 별도 조회합니다. 이름의 순서가 알파벳순이거나 집계가 전역적으로 정확하다고 보장되지 않습니다. 요청당 최대 100개 레코드, 쿼리당 최대 100페이지를 받아도 전부 수집했다는 증거는 아닙니다. eq는 정확한 총수, gte는 하한, unknown은 알 수 없음을 나타내며 총수가 null일 수 있습니다.
평면 응답에 parent_id나 link_id가 있으면 로컬 또는 클라이언트 측에서 관계를 묶을 수 있지만 이 필드들은 요청 필터가 아닙니다. 부모나 앞선 대화가 없을 수 있어 완전한 맥락을 보장하지 않습니다. 데이터를 저장한 뒤 진행 지점을 갱신하고, 사용 가능한 식별자가 있다면 중복 처리 규칙을 기록하세요. 페이지 재개나 기간 분할만으로 누락과 중복을 방지한다고 가정하지 마세요. 원본과 비교용 표를 별도 보관하면 변환 과정도 검토하기 쉽습니다.
Authorization: Bearer YOUR_API_KEY 또는 X-API-Key: YOUR_API_KEY가 유효하며 실제 키는 비공개로 보관하세요. HTTP 400이면 조건, 401이면 키, 402이면 잔액을 확인하고 429이면 기다리세요. 잘못된 요청은 과금하지 않고 상위 실패는 예약분을 반환합니다. 응답 상실 뒤 성공한 재시도는 유료입니다. /v1/status는 무료 정적 안내와 HTTP 확인일 뿐 검색 상태는 검사하지 않습니다. 문서에서 조건, 가격 페이지에서 예산, 키 페이지의 계정 패널에서 키 교체 절차를 확인하세요.
