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, limit
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
조회 경로와 아카이브 인증
기본 주소는 https://api.redditproxy.com 입니다. GET /v1/search는 게시물과 댓글을 검색하고 /v1/posts는 게시물, /v1/comments는 댓글을 조회합니다. GET /v1/item?id=...는 특정 기록의 식별자를 받습니다. id는 item 전용이며 posts나 comments의 필터가 아닙니다. GET /v1/subreddits?prefix=...는 커뮤니티 이름의 시작 부분으로 조회합니다. limit으로 요청 수를 제한할 수 있지만 커뮤니티 집계 건수의 전체 범위에 대한 정확성은 보장되지 않습니다.
조회에는 Authorization: Bearer YOUR_API_KEY와 X-API-Key: YOUR_API_KEY가 모두 지원되므로 하나를 선택하세요. 여기의 Bearer 값은 redditproxy.com API 키이며 Reddit OAuth 토큰이 아닙니다. 계정 패널의 Secure HttpOnly 세션 쿠키는 다른 용도이며 조회 헤더를 대신하지 않습니다. 키는 서버에서 관리하고 기존 클라이언트의 비밀 정보를 새 URL 매개변수로 추가하지 마세요. 기존 사용자 세션을 전달하는 구조라고 가정해서도 안 됩니다.
GET /v1/status는 공개 경로이며 크레딧을 사용하지 않습니다. 고정된 서비스 범위 안내와 HTTP 애플리케이션의 응답을 보여 줍니다. 아카이브 소스, 쿼리 동작, 기록 존재나 잔액을 검사하지는 않습니다. 데이터 상태를 확인하는 경로로 사용하지 마세요. 실제 조회의 상태와 내용을 별도로 확인해야 하며 status의 성공이 다음 이전 작업에서 필요한 기록을 얻는다는 증거는 아닙니다.
조건과 평면 기록
검색, 게시물과 댓글에는 q, subreddit, author, kind, from, to, min_score, limit, page를 사용할 수 있습니다. kind는 post 또는 comment입니다. 날짜는 UTC 기준 YYYY-MM-DD 형식이며 to 날짜를 포함합니다. min_score는 최소 점수 조건이지 정렬이 아닙니다. parent_id와 link_id는 조회 필터가 아니므로 이를 붙여 전체 대화를 요청하는 기능을 만들 수 있다고 생각하지 마세요.
페이징을 사용할 때 limit과 page 파라미터로 페이지 크기와 번호를 지정합니다. 단일 요청당 최대 100개의 레코드까지 가져올 수 있으며, 단일 쿼리당 최대 100페이지까지 탐색 가능합니다. 페이지네이션 총계는 정확한 값을 제공하지 않을 수 있으며, 하한값이나 알 수 없는 상태로 표시될 수 있습니다. 이는 아카이브의 전체 수량을 확정적으로 나타내지 않습니다.
limit은 1~100, page는 1~100을 받습니다. 페이지는 각각 별도 요청입니다. 전체 건수에서 eq는 정확한 수, gte는 하한, unknown이나 null은 신뢰할 수 있는 합계가 없음을 뜻합니다. 정확한 합계도 클라이언트가 전부 저장했다는 증거는 아닙니다. 날짜 구간 분할과 페이지 반복은 전체 수집이나 중복 없는 결과를 보장하지 않습니다. 실제 저장된 조건과 페이지를 자체 작업 기록으로 추적하세요.
결과는 아카이브 문서 순서이며 시간, 관련도나 점수 순서가 아닙니다. 평면 기록을 읽고 분류하거나 개수를 셀 때 대화 트리는 필요 없습니다. 관계를 보려면 존재하는 parent_id나 link_id로 선택적 로컬 그룹화를 할 수 있지만 누락된 부모는 복원되지 않습니다. 기존 클라이언트의 필수 필드를 검사하고 빠진 정보를 조용히 기본값으로 바꾸는 대신 자체 누락 처리 규칙을 적용하세요.
오류와 크레딧
HTTP 400은 조건 형식이나 값의 문제, HTTP 401은 키 누락 또는 무효, HTTP 402는 잔액 부족, HTTP 429는 요청 속도 제한을 뜻합니다. 기존 클라이언트의 재시도 로직을 그대로 옮기지 마세요. 조건과 키는 수정하고 속도 제한에서는 송신을 늦춰야 합니다. HTTP 응답과 네트워크 연결 실패를 구분하며 비밀 헤더를 기록하지 않고 필요한 상태를 추적하도록 설계하세요.
성공한 조회는 빈 결과도 한 크레딧입니다. 잘못된 요청은 차감하지 않고 상위 소스 장애에는 예약한 크레딧을 돌려줍니다. 그러나 클라이언트의 응답 유실은 서버의 유료 성공을 가릴 수 있으며 성공한 재시도는 별도 크레딧을 사용합니다. 계정, 키와 잔액은 이 도메인 전용입니다. 다른 브랜드의 잔액은 공유되지 않으며 공개 status가 아닌 계정 패널에서 실제 잔액을 확인해야 합니다.
