경로 입력과 인증
기본 주소는 https://api.redditapihub.com 입니다. GET /v1/search는 게시물과 댓글을 검색하고 /v1/posts는 게시물, /v1/comments는 댓글을 조회합니다. 평면 기록을 반환하며 대화 트리를 조립하지 않습니다. GET /v1/item?id=...는 식별자를 아는 단일 기록을 요청합니다. id는 item 전용이며 posts나 comments 필터가 아닙니다. 각 경로에 맞는 입력을 클라이언트에서 따로 만들고 같은 조건을 무조건 복사하지 마세요.
GET /v1/subreddits?prefix=program&limit=3은 커뮤니티 이름의 시작 부분으로 최대 세 개 결과를 요청합니다. prefix는 게시물 본문의 q 검색이 아닙니다. 커뮤니티 건수가 전체 범위에서 정확하다거나 알파벳 순서가 보장된다는 뜻도 아닙니다. 이를 완전한 아카이브 재고로 해석하지 마세요. 이름에서 다른 데이터 요청으로 넘어가면 그 요청의 조건과 응답을 다시 평가해야 하며 모든 관련 기록의 존재를 가정해서는 안 됩니다.
조회에는 Authorization: Bearer YOUR_API_KEY와 X-API-Key: YOUR_API_KEY가 모두 지원되므로 하나를 선택하세요. 실제 키는 서버 비밀 설정에서 관리합니다. 계정 패널의 Secure HttpOnly 쿠키는 다른 세션을 위한 것이며 이 키 헤더를 대신하지 않습니다. 계정, 키와 잔액은 redditapihub.com 전용입니다. 다른 브랜드의 키로 같은 계정에 접근할 수 없고 URL이나 브라우저 코드에도 비밀을 넣지 않아야 합니다.
검색 필터와 응답 해석
검색, 게시물과 댓글에는 q, subreddit, author, kind, from, to, min_score, limit, page를 사용할 수 있습니다. kind는 post 또는 comment입니다. 날짜는 UTC 기준 YYYY-MM-DD 형식으로 to 날짜를 포함합니다. min_score는 최소 점수 조건이지 정렬이 아닙니다. parent_id와 link_id는 조회 필터가 아닙니다. item이나 커뮤니티 경로도 같은 검색 조건을 전부 받는다고 생각하지 마세요.
limit과 page 파라미터는 각각 1부터 100 사이의 값을 가질 수 있어 한 번의 요청당 최대 100개의 레코드와 쿼리당 최대 100페이지의 분할된 결과를 요청할 수 있습니다. 하지만 페이지 반복이 아카이브의 전체적인 데이터 수집이나 완벽한 검색 결과를 보장하지는 않습니다. 따라서 무한한 데이터 탐색을 위해 페이지를 반복한다고 해서 모든 아카이브가 정밀하게 수집된 것은 아닙니다.
전체 건수에서 eq는 정확한 수, gte는 하한, unknown이나 null은 신뢰할 수 있는 합계가 없는 상태입니다. 합계는 페이지 수가 아니고 정확한 값도 전부 저장했다는 증거는 아닙니다. 결과는 아카이브 문서 순서이며 시간, 관련도나 점수 순서가 아닙니다. 날짜 분할은 전체 수집이나 중복 없는 결과를 보장하지 않습니다. 어떤 조건과 페이지를 저장했는지 자체 기록으로 추적하세요.
평면 기록을 읽고 분류하거나 개수를 세는 데 트리는 필요 없습니다. 관계를 조사하려면 존재하는 parent_id나 link_id로 선택적 로컬 그룹화를 할 수 있지만 빠진 부모나 댓글을 복원하지 않습니다. 기존 필드를 분석에 쓰더라도 서버가 완전한 대화를 조립했다고 가정하지 마세요. 응답에서 실제 이용할 수 있는 정보와 없는 문맥을 구분해 결과 설명에도 남겨야 합니다.
공개 상태와 오류
GET /v1/status는 키 없이 무료로 호출합니다. 고정된 서비스 범위와 HTTP 애플리케이션의 응답을 보여 주고 아카이브 소스, 검색 동작, 기록 존재나 잔액은 검사하지 않습니다. 상태 응답의 성공은 데이터 경로가 작동한다는 증거가 아닙니다. 각 조회의 HTTP 상태와 내용을 자체 문맥에서 평가하고 빈 성공 결과를 오류와 혼동하지 마세요. 키의 유효성도 여기서 확인하지 않습니다.
HTTP 400은 조건 형식이나 값의 문제, HTTP 401은 키 누락 또는 무효, HTTP 402는 잔액 부족, HTTP 429는 요청 속도 제한입니다. 조건과 키는 수정하고 속도 제한에서는 송신을 늦추세요. 잘못된 요청은 차감하지 않으며 상위 소스 장애에는 예약분을 돌려줍니다. 성공한 조회는 빈 결과도 한 크레딧입니다. 클라이언트 응답 유실이 서버의 유료 성공 뒤에 올 수 있고 성공한 재시도는 추가 비용입니다.
