이름 목록인가요, 콘텐츠 기록인가요?
커뮤니티 선택기를 만든다면 /v1/subreddits를 먼저 검토하세요. 홈의 https://api.redditapihub.com/v1/subreddits?prefix=program&limit=3 예제에서 prefix는 이름의 시작 부분이고 limit은 요청 결과 상한입니다. 주제 분류나 게시물 텍스트 검색이 아닙니다. 받은 이름을 로컬 선택 목록으로 옮길 수 있지만 전체 Reddit 또는 전체 아카이브의 완전한 재고처럼 제시하지 마세요. 무엇을 조회했는지 설명하는 것이 중요합니다.
커뮤니티 출력에는 알파벳 순서나 전역의 정확한 건수가 보장되지 않습니다. 로컬 정렬도 받은 이름만 대상으로 합니다. 이름 하나가 나와도 모든 관련 게시물과 댓글의 존재가 입증되지는 않습니다. 다음 콘텐츠 요청을 따로 평가하세요. 빈 접두사 결과도 전체 Reddit에 그런 이름이 없다는 뜻은 아닙니다. 실제 실행한 요청에서 알 수 있는 범위에 결론을 한정해야 합니다.
Reddit API Hub는 독립적인 과거 아카이브이며 공식 서비스나 실시간 Reddit 서비스가 아닙니다. OAuth, 쓰기, 투표나 메시지를 제공하지 않습니다. 적합한 경로가 있다고 특정 기간이나 기록이 제공된다는 보장도 없습니다. 작업에 현재 정보가 필요한지 과거 기록이 필요한지 먼저 결정하세요. 이름을 고르는 것과 콘텐츠의 전체 범위를 확인하는 것은 다른 질문이며 서로 대신하지 않습니다.
검색, 종류별 목록과 단일 항목
/v1/search는 게시물과 댓글 기록을 조건으로 검색합니다. 게시물만 필요하면 /v1/posts, 댓글만 필요하면 /v1/comments를 고릅니다. 완전한 대화나 자동 분석이 반환되지는 않습니다. 실제 응답 필드를 검사하고 자체 스키마에 매핑하세요. 본문, 제목이나 관계 정보가 없을 때의 동작을 정하고 받지 못한 내용을 추측으로 채우지 마세요. 단순히 경로를 바꿨다고 누락된 문맥이 복원되지는 않습니다.
식별자를 아는 한 기록에는 /v1/item?id=...를 사용합니다. id는 posts나 comments의 필터가 아닙니다. 검색 경로에는 q, subreddit, author, kind와 UTC 기준 YYYY-MM-DD 형식의 from 및 to를 쓸 수 있고 to 날짜가 포함됩니다. kind는 post 또는 comment입니다. min_score는 최소 점수 조건이지 정렬이 아닙니다. 같은 조건을 전부 커뮤니티 경로에 옮기지 말고 입력 차이를 유지하세요.
평면 기록을 읽고 분류하거나 개수를 세는 데 트리는 필요 없습니다. 관계를 조사하려면 존재하는 parent_id나 link_id로 선택적 로컬 그룹화를 할 수 있지만 조회 필터는 아니고 빠진 부모와 댓글도 돌아오지 않습니다. 댓글 목록을 전체 대화로, 게시물 목록을 모든 답글이 들어 있는 구조로 보여 주지 마세요. 받은 관계의 범위를 결과 설명에도 기록해야 합니다.
결과 한계와 서버 접근
쿼리 파라미터를 활용하여 데이터를 필터링할 수 있습니다. 주제, 작성자, 서브레딧, 그리고 날짜 범위를 지정하여 원하는 데이터만 추출할 수 있습니다. 특히 min_score 파라미터는 데이터의 점수를 기준으로 정렬하는 것이 아니라, 단순히 지정한 점수 이상의 데이터만 필터링하는 역할을 합니다. 따라서 순위나 가중치에 따른 정렬 기대를 피해야 합니다.
검색, 게시물과 댓글은 요청당 최대 100개 기록, 쿼리당 최대 100페이지이며 각 페이지는 따로 요청합니다. 결과는 아카이브 문서 순서입니다. 합계의 eq는 정확한 수, gte는 하한, unknown이나 null은 신뢰할 수 있는 합계가 없는 상태입니다. 정확한 값도 전체 저장의 증거는 아닙니다. 기간 분할은 전체 수집이나 중복 없는 결과를 보장하지 않으므로 받은 조건과 페이지를 추적하세요.
키는 서버에 두고 Authorization: Bearer YOUR_API_KEY 또는 X-API-Key: YOUR_API_KEY로 보냅니다. 계정 쿠키는 별도 용도입니다. 무료 /v1/status는 고정 범위와 HTTP 응답만 보여 주며 아카이브, 키나 잔액은 검사하지 않습니다. HTTP 400은 조건, 401은 키, 402는 잔액을 수정하고 429에서는 송신을 늦추세요. 모두 같은 즉시 재송신으로 처리하지 않아야 합니다.
성공한 조회는 빈 결과도 한 크레딧입니다. 잘못된 요청은 차감하지 않고 상위 소스 장애에는 예약분을 돌려줍니다. 응답 유실 전에 서버에서 유료 성공이 발생했을 수 있고 성공한 재시도는 추가 비용입니다. 저장한 페이지를 자체 기록으로 추적하세요. 문서는 기술 계약, 요금은 예산, API 키 받기는 계정 절차를 설명합니다. 올바른 경로 선택도 데이터의 전체 포함을 보장하지 않습니다.
