Соберите публикации и сохраните логику отбора

API сбора данных Reddit для исследования AskSocialScience: определите вопрос, просмотрите три публикации и зафиксируйте правила сравнения двух недель.

Получить API-ключ

Пример запроса

cURL

curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.redditcollector.com/v1/posts?subreddit=AskSocialScience&limit=3"

Сначала решите, что считать исследовательским вопросом

Предположим, команда изучает, как в AskSocialScience формулируют запросы на научное объяснение в течение двух недель. Единица анализа — начальная публикация, а не все ответы под ней. Заранее решите, включать ли сообщения без прямого вопроса, если автор просит привести исследования. Reddit Collector предоставляет API для сбора данных из независимого исторического архива Reddit; это не официальный сервис и не источник данных в реальном времени. Результатом такого задания будет ограниченная подборка полученных публикаций с описанными правилами отбора. По ней можно разбирать способы постановки вопросов, но нельзя оценивать мнение всего сообщества.

В плане сбора укажите сообщество, единицу анализа, нужный период, правила включения и условие остановки. Решите, изучаете ли вы публикации, комментарии или связи между доступными записями. Обоснуйте использование ключевого слова и порога оценки: такие условия могут исключать важные материалы. Первая небольшая страница и фильтр min_score не создают случайную или репрезентативную выборку. Решения команды следует описывать отдельно от возможностей API.

Архив не гарантирует полноты охвата, неизменности результатов, фиксированной схемы или постоянной доступности записи. Сохраняйте фактически полученные ответы вместе с планом и журналом обработки. Это позволит повторно анализировать собственную копию, но новый удалённый запрос может дать другой набор. Отсутствующие записи остаются ограничением исследования, а не доказательством того, что обсуждение никогда не происходило. Не восстанавливайте пропуски вымышленными цитатами.

Три публикации для знакомства с материалом

Пример: GET https://api.redditcollector.com/v1/posts?subreddit=AskSocialScience&limit=3. Маршрут posts ограничивает тип публикациями, subreddit выбирает AskSocialScience, limit запрашивает до трёх записей. По умолчанию используется первая страница. Передавайте с сервера X-API-Key: <ключ> либо Authorization: Bearer <ключ>; поддерживаются оба варианта. Не добавляйте секрет в открытый исследовательский блокнот или общий журнал запросов команды.

Синтетический демонстрационный фрагмент, не результат реального вызова: {"data":[],"pagination":{"page":1,"limit":3,"total":0,"relation":"eq"},"credits":{"cost":1,"balance":99}}. Баланс вымышлен. Успешная пустая первая страница стоит один кредит и не даёт публикаций для анализа. Она не устанавливает исторический объём активности сообщества. В показанном запросе нет ограничения дат: прежде чем использовать его для исследования периода, добавьте from и to.

Проверьте полученные записи перед выделением цитат или локальным кодированием тем. from и to используют YYYY-MM-DD в UTC для created_utc, причём последний день to включается целиком. Внутренний порядок _doc не является хронологией, релевантностью, оценкой или случайным отбором. Условие даты определяет включение независимо от порядка. Поля могут отсутствовать; опишите обработку неизвестного времени или недоступной связи обсуждения, не придумывая значения.

Какие исключения допустимы в вашей выборке

При первом просмотре оставьте отбор достаточно широким, чтобы увидеть язык авторов. Публикация может описывать исследование без выбранного вами ключевого слова. Порог оценки может убрать малоизвестный или непопулярный вопрос. Добавляйте q и min_score, когда понимаете, какие случаи они исключат и зачем это нужно исследованию. Если правило меняется после просмотра, сохраните новую версию плана: иначе коллеги не поймут, по каким условиям собиралась каждая часть материала.

Для сопоставления недель используйте одинаковые правила включения и заранее установленный бюджет запросов на каждый период. Равный бюджет не означает равного охвата. Если в одной неделе сбор упёрся в границу страниц, а в другой вернул мало публикаций, опишите оба обстоятельства. Разницу в доступном материале нельзя автоматически считать разницей в активности участников.

От плана к рабочему сбору

Храните рядом с ответами краткий план: сообщество, даты, единицу анализа, исключения и причину остановки. Руководство переводит этот план в два окна UTC, документация поясняет параметры. На странице ключа подготовьте доступ. Стоимость — $1 за 1000 успешных запросов, включая пустые; минимальное пополнение $50 даёт 50000 оплаченных кредитов. Считайте запросы отдельно от публикаций, принятых в анализ.