Meta Ad Library: как получить

1. developers.facebook.com (рабочий FB-аккаунт) → My Apps → Create App. Если попросит — сначала зарегистрироваться как разработчик (подтверждение почты/телефона).
2. Шаг «Добавьте сценарии использования»: слева фильтр «Другое» → выбрать «Создать приложение без сценариев использования» (ID приложения без разрешений и продуктов — для Ad Library большего не нужно). Галочки Marketing API / Ads Manager / Threads НЕ ставить (тянут App Review), нижний вариант «Другое (going away soon)» не брать.
3. Дальше: название periscope, почта рабочая; тип приложения, если спросит — Business. Create App.
4. Сразу заполнить Settings → Basic: Privacy Policy URL — https://www.goodville.me/privacy-policy (проверенная страница нашего сайта), категория, контактный e-mail → Save. Без этого Meta держит функции приложения отключёнными (ошибка «Функция недоступна» при генерации токена).
5. Пройти подтверждение личности: facebook.com/ID (документ + селфи). Именно оно открывает Ad Library API; проверка занимает дни — запустить сразу, не дожидаясь остального. Без него ads_archive отвечает ошибкой прав.
6. Токен: Graph API Explorer → справа выбрать приложение periscope → User Token → Generate Access Token (во всплывшем окне FB подтвердить вход). Специальные permissions добавлять не нужно.
7. Этот токен живёт ~2 часа. Обменять на long-lived (~60 дней): App ID и App Secret взять в Settings → Basic приложения, затем
   curl "https://graph.facebook.com/v23.0/oauth/access_token?grant_type=fb_exchange_token&client_id=APP_ID&client_secret=APP_SECRET&fb_exchange_token=КОРОТКИЙ_ТОКЕН"
   — в ответе поле access_token, его и вставить сюда.
8. Проверка, что всё работает:
   curl "https://graph.facebook.com/v23.0/ads_archive?search_terms=township&ad_type=ALL&ad_reached_countries=['DE']&access_token=ТОКЕН"
   — должен вернуться JSON со списком объявлений. Ошибка «Application does not have permission» = верификация личности ещё не прошла.

Порядок важен: приложение создаётся за 5 минут, но токен полноценно заработает только после верификации личности — подать её сразу. Официальные страницы: Ad Library API, справочник ads_archive.

AppMagic: как получить

1. Залогиниться на appmagic.rocks под рабочим аккаунтом.
2. Проверить, входит ли API в тариф: настройки аккаунта → раздел API. Если раздела нет — спросить в чате поддержки, включён ли API-доступ.
3. Если API есть — сгенерировать/скопировать токен и вставить сюда.
4. Если API в тарифе нет — ключ не нужен: работаем через штатный CSV-экспорт из UI, файлы класть в data/inbox/appmagic/ (маршрут уже заложен в плане).

YouTube Data API: как получить

1. Открыть console.cloud.google.com (рабочий Google-аккаунт), выбрать/создать проект.
2. Включить API: страница YouTube Data API v3 → Enable.
3. APIs & Services → Credentials → Create credentials → API key, скопировать сюда.
4. Рекомендуется ограничить ключ: Edit key → API restrictions → только YouTube Data API v3.
5. Проверка:
   curl "https://www.googleapis.com/youtube/v3/search?part=snippet&q=township&maxResults=1&key=КЛЮЧ"
   — должен вернуться JSON с одним видео. Квота 10 000 юнитов/день (search = 100 юнитов) — нам хватает.

Reddit API: как получить

1. Под рабочим Reddit-аккаунтом открыть reddit.com/prefs/apps → create another app…
2. Тип — script. Name: periscope. Redirect uri: http://localhost:8080 (не используется, но поле обязательное).
3. client_id — строка под названием приложения (под «personal use script»), secret — в поле рядом.
4. Проверка:
   curl -A "periscope/0.1" --user "CLIENT_ID:SECRET" -d grant_type=client_credentials https://www.reddit.com/api/v1/access_token
   — в ответе должен быть access_token. Бесплатный лимит 100 запросов/мин — достаточно.