Threads API Research (2026-04-17)

Виконавець: Gemini 2.5-flash (делегування Claude → Gemini) Мета: розблокувати Pediatric News Threads pivot + Brand Threads MVP

1. Офіційний API (Meta Threads API)

• Rate limits (2026):
• 250 публікацій на 24 години на один акаунт (ідеально для Pediatric News, де план 3×/день).
• 1,000 відповідей (replies) на 24 години (важливо для Brand Threads AI-коментарів).
• 500 запитів на пошук локацій/тегів на добу.
• OAuth & Scopes:
• threads_basic: базова інфо.
• threads_content_publish: право постити.
• threads_manage_replies: право відповідати та модеровувати.
• threads_keyword_search: право на пошук (потрібен окремий App Review).
• Верифікація: Для бізнес-акаунтів обов'язкова Meta Business Verification (перевірка документів компанії). Триває від 2 до 10 робочих днів.

2. Альтернативи

• Make.com / Zapier: Станом на 2026 мають нативні модулі "Threads". Це найшвидший шлях для проекту Pediatric News (з’єднати Telegram -> Make -> Threads).
• Buffer / Hootsuite: Підтримують Threads для планування постів, але мають обмежений доступ до динамічної аналітики в реальному часі.
• Playwright / Scraping: Не рекомендується для брендових акаунтів Delta Medical. Meta у 2025-2026 роках значно посилила анти-фроду систему. Ризик блокування акаунту за автоматизацію без API складає >80%.
• SDK: Бібліотека python-threads-api та аналоги на Node.js є актуальними, але вони тепер переважно є обгортками навколо офіційного Graph API.

3. Моніторинг

Моніторинг став значно потужнішим завдяки оновленням початку 2026 року.

• Search API: Ендпоінт GET /keyword_search з параметром search_mode=TAG дозволяє шукати пости за хештегами (Topic Tags).
• Фільтрація: Можна фільтрувати результати за media_type (тільки текст або тільки відео) та за часом (since, until).
• Trending Topics: В API з'явився доступ до "Trending" тем, що дозволяє Brand Threads бачити, що зараз обговорюють в українському сегменті медицини/БАДів.
• Engagement: API повертає кількість likes, replies, та shares для кожного поста.

4. Human vs Code (інструкція)

Людська частина (Digital Lead / Dev):

1. Реєстрація: Створити акаунт на developers.facebook.com.
2. Створення App: Обрати тип "Business".
3. Верифікація: Пройти Business Verification (документи Delta Medical).
4. Налаштування Threads: Додати продукт "Threads API" в панелі Meta.
5. App Review: Подати заявку на threads_content_publish та threads_keyword_search. В описі вказати: "Автоматизація новин для лікарів та моніторинг професійних тем".
6. Генерація Token: Отримати Long-lived Access Token (діє 60 днів, потребує авто-оновлення кодом).

Кодова частина (Python/Node.js):

1. OAuth Flow: Реалізація обміну коду на токен.
2. Pediatric News Logic: Скрипт-лісенер Telegram каналу -> Форматування під Threads -> Виклик POST /threads/media.
3. Brand Threads Monitoring: Циклічний запит до keyword_search -> Аналіз тексту (GPT-4o) -> Виклик POST /threads_reply для коментування.
4. Webhook Handler: Обробка вхідних згадок (@mentions) бренду для швидкої реакції.

5. Medical/Health Threads референси

• Mayo Clinic (@mayoclinic): Еталон "Mega-Threads". Розбивають складні дослідження на 5-7 коротких постів з інфографікою.
• Dr. Mike (@doctor.mike): Використовує Threads для коротких спростувань (myth-busting) медичних фейків.
• Cleveland Clinic (@clevelandclinic): Активно використовують опитування (Polls) для залучення аудиторії ("Які симптоми ви помічаєте частіше восени?").
• Zocdoc (@zocdoc): Приклад того, як бренд може використовувати гумор і лайфстайл-поради для пацієнтів, уникаючи сухої реклами.

6. Рекомендація: найкращий шлях

Для Project 1 (Pediatric News):

Використовуйте Make.com. Це дозволить без написання складного бекенду пересилати новини з Telegram у Threads. Ліміт у 250 постів дозволяє масштабуватись до 80 новин на день без проблем.

Для Project 2 (Brand Threads):

Тут потрібен Custom Code (Python).

1. Використовуйте Keyword Search API для моніторингу ключових слів ("вітаміни", "БАДи", "імунітет").
2. Інтегруйте OpenAI API для генерації коментарів.
3. Важливо: Налаштуйте "Human-in-the-loop" — коментарі від бренду спочатку потрапляють у ваш Telegram-чат для апруву адміном, і лише після кліку "OK" публікуються в Threads. Це захистить від галюцинацій AI в медичній тематиці.

Статус на зараз: API повністю готовий до впровадження. Головна затримка може бути лише в App Review від Meta (закладайте 2 тижні).