질문과 집계 단위 정하기
전체 시장이 어떤 브랜드를 좋아하는지 묻기 전에, 확보할 수 있는 글로 무엇을 설명할지 정하세요. 예를 들어 BuyItForLife에서 배낭 내구성을 말할 때 어떤 부품과 사용 경험을 언급하는지 조사할 수 있습니다. 집계 단위도 레코드, 작성자, 제품 경험 중에서 정해야 합니다. 한 사람이 여러 댓글을 썼다고 여러 독립적인 구매자의 의견을 얻은 것은 아닙니다.
GET https://api.redditlistening.com/v1/search?q=backpack&subreddit=BuyItForLife&limit=3 으로 작은 결과부터 읽어 보세요. q는 검색어, subreddit은 커뮤니티, limit은 결과 수의 상한입니다. 직접 사용한 이야기인지, 구매 상담인지, 남의 평가를 인용한 것인지 구분합니다. 검색어가 나온다는 사실만으로 구매 경험이나 호의적인 평가라고 판단하지 마세요. 결과가 없을 수도 있으며, 이때도 성공한 조회라면 크레딧을 사용합니다.
기간을 비교하려면 from과 to에 YYYY-MM-DD 형식의 UTC 날짜를 넣습니다. 조건은 created_utc에 적용되고 to의 날짜 전체를 포함합니다. 오늘의 UTC 날짜를 넣으면 오늘 하루 전체가 해당됩니다. 글을 쓴 날짜와 제품을 산 날짜는 다릅니다. 오래전 고장 경험이 최근 댓글에 적힐 수 있으므로, 작성 시점을 사용 경험의 시점으로 바로 바꾸어 해석하지 마세요.
근거를 남기며 로컬에서 분류하기
로컬 표에는 레코드 식별자, 조회 조건, 근거 문장, 조사자가 붙인 분류를 별도 열로 남길 수 있습니다. 봉제 내구성, 지퍼 고장, 착용감, 수리 경험처럼 글에서 확인할 수 있는 이유를 기준으로 삼으세요. 한 글에 칭찬과 비판이 함께 있으면 두 이유를 함께 기록하고, 판단이 어려운 부분을 위한 분류도 마련합니다. 단일 긍정 점수로 모든 맥락을 축약할 필요는 없습니다.
같은 작은 자료를 다른 담당자가 독립적으로 분류해 보게 하고 해석이 갈린 문장을 토론하면 기준을 점검할 수 있습니다. 이는 사용자가 선택하는 조사 방법이며 API의 분석 서비스나 정확도 보장이 아닙니다. 자체 언어 모델이나 감성 사전을 적용한다면 모델 출력과 원문을 구분하고, 어떤 설정과 규칙으로 라벨을 만들었는지 기록하세요. 자동 분류도 조사자의 가정을 없애 주지는 않습니다.
응답은 평면 레코드이며 parent_id나 link_id가 있을 때만 확보한 자료를 연결할 수 있습니다. 빠진 답글과 부모 글이 복원되는 것은 아닙니다. 필드 누락, null, 빈 텍스트를 구분하고 맥락이 없으면 그 한계를 남기세요. 저장한 응답을 다시 읽거나 분류하는 작업은 새 API 호출이 아닙니다. 인용을 공유할 때는 조사에 불필요한 작성자 식별 정보와 제삼자의 권리도 고려해야 합니다.
편향을 결론과 함께 설명하기
BuyItForLife의 내구성 관심은 소비자 전체의 관심과 다를 수 있습니다. 영어 backpack은 다른 언어와 표현, 글을 쓰지 않는 구매자를 포착하지 못합니다. min_score 기준을 높이면 남는 자료도 달라집니다. 이러한 선택은 조사 방법에 적어야 하며, 관련 없는 의견만 완벽히 제거했다고 설명해서는 안 됩니다. 어떤 글을 포함하거나 제외했는지 독자가 이해할 수 있게 근거를 남기세요.
아카이브는 _doc 순서로 반환하며 시간순, 관련성순, 점수순이 아닙니다. 요청당 100개와 쿼리당 100페이지 한도가 있고, 날짜 분할과 중복 제거로 완전성이나 대표성이 생기지는 않습니다. 총수 관계 eq, gte, unknown도 같은 확실성의 숫자가 아닙니다. 실제로 분류한 자료를 분모로 한 비율은 계산할 수 있지만 이를 시장 점유율이나 전체 고객 만족도로 표현하지 마세요.
Reddit Listening은 실시간 감성 분석, 알림, 제공자 측 조사 보고서를 제공하지 않습니다. 검색 조건은 문서에서, 성공한 조회의 비용은 요금 페이지에서, 가입과 청구서는 API 키 페이지에서 확인하세요. 보고서에는 조회 시점, 질문, 조건, 빠진 맥락을 결과와 나란히 적습니다. 같은 쿼리가 앞으로 동일하게 재현되거나 아카이브가 영구 보관된다는 가정을 연구의 근거로 삼지 마세요.
