Підготуйте пару запитів
Рядок A — transit, рядок B — housing; обидва стосуються urbanplanning. Для A візьміть https://api.subredditdata.com/v1/search?q=transit&subreddit=urbanplanning&limit=3, для B змініть лише q на housing. Це запропонований відбір, а не підтвердження наявності певного тексту. Над таблицею запишіть, як саме хочете зіставити транспортну доступність і житло.
У локальній таблиці залиште колонки для маршруту, subreddit, точного q, kind, from, to, min_score, limit, переглянутих сторінок, часу звернення та його результату. Для двох тем збережіть однакові маршрут, спільноту, вид матеріалу, дати, поріг і межу читання. Якщо фільтра немає, зазначте це прямо. Таблицю веде дослідник; API не створює замість нього аналітичний звіт.
Узгодьте календарні межі
Дати задавайте як YYYY-MM-DD у UTC для created_utc. Навчальний приклад from=2026-04-01, to=2026-04-30 охоплює повні квітневі дні без обіцянки їхнього архівного покриття. Коли to — сьогодні, враховується вся поточна доба до 23:59:59 UTC, а не час до запиту. Однакові межі допомагають описати відбір, але не усувають неоднакові прогалини.
Якщо дати не потрібні, явно позначте їхню відсутність в обох рядках. Не звужуйте непомітно лише housing, побачивши незвичний результат. Зміну задуму оформіть новою парою запитів: так наступний читач зрозуміє, які умови справді були однаковими.
З’ясуйте, що відбирають слова й обмеження
q шукає в title і text із поєднанням кількох аналізованих слів через AND у полі, яке дає збіг. Додаткове слово не є альтернативою та не гарантує точну фразу. Поясніть вибір термінів: транспортна розмова може не містити transit. Відсутність такого збігу не доводить відсутності теми у спільноті.
Порядок _doc не є хронологією, релевантністю чи рейтингом. min_score змінює відбір, не перевіряючи достовірність тексту. Межі 100 записів на запит і 100 сторінок означають, що однакові зусилля читання не забезпечують однакового охоплення. Значення eq, gte та unknown пояснюють підсумок відповіді, а не репрезентативність спільноти.
Занесіть перетин до окремого обліку
До реально отриманого тексту додайте локальні нотатки: практичне питання, запропоновану відповідь і невідомий контекст. Матеріал про житло біля станції може входити до обох добірок. Якщо наявний надійний ідентифікатор, використайте його для перевірки перетину; відсутність поля не доводить унікальності. Порахуйте перетини окремо, перш ніж складати підсумок, та не ототожнюйте записи з людьми.
Для умовного прикладу про житло біля станції залиште одне локальне посилання на запис і дві тематичні позначки. Поряд запишіть практичну проблему, запропоноване рішення та підставу відбору. Не вигадуйте архівну цитату, щоб завершити зразок. За відсутності відповідного тексту залиште місце порожнім і зафіксуйте отриманий результат.
Відповідь плоска, необов’язкові поля можуть бути порожніми. parent_id і link_id допомагають локальному зіставленню, коли присутні, але не відновлюють гарантовано всю гілку. Позначайте невизначені випадки замість припущень про пропущені репліки. Тематичні категорії й пояснення належать вашій роботі; сервер не вимірює тональність, демографію або значущість теми для всіх учасників.
Завершіть запискою та наступним питанням
Зазначте кількість прочитаних записів, перетинів, виключень і невизначених випадків. Описуйте різницю в переглянутому матеріалі, не оголошуйте її зростанням спільноти, падінням інтересу або статистично значущою зміною. Навіть запит із тими самими умовами може згодом повернути інший набір. Збережені відповіді дають змогу перевірити ваше читання, не гарантуючи незмінності архіву.
Успішний запит коштує один кредит, навіть якщо порожній. Успішний повтор після втрати відповіді може коштувати ще один; локальний перегляд нотаток не звертається до API. Підсумком можуть бути точніше сформульоване запитання, контекстні приклади та список браку даних. Більша кількість збігів одного слова не встановлює рейтинг важливості тем.
Умови й збережені відповіді додайте до робочих матеріалів записки, щоб колега міг оцінити те саме підґрунтя без вашого API-ключа. Наступні сторінки можуть доповнити приклади; однакові зусилля читання все одно не означають однакового охоплення спільноти.