경로와 인증 정보
조회 호스트는 https://api.getredditdata.com 입니다. GET /v1/search는 일반 검색, /v1/posts는 게시물, /v1/comments는 댓글 목록입니다. /v1/item?id=...는 식별자를 아는 한 항목을 찾고 /v1/subreddits?prefix=...는 이름 접두어로 커뮤니티를 좁힙니다. /v1/status는 정적인 서비스 범위를 공개합니다. 독립적인 과거 아카이브이며 공식 Reddit 서비스, 실시간 데이터, OAuth, 쓰기, 투표나 메시지 기능은 없습니다. 받은 기록이 전체 사용자를 대표한다거나 삭제된 모든 콘텐츠를 복구하는 서비스라고 설명하지 마세요. 해당 쿼리로 실제 받은 기록의 범위에서만 분석해야 합니다.
Authorization: Bearer YOUR_API_KEY와 X-API-Key: YOUR_API_KEY는 모두 유효합니다. 이 도메인의 아카이브 키를 사용하고 Reddit OAuth 토큰을 넣지 마세요. 실제 값은 서버에서 추가하며 공개 코드나 표에는 남기지 않습니다. 패널의 Secure HttpOnly 세션 쿠키는 조회 인증과 별도입니다. 계정과 키, 잔액은 다른 브랜드와 공유되지 않습니다. GET https://api.getredditdata.com/v1/search?q=sampling&subreddit=AskStatistics&limit=3 은 무작위 추출이 아니며 세 건도 보장하지 않습니다. 표 변환은 자체 클라이언트가 수행하는 작업이지 준비된 파일이나 자동 분석을 API에서 받는 기능이 아닙니다.
필터와 기록의 의미
검색, 게시물과 댓글의 필터는 q, subreddit, author, kind, from, to, min_score, limit, page입니다. kind는 post 또는 comment입니다. 날짜는 UTC의 YYYY-MM-DD이며 to는 지정일 전체를 포함합니다. min_score는 최소 점수 조건으로 정렬이나 품질 검사가 아닙니다. id는 /v1/item 전용이고 게시물이나 댓글 목록의 식별자 필터는 아닙니다. parent_id와 link_id도 응답의 관계 필드일 뿐 쿼리 매개변수는 아닙니다. 방법 설명에는 필터를 선택한 이유와 제외되는 범위를 남기세요. 지원하지 않는 필터나 번역한 매개변수 이름을 임의로 추가하면 안 됩니다.
총 결과 수는 정확한 일치, 하한선, 또는 알 수 없는 세 가지 관계로 표시될 수 있습니다. 하한선이 포함된 경우 이는 정확한 개수가 아니므로, 데이터의 완전성을 가정해서는 안 됩니다. 페이지 반복이 항상 아카이브의 전체 수집을 의미하는 것은 아니며, 모든 일치하는 기록이 추출된다고 보장되지 않습니다. 따라서 결과를 해석할 때 데이터의 부분성을 고려하여 연구 결론을 도출해야 합니다. eq는 정확한 레코드 총계, gte는 하한, unknown 또는 null은 신뢰할 총계를 알 수 없는 상태입니다. 요청당 최대 100개, 쿼리당 최대 100페이지이며 총계는 페이지 수가 아닙니다. 관계 그룹화는 선택 사항으로 읽기와 집계에는 트리가 필요하지 않고 빠진 부모도 복구되지 않습니다. 커뮤니티 집계나 접두어 검색도 완전한 목록과 정확한 전역 건수로 보장되지 않습니다.
오류, 비용과 상태 확인
성공한 조회는 빈 결과도 한 크레딧이며 성공 요청 1,000건은 $1입니다. 유효하지 않은 요청은 차감되지 않고 상위 시스템 실패의 예약분은 반환됩니다. 클라이언트의 시간 초과는 서버 실패를 증명하지 않습니다. 응답이 유실된 경우 성공한 재시도에는 비용이 추가될 수 있습니다. 읽기 전용이어도 고정 응답이나 무료 반복은 보장되지 않습니다. 조회 결과, 로컬 저장과 표 변환을 나누어 기록하세요. 기존 JSON을 다시 처리하는 것과 새로운 API 요청으로 다시 받는 것은 다릅니다. 저장 실패만으로 서버의 조회까지 실패했다고 판단하면 안 됩니다.
400은 매개변수나 값 수정, 401은 누락되거나 유효하지 않은 키 확인, 402는 잔액 확인, 429는 빈도 감소가 필요합니다. 시도 횟수와 중단 조건을 정하고 다른 계정으로 제한을 피하지 마세요. /v1/status는 공개 비과금 경로지만 정적인 범위와 HTTP 응답만 알리며 검색, 기록, 키와 잔액은 검사하지 않습니다. 날짜 분할과 페이지 반복, 중복 제거도 전체 범위와 수집의 유일성을 보장하지 않습니다. 조건, 받은 페이지, 로컬 변환과 불확실성을 남겨도 미래에 같은 결과를 다시 받을 수 있다는 보장은 생기지 않습니다. 결과의 영구 보존이나 일정한 성능도 약속되지 않습니다.
