경로와 인증 방식을 선택하세요
데이터 요청 호스트는 api.redditsearchapi.com입니다. GET /v1/search는 일반 검색, /v1/posts는 게시글, /v1/comments는 댓글 조회에 사용합니다. 식별자로 하나의 항목을 찾으려면 /v1/item에 id를 지정하세요. 게시글과 댓글 목록에는 id가 필요하지 않습니다. 커뮤니티 이름의 시작 부분으로 탐색하려면 /v1/subreddits의 prefix 매개변수를 사용합니다. 경로별 목적을 나누어 두면 목록 조회와 개별 항목 조회를 구분하기 쉽습니다.
이 도메인의 유효한 API 키를 X-API-Key 헤더로 보내야 합니다. 계정 패널의 세션 쿠키는 데이터 요청에서 키를 대신하지 않습니다. 공유할 수 있는 검색 주소나 사용자에게 보이는 오류 내용에 비밀 키를 넣지 마세요. 인증 문제를 조사할 때에는 헤더가 실제로 전송되는지 확인하되, 키 자체를 공개 로그에 복사하지 않는 방식이 좋습니다.
GET /v1/status는 공개 경로이며 크레딧을 사용하지 않습니다. 독립적인 과거 자료 아카이브라는 서비스 범위를 정적으로 설명하고 HTTP 서버가 응답함을 보여 줍니다. 검색 엔진의 상태, 기록의 가용성, 자료의 완전성을 검사하지는 않습니다. 이 경로의 성공을 검색 기능 전체가 정상이라는 표시로 사용하지 말고, 실제 데이터 요청의 결과와 구분해서 다루세요.
필터와 결과 개수를 해석하세요
지원되는 검색 매개변수는 q, subreddit, author, kind, from, to, min_score, limit, page입니다. kind 값은 post 또는 comment입니다. from과 to는 UTC 기준 YYYY-MM-DD 형식이며 to는 지정한 날짜를 포함합니다. 화면에서 지역에 맞는 날짜를 보여 주더라도 API에 실제로 전달하는 시작일과 종료일을 사용자가 확인할 수 있도록 설명하는 것이 좋습니다.
limit와 page는 각각 1부터 100까지 지정합니다. 한 번의 호출은 최대 100개 기록이 담긴 한 페이지를 가져옵니다. 다음 페이지에는 별도 요청이 필요하며 100페이지 전체가 한 응답에 포함되는 것은 아닙니다. 날짜나 커뮤니티로 작업을 분할할 수 있지만, 분할 자체가 중복 없는 수집이나 빠짐없는 전체 조회를 증명하지는 않습니다.
전체 개수의 eq는 정확한 쿼리 일치 개수, gte는 하한값, unknown은 신뢰할 수 있는 전체 개수를 알 수 없음을 뜻합니다. 값이 null일 수도 있습니다. 정확한 쿼리 개수도 Reddit 전체가 보관되었다는 뜻은 아닙니다. 알 수 없는 값을 0으로 바꾸거나 하한값을 확정된 총계로 집계하면 결과의 의미가 달라지므로 주의하세요.
순서, 오류, 비용을 따로 다루세요
조회는 내부 _doc 순서를 사용하며 시간순, 관련도순, 점수순이 아닙니다. min_score는 최소 점수 필터이고 정렬 기능은 아닙니다. 응답은 평면 기록이며 parent_id나 link_id가 있을 때 로컬 그룹화가 가능합니다. 두 필드를 직접 지정하는 서버 검색 필터는 없습니다. 기록의 필드가 항상 같다고 가정하지 말고 실제 응답에서 존재 여부를 확인하여 표시하세요.
400은 잘못된 요청, 401은 없거나 유효하지 않은 키, 402는 크레딧 부족, 429는 요청 속도 제한입니다. 400에는 매개변수, 401에는 헤더, 402에는 잔액을 확인하세요. 429에는 대기 시간을 두고 횟수를 제한한 재시도를 고려할 수 있습니다. 키나 잔액의 문제는 같은 설정을 계속 보내는 것만으로 해결되지 않으므로 원인을 먼저 구분해야 합니다.
잘못된 요청은 크레딧을 차감하지 않으며 상위 서비스 실패에는 예약된 크레딧이 반환됩니다. 성공한 빈 응답은 유료입니다. 서버에서 조회가 성공한 뒤 클라이언트 연결이 끊어지면 이미 과금되었을 수 있습니다. 성공한 재시도는 다시 1크레딧을 사용합니다. 따라서 통신 오류만 보고 무료라고 판단하지 말고 재시도 횟수와 예산을 함께 관리하세요.
