Зберіть дописи й поясніть, чому обрали саме їх

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 оплачених кредитів. Обліковуйте запити окремо від дописів, прийнятих до аналізу.