인증, 날짜 경계와 아카이브 응답 해석

Reddit Posts API의 두 인증 헤더와 조회 경로, UTC의 from/to 날짜, 페이지 한도를 설명합니다. 총수 관계와 HTTP 오류, 성공한 빈 결과의 과금도 확인하세요.

API 엔드포인트

메서드	엔드포인트	매개변수
`GET`	`/v1/search`	`q, subreddit, author, kind, from, to, min_score, limit, page`
`GET`	`/v1/posts`	`q, subreddit, author, kind, from, to, min_score, limit, page`
`GET`	`/v1/comments`	`q, subreddit, author, kind, from, to, min_score, limit, page`
`GET`	`/v1/item`	`id`
`GET`	`/v1/subreddits`	`prefix`
`GET`	`/v1/status`	`—`

쿼리 매개변수

매개변수	값 / 유형 / 범위
`q`	`text`
`subreddit`	`keyword`
`author`	`keyword`
`kind`	`post \| comment`
`from`	`ISO date`
`to`	`ISO date`
`min_score`	`integer`
`limit`	`1–100`
`page`	`1–100`
`id`	`item ID`
`prefix`	`subreddit prefix`

인증 및 권한 부여 구조

보호된 조회에는 Authorization: Bearer YOUR_API_KEY 또는 X-API-Key: YOUR_API_KEY를 사용할 수 있습니다. 둘 다 유효합니다. /v1/status는 공개이며 키가 필요하지 않고 무료입니다. HTTP 401은 키가 없거나 유효하지 않다는 뜻이며 계정 화면의 로그인 세션과 별개입니다. 키와 잔액은 redditpostsapi.com에서만 유효합니다. 실제 키를 공개 코드, URL 또는 다른 사람과 공유할 분석 자료에 넣지 마세요.

가입은 이메일과 UTF-8 기준 12–72바이트 비밀번호를 사용합니다. 문자 수가 아닙니다. Google 로그인이나 지갑 연결은 제공하지 않습니다. 키는 결제 전에 한 번 표시되고 이메일로 보내지지 않습니다. 로그인한 사용자는 비밀번호 확인 후 새 키를 만들 수 있으며 이전 키는 즉시 무효화됩니다. 일반 로그인으로 기존 키를 다시 표시하는 기능은 없고, 비밀번호 재설정도 제공하지 않습니다.

계정 패널은 Secure HttpOnly 세션 쿠키를 사용합니다. localStorage에는 저장된 청구서를 복구하는 사용자 ID와 청구서 ID를 호스트별로 보관하며 원본 API 키는 영구 저장하지 않습니다. 서버는 비밀번호 해시, 키 해시와 접두 부분, 사용 기록을 저장합니다. 계정 세션과 조회 키 인증은 다른 방식입니다. 자신의 키 사본을 보호하고 로컬 분석 로그에는 요청 조건과 실제 응답만 남기세요.

엔드포인트, 필터 및 데이터 구조

주요 엔드포인트로는 /v1/search, /v1/posts, /v1/comments, /v1/item, /v1/subreddits 및 /v1/status가 있습니다. 검색 쿼리에는 q, subreddit, author, kind 등의 필터가 지원되며, kind 값은 post 또는 comment로 제한됩니다. /v1/posts와 /v1/comments는 id 매개변수를 요구하지 않으며, id는 오직 /v1/item 엔드포인트에서만 필요합니다. 또한 /v1/subreddits는 접두어 검색을 지원합니다.

일괄 처리 한도는 요청당 최대 100개 레코드, 쿼리당 최대 100페이지로 제한됩니다. 응답은 서버에서 구성된 스레드 트리가 아닌 평면 기록의 형태를 띱니다. 클라이언트는 parent_id와 link_id 필드가 있는 경우 로컬에서 그룹화할 수 있지만, 이는 전체 대화나 계승 관계를 보장하지 않습니다. 노출된 link_id나 parent_id 쿼리 필터는 존재하지 않으므로 클라이언트 측 처리가 필요합니다.

순서는 시간순, 관련도순 또는 점수순이 아닌 아카이브 문서 순서입니다. min_score는 정렬하지 않고 필터링만 합니다. 총수 관계 eq는 정확한 일치 기록 수, gte는 하한, unknown은 신뢰할 수 있는 총수를 알 수 없음을 뜻하고 총수가 null일 수 있습니다. 이 값은 총 페이지 수가 아닙니다. 하한이 우연히 정확한 수와 같을 수 있어도 정확한 값으로 인증된 것은 아니며, 정확한 총수도 모두 저장했다는 증거는 아닙니다.

오류 코드 및 과금 정책

HTTP 400은 잘못된 요청, 401은 키 누락 또는 무효, 402는 잔액 부족, 429는 요청 속도 제한입니다. 코드는 ASCII 숫자로 표시합니다. 잘못된 요청은 차감되지 않고 상위 데이터 소스의 실패는 예약 크레딧을 반환합니다. 클라이언트 연결이 끊겨도 서버에서 유료 성공이 있었을 수 있습니다. 이후 성공한 재시도는 새 크레딧이 필요합니다. 유효한 키만으로 성공이나 특정 기록의 존재가 보장되는 것은 아닙니다.

성공한 조회는 빈 결과라도 1크레딧이며 1000회는 $1, 1크레딧은 $0.001입니다. 최소 유료 충전 $50은 50000크레딧입니다. 구독은 없고 유료 크레딧은 만료되지 않습니다. 가입과 키 표시에 충전은 필요하지 않습니다. 100크레딧 체험은 네트워크 전체 남용 방지 조건을 충족하는 경우에 한합니다. 이 과금 규칙은 돌아오는 기록의 개수나 장비 관련성, 내용의 정확성을 보증하지 않습니다.

조회 날짜의 from과 to는 UTC의 YYYY-MM-DD이며 to 날짜도 포함합니다. 결제는 로그인 후 청구서를 만들어 USDT TRON TRC20 또는 USDC 이더리움 메인넷 ERC20으로 현재 수신자에게 정확한 금액을 보낸 뒤 거래 해시를 제출하세요. 청구서는 한 시간에 만료되고 고정 확인 시간은 없습니다. /v1/status는 무료의 정적 안내와 HTTP 응답일 뿐 검색 상태를 검사하지 않습니다. 조회 결과를 검증한 뒤 로컬 진행 상태를 갱신하세요.