결과를 보기 전에 비교 방법 작성하기
구체적인 비교 질문을 세워 보세요. 연속된 두 주 동안 AskSocialScience에서 과학적 근거가 있는 설명을 어떻게 요청했는가를 살펴봅니다. 분석 단위는 처음 게시한 글입니다. 명시적 질문이나 연구 인용이 없는 글도 포함할지 사전에 결정하세요. 눈에 띄는 사례 하나 때문에 다른 주에 적용할 기준이 은연중에 바뀌지 않도록 결과를 보기 전에 판단을 기록합니다.
from과 to는 UTC 날짜 단위로 동작하며 마지막 날 전체를 포함합니다. 현지 달력으로 정한 기간을 UTC 경계로 어떻게 변환했는지 기록하세요. 시간 단위 필터는 지원하지 않습니다. 필요하면 더 넓은 UTC 날짜를 조회한 뒤 실제 반환된 시각을 로컬에서 검사할 수 있습니다. 이 절차는 누락된 기록을 채우거나 전체 수집을 입증하지 않습니다.
각 주에 명확한 UTC 경계 지정하기
GET https://api.redditcollector.com/v1/posts?subreddit=AskSocialScience&limit=3 에 첫 예시 기간인 &from=2025-03-01&to=2025-03-07 을 추가하세요. 두 번째 기간은 from=2025-03-08&to=2025-03-14 로 바꾸고 page=1 부터 다시 시작합니다. 날짜는 연습용 설정이며 알려진 아카이브 수록 범위가 아닙니다. 형식은 UTC의 YYYY-MM-DD 이고 to 날짜 전체를 포함합니다. 홈의 예제만으로는 날짜가 제한되지 않습니다. 두 기간의 경로, 커뮤니티와 포함 기준은 유지하고 날짜 경계만 바꾸세요.
요청당 100개 기록과 쿼리당 100페이지는 상한이며 보장된 분량이 아닙니다. 페이지마다 별도 호출이므로 페이지 수와 기록 수를 구분하세요. 문서 순서는 시간순, 관련도순이나 점수순이 아닙니다. 마지막 기록의 날짜가 그 이전의 전량 수집을 증명하지 않습니다. eq는 정확한 총계, gte는 하한, unknown 또는 null은 알 수 없는 총계입니다. 페이지 반복, 더 좁은 날짜 분할과 중복 제거도 모든 일치 자료를 받았다는 증거가 아닙니다. 실제 저장 건수, 조회한 페이지와 중단 이유를 적으세요. 성공한 빈 결과도 그 시점의 그 쿼리 결과이며 연구 기간에 논의가 전혀 없었다는 뜻은 아닙니다.
조회 필터와 연구 분류 구분하기
처음에는 q나 min_score 없이 표현을 살펴보세요. 나중에 q가 필요하다면 title과 text를 검색하며 검색어 전체가 둘 중 한 필드 안에서 일치해야 한다는 점을 기억하세요. 제목과 본문에 단어가 나뉘어 있는 것만으로는 충족되지 않습니다. min_score는 임계값만 적용하며 품질이나 최신순으로 정렬하지 않습니다. 연구 분류와 제외 사유는 원본 항목과 분리한 로컬 필드에 기록하세요. 아카이브가 이러한 평가를 부여하지는 않습니다.
수집 중단 이유 기록하기
실제 응답에 있는 날짜, 식별자와 커뮤니티 항목을 확인하세요. 연구 대상 기간, UTC 조회 시각과 로컬 파일 버전을 구분하고 없는 날짜나 문장을 추측해서 채우지 마세요. 관계 분석이 필요하면 parent_id와 link_id로 선택적인 정리를 할 수 있지만 이 항목은 검색 매개변수가 아니며 없는 부모를 복원하지 않습니다. 평평한 기록을 읽거나 분류할 때 대화 트리가 반드시 필요한 것도 아닙니다. 같은 문장이나 식별자를 기준으로 중복을 제거했다면 방법과 제외 건수를 기록하세요. 실제 가진 자료에서 검사한 범위만 보고하고 보이지 않는 누락까지 해결했다고 주장하지 마세요. 비교 자료의 한계도 함께 설명해야 합니다.
성공한 빈 조회도 한 크레딧을 사용합니다. 유효하지 않은 요청은 차감되지 않고 상위 시스템 실패의 예약분은 반환됩니다. 클라이언트 시간 초과는 서버 실패의 증거가 아니며 성공한 재시도는 추가 비용일 수 있습니다. 400은 매개변수, 401은 키, 402는 잔액, 429는 빈도를 확인해야 합니다. /v1/status는 비과금이어도 정적인 범위와 HTTP 응답 외의 기록, 키나 검색 시스템을 검사하지 않습니다. 미래의 동일 재조회, 영구 보존이나 완전성은 보장되지 않습니다. 최종 보고에서는 기간 선택의 이유, 실제 범위, 기간별 누락과 제삼자의 권리 검토를 연구 결과와 나누어 설명하세요.
다른 연구자가 읽을 수 있는 방법 기록 남기기
마지막으로 두 주와 초기 게시물을 선택한 이유, 적용한 필터와 종료 이유를 설명하세요. 받은 건수와 분석에 채택한 건수를 나누고 빠진 날짜나 문맥도 명시합니다. 기간 길이와 요청 예산을 맞춰도 대표 표본이 되지는 않습니다. 읽은 게시물의 주제가 다르다는 관찰은 그 자료에 관한 것이며, 그 자체로 커뮤니티 전체의 변화를 입증하지 않습니다.
