아카이브 정밀성 및 데이터 접근
Reddit Posts API는 Reddit 공식 서비스와 제휴하지 않은 독립적인 과거 아카이브에 대한 읽기 접근을 제공합니다. Reddit OAuth, 실시간 스트림, 게시, 투표 또는 비공개 메시지는 지원하지 않습니다. 특정 기간의 범위나 계속된 접근, 기록의 불변성도 보장하지 않습니다. 콘텐츠 분석가는 실제로 받은 자료를 기준으로 판단하고, 이용할 수 없거나 필드가 빠진 기록을 방법 노트에 남겨야 합니다.
시작 예시는 https://api.redditpostsapi.com/v1/posts?subreddit=photography&min_score=10&limit=3입니다. subreddit은 커뮤니티, min_score는 점수 하한, limit는 최대 3개를 뜻합니다. 이 조건이 사진 장비 글만 고르거나 3개의 존재를 보장하지는 않습니다. 다른 주제가 포함될 수 있으므로 받은 글을 읽고 장비 관련 여부를 로컬에서 분류하세요. 점수는 제품 품질이나 의견의 진실성, 전체 커뮤니티의 지지를 증명하지 않습니다.
응답은 서버가 만든 대화 트리가 아닌 평면 JSON 레코드입니다. parent_id나 link_id가 있으면 로컬로 관계를 묶을 수 있지만 부모 기록이나 앞선 대화가 없을 수 있습니다. 빠진 문맥을 추정으로 채우지 마세요. 텍스트와 시각 같은 항목도 실제 응답에 있는지 확인하고 제외 규칙을 적으세요. API가 감정 분석이나 장비 평가를 만들어 주는 것은 아니며, 연구자는 받은 자료에 자신의 분석을 적용할 수 있습니다.
시간 범위 한계 및 검색 기능
from과 to는 UTC 달력 날짜를 YYYY-MM-DD로 지정하며 to 날짜도 포함합니다. 날짜 조건은 선택 사항으로 결과를 좁히지만 정렬하지 않습니다. 시간이나 분 단위의 창은 이 필터로 지정하지 않습니다. 연속된 기간을 만들 때는 다음 구간을 이전 to 다음 날에 시작하면 경계일을 다시 쓰지 않습니다. 올바른 경계 설정도 전체 범위, 편향 없는 표본, 중복 없는 수집을 보장하지는 않습니다.
검색 필터에는 subreddit, author, kind 등 다양한 변수가 포함됩니다. 특히 'kind' 파라미터를 통해 게시글(post)과 댓글(comment)을 명확히 구분하여 요청할 수 있습니다. 각 API 경로는 고유한 매개변수 구조를 가지므로, '/v1/item'만 고유 식별자 id를 필요로 하고 다른 엔드포인트는 그렇지 않다는 점을 주의해야 합니다. 이는 데이터 추출의 정밀도를 극대화합니다.
검색 결과는 아카이브의 내부 문서 순서로 반환되며, 반드시 시간순이나 점수순으로 정렬된 것은 아닙니다. 또한 'min_score' 필터는 점수 기반 정렬을 제어하는 것이 아니라 단순히 조건을 필터링하는 역할만 합니다. 한 번의 요청당 최대 100개의 기록만 반환되므로, 대량의 데이터를 가져오기 위해서는 page 번호를 조절하여 반복적으로 요청해야 하는 제한 사항이 있습니다.
크레딧 기반 가격 책정 및 운영
성공 조회는 빈 결과도 1크레딧을 사용합니다. 1000회는 $1, 1크레딧은 $0.001이며 최소 유료 충전 $50은 50000크레딧입니다. 구독은 없고 유료 크레딧은 만료되지 않습니다. 가입과 키 표시에는 결제가 필요하지 않습니다. 네트워크 전체 남용 방지 조건을 충족하는 계정은 100크레딧 체험을 받을 수 있지만 모든 신규 가입에 보장되지는 않습니다. 여러 날짜 구간과 성공한 재시도도 예산에 넣으세요.
충전하려면 로그인 후 청구서를 만드세요. USDT TRON TRC20 또는 USDC 이더리움 메인넷 ERC20을 선택하고 현재 청구서의 수신 주소와 정확한 금액을 사용합니다. 청구서는 생성 후 1시간에 만료되므로 현재 안내를 따르세요. 송금 뒤 거래 해시를 제출해 검증을 요청해야 합니다. 서버가 확인된 실제 송금을 검증해야 잔액에 반영됩니다. 주소가 매번 바뀐다는 의미는 아니며 정해진 송금 또는 확인 시간도 없습니다.
조회에는 Authorization: Bearer YOUR_API_KEY 또는 X-API-Key: YOUR_API_KEY를 사용할 수 있습니다. 실제 키는 비공개 서버 설정에 보관하세요. 키는 가입 직후 결제 전에 한 번 표시되며 로그인 후 비밀번호 확인으로 재생성하면 이전 키가 즉시 무효화됩니다. 잘못된 요청은 차감하지 않고 상위 실패는 예약분을 반환합니다. 클라이언트가 응답을 잃어도 과금된 성공이 있을 수 있으며 성공한 재시도에는 새 크레딧이 필요합니다.
