과거 Reddit 자료를 위한 검색 API

독립적인 Reddit 과거 자료로 검색 앱을 개발하세요. 검색 조건과 결과 한계, 전체 개수의 의미, 성공한 요청 단위의 요금과 계정 사용법을 설명합니다.

요청 예제

cURL

curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.redditsearchapi.com/v1/search?q=quantization&subreddit=LocalLLaMA&limit=3"

검색할 대상과 질문을 먼저 정하세요

Reddit Search API는 과거 Reddit 기록을 검색하는 독립적인 아카이브 API입니다. Reddit의 공식 서비스나 제휴 서비스가 아니며 실시간 게시글 흐름을 제공하지 않습니다. 앱의 검색 화면에는 자료의 출처와 역사적 성격을 분명히 표시하세요. 사용자가 현재 Reddit의 모든 게시글이나 최근 변경 내용이 곧바로 검색될 것이라고 기대하지 않도록 설명하는 것이 좋습니다.

검색어는 q, 커뮤니티는 subreddit, 작성자는 author로 지정합니다. kind에 post 또는 comment를 넣으면 게시글과 댓글을 나눌 수 있습니다. 날짜 범위를 함께 사용하면 조사할 대상을 좁힐 수 있습니다. 이러한 조건은 검색 범위를 정의하지만, 해당 조건에 맞는 모든 기록이 아카이브에 존재한다는 보장은 아닙니다. 화면에서 선택한 조건을 결과 가까이에 보여 주세요.

예를 들어 제품에 관한 과거 논의를 찾는 도구는 검색어와 커뮤니티, 날짜 범위를 조합할 수 있습니다. 이는 매개변수를 사용하는 방법의 예이며 특정 제품이나 기간의 자료가 있다는 약속은 아닙니다. 작은 쿼리의 실제 응답을 먼저 살펴본 뒤, 앱이 어떤 기록을 표시하고 어떤 분석을 로컬에서 수행할지 결정하세요.

결과 개수와 순서를 정확히 표시하세요

요청 한 번은 최대 100개의 기록을 반환합니다. 하나의 쿼리는 별도 요청을 통해 최대 100페이지까지 조회할 수 있습니다. 허용된 페이지를 모두 확인해도 모든 일치 기록이나 Reddit 전체 이력을 가져왔다고 볼 수 없습니다. 현재 화면의 기록 수와 쿼리의 전체 일치 개수는 서로 다른 값이므로 구분해서 표시해야 합니다.

전체 개수는 정확한 값, 하한값, 신뢰할 수 있는 값을 알 수 없는 상태로 나뉩니다. 하한값을 확정된 개수로 표시하면 사용자가 검색 범위를 잘못 이해할 수 있습니다. 결과는 아카이브 내부의 _doc 순서로 반환되며 시간순, 관련도순, 점수순이 아닙니다. min_score는 최소 점수 조건만 적용하고 높은 점수부터 정렬하지 않습니다. 로컬 정렬의 대상도 이미 받은 기록에 한정됩니다.

응답은 서버가 조립한 대화 트리가 아닌 평면 기록입니다. parent_id와 link_id가 있을 때 앱에서 관계를 묶을 수 있지만 전체 대화나 모든 상위 관계가 갖춰진다는 보장은 없습니다. 분석의 근거를 남기려면 원본 응답과 검색 조건, 로컬 변환 과정을 함께 저장하세요. 나중에 같은 쿼리를 실행해도 동일한 기록이나 순서가 반환된다고 보장하지 않습니다.

작게 시험하고 비용을 계산하세요

성공한 데이터 조회 요청은 빈 결과라도 1크레딧을 사용합니다. 성공한 요청 1000회는 미화 1달러입니다. 최소 유료 충전액 50달러로 유료 크레딧 50000개를 구매합니다. 구독은 없으며 구매한 크레딧은 만료되지 않습니다. 네트워크 전체의 남용 방지 자격 조건을 충족하는 계정은 체험 크레딧 100개를 받을 수 있습니다. 체험 제공이 모든 가입자에게 보장되는 것은 아닙니다.

이메일과 비밀번호로 가입하면 결제 전에 API 키가 한 번 표시됩니다. 키를 저장하고 조회 요청의 X-API-Key 헤더에 사용하세요. 계정 패널은 키 페이지에 있습니다. 잔액을 추가하려면 로그인한 뒤 청구서를 만들고 표시된 수취인에게 정확한 금액을 보내세요. 이후 실제 거래 해시를 붙여 넣어 검증을 요청합니다. 키와 잔액은 이 도메인 계정에만 속합니다.

앱의 예산을 계산할 때 검색 버튼을 누른 횟수만 세지 말고 추가 페이지와 성공한 재시도도 포함하세요. 결과가 없다는 이유로 같은 조건을 자동 반복하면 비용이 늘어날 수 있습니다. 먼저 한 페이지의 응답과 필드를 확인한 다음 페이지 이동과 오류 처리 방식을 정하면, 자료의 적합성과 호출량을 함께 검토할 수 있습니다.