주석을 달기 전에 표본의 출처와 선택 기준을 기록하세요

MachineLearning 댓글을 소량 조회해 주석 지침을 시험하세요. 출처와 선택 기준을 기록하고 완전한 데이터셋, 무작위 표집과 고정된 아카이브를 전제하지 않는 방법을 설명합니다.

요청 예제

cURL

curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.redditdatasets.com/v1/comments?subreddit=MachineLearning&limit=3"

작은 댓글 표본으로 지침 시험하기

Reddit Datasets는 과거 Reddit 아카이브에 접근하는 독립적인 API이며 Reddit의 공식 서비스나 제휴 서비스가 아닙니다. 머신러닝 데이터를 준비할 때는 기술 질문과 의견을 구분하는 일처럼 먼저 주석 목적을 정하세요. 작은 댓글 묶음으로 지침을 시험할 수 있지만 API가 검증된 정답 라벨이나 완성된 학습 자료를 제공하는 것은 아닙니다. MachineLearning의 모든 댓글이 보관되어 있다고 전제해서도 안 됩니다. 실제로 받은 기록과 연구가 대상으로 삼는 모집단을 구분하고 부족한 문맥을 설명하세요. 커뮤니티 이름이 발견되어도 특정 기간의 완전한 수록이나 대표성이 입증되지는 않습니다.

GET 예제는 https://api.redditdatasets.com/v1/comments?subreddit=MachineLearning&limit=3 입니다. subreddit은 커뮤니티를 지정하고 limit=3은 최대 세 건을 요청합니다. 세 건이 반드시 반환되는 것은 아니며 결과가 비어 있을 수 있습니다. Authorization: Bearer YOUR_API_KEY 또는 X-API-Key: YOUR_API_KEY를 사용하세요. YOUR_API_KEY는 자리표시자이며 실제 값은 신뢰할 수 있는 서버 환경에서만 추가합니다. Reddit OAuth 토큰을 넣는 자리가 아닙니다. 여기에서는 실행하지 않은 응답이나 가상의 댓글을 실제 조회 결과로 제시하지 않습니다. 빈 결과도 성공한 조회라면 한 크레딧을 사용하므로 기록 수와 호출 비용을 구분해야 합니다.

출처 기록과 주석 판단을 분리하기

요청 주소, 비밀 값을 제외한 필터, UTC 조회 시각과 실제로 저장한 기록 수를 자체 표본 설명에 남기세요. 응답에 있는 식별자와 출처 항목을 유지하고 없는 날짜나 커뮤니티 이름을 추측해서 채우지 마세요. 조회 시각은 댓글 작성 시각이나 아카이브 수록 시각과 다릅니다. 이 설명은 이용자가 만드는 작업 기록이며 API가 모든 자료의 출처를 인증하는 증명서나 완성된 데이터셋 카드를 발행하는 것은 아닙니다. 로컬 파일에 버전 이름을 붙여도 서버 자료가 고정되지는 않습니다. 나중에 같은 조건으로 같은 내용과 순서를 받을 수 있다고 보장하지 않습니다.

첫 페이지를 무작위 표본이나 균형 잡힌 표본이라고 부르지 마세요. 아카이브 문서 순서는 시간순, 관련도순이나 점수순이 아닙니다. min_score는 최소 점수 조건이며 높은 점수가 올바른 라벨이나 좋은 학습 자료의 증거는 아닙니다. 모호한 문장, 누락된 문맥과 개인 정보를 다루는 규칙을 주석 지침에 포함하세요. 평평한 기록을 읽거나 분류할 때 대화 트리를 반드시 만들 필요는 없습니다. parent_id와 link_id가 있으면 관계를 선택적으로 정리할 수 있지만 빠진 부모 기록이나 전체 대화가 복원되지는 않습니다. 서로 다른 주석 판단을 검토하는 일도 이용자 측의 별도 작업입니다.

완성된 데이터셋과 구분할 한계

요청당 최대 100개 기록과 쿼리당 최대 100페이지의 한도가 있습니다. 페이지를 반복하거나 날짜를 나누고 중복을 제거해도 전량 수집이나 모든 기록의 유일성이 증명되지는 않습니다. eq는 정확한 기록 총계, gte는 하한, unknown 또는 null은 신뢰할 총계를 알 수 없는 상태입니다. 정확한 총계도 클라이언트의 전량 저장을 증명하지 않습니다. API에는 일괄 다운로드, 무작위 표집이나 불변 데이터셋 버전 기능이 없습니다. 학습용과 평가용 분할은 이용자가 설계해야 하며 같은 문장이나 관련 대화의 중복을 어디까지 확인했는지 설명하세요. 로컬 검사만으로 모든 정보 누출이 없다고 결론 내릴 수는 없습니다.

성공한 조회 1,000건은 $1이며 최소 $50 충전은 유료 50,000크레딧입니다. 구독제가 아니고 유료 크레딧은 만료되지 않습니다. 시험용 100크레딧은 네트워크 전체의 남용 방지 자격 조건에 따르므로 모든 계정에 보장되지 않습니다. 키는 결제 전 가입 직후 한 번 표시됩니다. 조회 비용은 주석 작업, 재사용 허가나 모델 성능을 구매하는 금액이 아닙니다. 실제 활용 목적에 맞춰 제삼자의 권리와 개인 정보 위험을 검토하세요. 자료 설명에는 선택 기준, 실제 건수, 변환과 누락 범위를 함께 적고 영구 접근, 불변성, 일정한 성능이나 미래의 동일 응답을 약속하지 마세요.