경로와 인증
조회 호스트는 https://api.redditdatasets.com 입니다. GET /v1/search는 일반 검색, /v1/posts는 게시물, /v1/comments는 댓글입니다. /v1/item?id=...는 알려진 식별자로 한 항목을 조회하고 /v1/subreddits?prefix=...는 커뮤니티 이름을 접두어로 찾습니다. /v1/status는 정적인 서비스 범위를 설명합니다. 독립적인 과거 아카이브이며 Reddit의 공식 서비스가 아닙니다. 실시간 자료, Reddit OAuth, 쓰기, 투표와 메시지를 제공하지 않습니다. 이 경로는 조건에 맞는 기록을 조회하는 기능으로 완성된 라벨 자료나 일괄 다운로드와 구분해야 합니다. 무작위 표집이나 불변 버전을 만드는 경로도 없으며 출처 메모와 주석 기준은 이용자가 작성합니다.
Authorization: Bearer YOUR_API_KEY와 X-API-Key: YOUR_API_KEY는 모두 유효합니다. 이 도메인의 아카이브 키를 사용하고 Reddit OAuth 토큰은 넣지 않습니다. 실제 값은 서버에서 설정하고 공유 파일과 로그에서 제외하세요. 패널의 Secure HttpOnly 세션 쿠키는 별도입니다. 계정과 키, 잔액은 다른 브랜드와 공유할 수 없습니다. https://api.redditdatasets.com/v1/comments?subreddit=MachineLearning&limit=3 은 댓글을 최대 세 건 요청하는 주소입니다. 세 건의 반환이나 무작위 선택을 보장하지 않습니다. 대상 커뮤니티, 요청 상한과 실제 저장 건수를 출처 메모에서 구분하고 응답에 있는 항목만 자료 설명에 사용하세요.
필터, 순서와 범위
검색, 게시물과 댓글의 필터는 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도 응답의 관계 항목이지 쿼리 매개변수가 아닙니다. 날짜 분할은 계획 수단이고 마지막 기록의 날짜가 이전 기간의 전량 수집이나 새 자료의 안전한 경계를 입증하지는 않습니다. 지원되지 않는 시각 정밀도를 가정해서도 안 됩니다.
요청당 최대 100개 레코드와 쿼리당 최대 100페이지이며 각 페이지는 별도 호출입니다. 문서 순서는 시간순, 관련도순이나 점수순이 아닙니다. eq는 정확한 총계, gte는 하한, unknown 또는 null은 신뢰할 총계를 알 수 없는 상태입니다. 정확한 수라도 전량 저장을 증명하지 않습니다. 관계 정리는 선택 사항이며 읽기와 집계에는 트리가 필요 없고 누락된 부모도 복원되지 않습니다. 페이지 반복과 중복 제거로 완전성이나 수집의 유일성을 증명할 수 없고 커뮤니티 집계도 정확한 전체 재고로 보장되지 않습니다. 접두어 검색도 완전한 알파벳순 목록이 아닙니다.
API 응답은 플랫 레코드 형태로 제공되며, 이는 서버에서 조립된 스레드 트리가 아님을 의미합니다. 부모 ID와 링크 ID 필드가 있는 경우 클라이언트에서 이를 사용하여 관계를 구축할 수 있지만, 이것이 완전한 대화 구조를 보장하는 것은 아닙니다. 노출된 링크 ID 또는 부모 ID 쿼리 필터가 없으며, 검색 시 이러한 필드는 데이터 해석을 위한 보조 역할만 수행합니다. 이는 복잡한 계층적 쿼리 대신 단순한 데이터 추출에 적합합니다.
오류, 비용과 파일 상태
성공한 조회는 빈 결과도 한 크레딧이고 1,000건은 $1입니다. 유효하지 않은 요청은 차감되지 않고 상위 시스템 실패의 예약분은 반환됩니다. 클라이언트 시간 초과가 서버 실패의 증거는 아닙니다. 응답 유실 뒤의 성공한 재시도는 추가 비용일 수 있습니다. 읽기 전용이어도 같은 응답이나 무료 반복은 보장되지 않습니다. API 결과, 로컬 저장, 텍스트 정리와 주석 판단을 구분하세요. 저장된 응답의 재처리는 새 호출이 아닙니다. 로컬 버전 이름은 서버의 고정 자료나 미래의 동일한 재조회를 보장하지 않습니다. 실제 검토한 사본과 변환 내역을 함께 구분해서 기록해야 합니다.
400은 매개변수 수정, 401은 키 확인, 402는 잔액 확인, 429는 빈도 감소가 필요합니다. 시도 횟수와 중단 조건을 정하고 다른 계정으로 제한을 피하지 마세요. /v1/status는 공개 비과금이어도 정적인 범위와 HTTP 응답만 알리며 검색, 기록, 키와 잔액은 검사하지 않습니다. 작업의 각 단계에서 실제 성공 여부를 확인하세요. 완전성, 영구 보존, 불변성, 일정한 성능과 지속적인 가용성은 보장되지 않습니다. 정기 요청은 실시간 변경 기록이나 갱신 빈도의 증거도 아닙니다. 인증 비밀 값을 제외하고 조건과 중단 이유를 기록해야 합니다.
