두 주제를 연결하는 질문부터 시작하세요
urbanplanning에서 역에 가는 방법과 역 주변 주거가 어떻게 연결되는지 살펴본다고 가정해 보세요. 커뮤니티 분석가에게 먼저 필요한 것은 인기 순위보다 구체적인 읽기 질문입니다. 받은 글이 이동 문제를 다루는지, 주거 문제를 다루는지, 둘을 함께 다루는지 확인합니다. Subreddit Data는 독립적인 Reddit 과거 아카이브 API이며 공식 서비스나 실시간 활동 피드가 아닙니다. 결과는 선택 이유가 드러나는 사례와 아직 알 수 없는 맥락을 정리하는 데 사용할 수 있습니다.
예시 요청은 https://api.subredditdata.com/v1/search?q=transit&subreddit=urbanplanning&limit=3 입니다. q는 검색할 텍스트, subreddit은 커뮤니티, limit은 최대 세 개의 기록을 뜻합니다. 실제로 세 개가 반드시 있다는 약속은 아닙니다. 응답이 비어 있을 수도 있으므로 예시 주소 자체를 조사 결과로 제시하지 마세요.
게시물과 댓글 중 비교 단위를 고르세요
게시물은 계획 전체를 소개하고 댓글은 그중 작은 부분에만 답할 수 있습니다. 게시물, 댓글, 또는 의도적으로 섞은 자료 중 무엇을 읽을지 정하세요. 필요하면 kind=post나 kind=comment를 지정하고 두 검색에 같은 선택을 적용합니다. 자료 유형의 차이가 주제에 대한 관심 차이처럼 보이지 않도록 하기 위한 결정입니다.
반환된 글을 먼저 읽고 역에 관한 질문인지, 노선 제안인지, 뉴스 인용인지 구별합니다. 같은 검색어에 맞더라도 조사에서 갖는 의미는 다를 수 있습니다. 기록의 원문과 분석가가 붙인 설명을 분리하면 나중에 다른 사람이 해석의 근거를 확인할 수 있습니다. 부족한 맥락을 추측으로 채우지 마세요.
검색어가 선택하는 범위를 확인하세요
q는 title과 text를 검색합니다. 분석된 여러 단어는 일치하는 필드 안에서 AND로 연결되므로 아무 단어 하나만 맞는 조건이 아닙니다. 반대로 모든 단어가 두 필드에 동시에 있어야 하는 것도 아닙니다. 정확한 문구 일치를 보장하지 않으므로 검색 표현을 표에 그대로 남겨 두세요.
from과 to는 created_utc에 적용하는 UTC 기준 YYYY-MM-DD 날짜입니다. to는 해당 날짜 전체를 포함하며 오늘을 지정해도 요청 시각에서 잘리지 않습니다. 이것은 날짜 경계의 규칙이지 하루의 모든 기록이 있다는 보장은 아닙니다. _doc 순서는 시간순이나 관련도순이 아니고 min_score는 숫자 하한 필터일 뿐입니다.
역 주변 주거 기록의 겹침을 남기세요
역 주변 주택을 다룬 글은 교통과 주택이라는 두 주제 검색에 모두 포함될 수 있습니다. 이런 기록을 독립된 두 사람의 의견으로 더하지 마세요. 믿을 수 있는 식별자가 있다면 로컬에서 겹침을 확인하고, 없으면 고유한 기록이라고 단정하지 않습니다. 하나의 기록과 한 명의 참여자는 같은 단위가 아닙니다.
주제 이름, 분류 이유, 판단이 어려운 부분은 분석가가 로컬에서 작성합니다. API는 주제 비율이나 감정 점수, 회원의 인구 특성, 통계적 결론을 제공하지 않습니다. 더 좁은 검색어에서 기록이 적게 나왔다고 해서 커뮤니티의 관심이 낮다고 해석할 수 없습니다. 표현 차이로 놓친 글도 있을 수 있습니다.
다음 요청의 목적을 정하세요
한 요청은 최대 100개 기록, 한 검색 조건은 최대 100페이지로 제한됩니다. 가능한 페이지를 모두 읽어도 커뮤니티의 역사를 완전히 모았다고 할 수 없습니다. 두 주제의 페이지 수를 같게 정하는 것은 읽는 노력의 기준을 맞추는 것이지 수집 범위를 같게 만드는 것이 아닙니다. 실제 읽은 기록의 수를 별도로 남기세요.
작은 transit 응답을 읽은 뒤 housing 검색, 다음 페이지, 저장된 글의 재독 중 무엇이 질문에 도움이 될지 결정하세요. 성공한 조회는 빈 결과도 한 크레딧을 쓰지만 로컬 파일을 다시 읽는 데 새 API 요청은 필요하지 않습니다. 키 페이지에서는 접근을 준비하고 가이드에서는 두 검색을 비교표로 연결합니다. 마지막 메모에 아직 답하지 못한 질문도 적어 두세요.
