질문과 선택 기준을 먼저 정하기
조회 전에 모델의 용도, 대상 언어, 커뮤니티, 텍스트 유형과 주석 범주를 정하세요. MachineLearning의 소량 댓글로 지침을 시험한다면 기술 커뮤니티에서 얻은 제한된 자료임을 설명해야 합니다. 이를 Reddit 전체 사용자나 현재 활동의 대표 표본으로 해석하지 마세요. Reddit Datasets는 독립적인 과거 아카이브이며 공식 서비스나 실시간 자료 경로가 아닙니다. /v1/subreddits?prefix=...는 이름 탐색에 도움을 주지만 특정 기간의 전량 보관이나 모든 커뮤니티의 정확한 목록을 입증하지 않습니다. 이름이 검색된다는 사실과 실제 댓글의 확보 가능성을 구분하고 범위를 평가하세요.
댓글은 /v1/comments, 게시물은 /v1/posts, 일반 검색은 /v1/search를 사용합니다. kind는 post 또는 comment입니다. q, subreddit과 author로 필요한 조건을 좁힐 수 있습니다. from과 to는 UTC의 YYYY-MM-DD 날짜이며 to는 지정한 날 전체를 포함합니다. 기간을 정해도 서버의 고정 스냅샷이 생성되는 것은 아닙니다. min_score는 최소 점수 조건으로 정렬 기능이 아닙니다. 이 조건을 쓴다면 낮은 점수의 문장을 제외한 이유를 자료 설명에 적으세요. 높은 점수를 정답 라벨이나 언어 품질의 검증으로 사용해서는 안 됩니다. 날짜와 점수 조건이 표본 구성에 미치는 영향을 별도로 검토해야 합니다.
실제 조회와 변환 기록 남기기
시작 예제는 https://api.redditdatasets.com/v1/comments?subreddit=MachineLearning&limit=3 입니다. Authorization: Bearer YOUR_API_KEY와 X-API-Key: YOUR_API_KEY는 둘 다 유효하며 하나를 선택하면 됩니다. 실제 값은 서버에 두고 공유 파일과 로그에서 제외하세요. 출처 메모에는 주소, 비밀 없는 필터, UTC 조회 시각, 호출 결과와 실제 저장 건수를 적을 수 있습니다. 식별자나 날짜는 실제 반환된 값만 사용하세요. 필요한 항목이 없다면 누락으로 표시하고 작업에 쓸 수 있는지 판단해야 합니다. 예정한 표본 수를 맞추려고 문장이나 출처를 만들어 넣어서는 안 됩니다.
요청당 100개 기록과 쿼리당 100페이지가 상한입니다. 총계의 eq는 정확한 값, gte는 하한, unknown 또는 null은 알 수 없는 상태를 나타냅니다. 방문한 페이지를 모두 기록해도 조건에 맞는 자료를 전부 받았다는 증명은 아닙니다. 문서 순서는 무작위, 시간순이나 관련도순이 아닙니다. 중복을 제거한다면 사용한 식별 기준과 제외 건수를 문서화하세요. 정규화, 삭제와 익명화의 이유도 기록해야 합니다. 평평한 자료는 바로 읽거나 분류할 수 있으며 parent_id와 link_id를 통한 관계 정리는 선택 사항입니다. 이 과정은 받지 못한 부모나 대화 내용을 채우지 않습니다.
주석과 평가의 한계 설명하기
모호한 표현, 인용, 잘린 문맥과 개인 정보를 다루는 규칙을 만드세요. 두 사람이 같은 소량 자료를 독립적으로 읽으면 해석 차이를 발견할 수 있지만 이는 이용자의 검토 방법이며 API가 제공하는 품질 검증은 아닙니다. 지침과 라벨의 변경 이유를 함께 남기고 검토한 로컬 버전을 구분하세요. 학습용과 평가용 사이에 같은 문장이나 관련 대화가 겹치는지 확인하는 것도 필요합니다. 실제로 가진 자료에서 확인한 범위만 설명하고 모든 정보 누출이나 편향을 제거했다고 약속하지 마세요. 제삼자의 권리와 재사용 목적도 파일을 공유하기 전에 따로 검토해야 합니다.
실제로 분석한 사본과 작성 절차를 보관하되 아카이브가 영구 보존되거나 같은 쿼리가 미래에 같은 결과를 준다고 전제하지 마세요. 일괄 다운로드, 무작위 표집이나 고정된 데이터셋 버전은 제공되지 않습니다. 성공한 빈 조회도 한 크레딧이며 클라이언트 시간 초과 뒤의 성공한 재시도는 추가 비용일 수 있습니다. 공개 비과금 /v1/status는 정적인 서비스 범위와 HTTP 응답만 보여 주고 표본의 존재나 검색 시스템의 상태는 검사하지 않습니다. 최종 설명에는 선택 기준, 실제 건수, 변환, 주석 규칙과 남은 한계를 넣으세요. 로컬 재처리와 새 API 호출도 비용 기록에서 구분해야 합니다.
