# Apify

Собирайте посты, профили и страницы парсерами Apify

Запуск actor'ов Apify и выгрузка датасетов — парсинг публичных страниц и соцсетей

## Как агент работает с Apify

Агент не пишет собственный парсер, а запускает готовый actor из каталога Apify Store: у актора есть имя вида apify~instagram-hashtag-scraper и input — JSON с хэштегами, аккаунтами и лимитом результатов. Короткие задачи идут синхронно: один запрос ждёт до 300 секунд и возвращает собранные items прямо в ответ. Длинные — асинхронно: агент стартует run, опрашивает его статус и, когда тот доходит до SUCCEEDED, выгружает датасет по defaultDatasetId.

Запуск проходит статусы READY → RUNNING → SUCCEEDED, FAILED или ABORTED, и агент читает не только результат, но и лог: по нему видно, упёрся ли парсер в защиту сайта, вернул ли пустую выдачу или свалился на неверном input. Застрявший прогон он останавливает, чтобы тот не жёг compute units дальше, а вместо бесконечного опроса статуса может зарегистрировать webhook на завершение и забрать данные по факту.

Через Apify агент читает публичные данные — то же, что видит незалогиненный посетитель страницы: посты, Reels и видео по хэштегу, ленты и профили аккаунтов, выдачу поиска, карточки каталогов и карт. Опубликовать пост, поставить лайк или написать в чужой аккаунт через Apify невозможно: платформа только собирает. Меняется здесь единственное — ваш собственный аккаунт Apify: каждый запуск создаёт run и датасет и расходует кредиты плана.

Расход считается по платформе и по самому актору. Платформенный — в compute units: 1 CU это 1 ГБ памяти в течение часа, на бесплатном плане и Starter он стоит $0.2 за CU, а бесплатный план даёт $5 расхода в месяц без привязки карты, 25 параллельных запусков и до 16 ГБ памяти на прогон. Часть акторов из Store берёт поверх этого свою цену за результат, поэтому большой сбор агент сначала оценивает по числу результатов, а не запускает вслепую. Датасет он выгружает сразу после прогона: на бесплатном плане хранятся только 10 последних запусков и только 4 месяца.

## Сценарии интеграции

### Сбор по хэштегу
Агент запустит парсер Instagram или TikTok по нужным хэштегам и вернёт посты и Reels с автором, датой, просмотрами и лайками.

### Разбор аккаунтов конкурентов
Агент соберёт последние публикации выбранных аккаунтов, отсортирует их по популярности и покажет, что у конкурента заходит.

### Отбор вирусного контента
Агент отфильтрует выдачу по числу лайков и датному окну — например, ролики по теме за последние 30 дней, набравшие больше 10 000.

### Повтор сохранённого таска
Агент запустит сохранённый в Apify таск с уже настроенным парсером и выгрузит свежий датасет — параметры задавать заново не нужно.

### Долгий сбор без ожидания
Агент запустит большой прогон асинхронно, повесит webhook на завершение и выгрузит датасет по defaultDatasetId, как только статус дойдёт до SUCCEEDED.

### Разбор упавшего прогона
Агент поднимет лог запуска и покажет, во что упёрся парсер — защиту сайта, пустую выдачу или неверный input, — а зависший прогон остановит, чтобы тот не жёг кредиты.

## Как подключить

**Перед подключением**

- Аккаунт Apify и личный API-токен из Settings → API & Integrations
- Бесплатный план — $5 расхода в месяц без привязки карты
- Платный план от $29 в месяц для длинных прогонов и больших выгрузок

### Зарегистрируйтесь на console.apify.com
Бесплатный план даёт $5 расхода в месяц без карты, 25 параллельных запусков и до 16 ГБ памяти на прогон. Карта нужна только для длинных и больших сборов.

### Откройте Settings → «API & Integrations»
Раздел настроек аккаунта: там же личный токен и создаётся. Токен один на весь аккаунт и даёт те же права на запуски и датасеты, что есть у вас самих.

### Скопируйте личный API-токен целиком
Значение скрыто и раскрывается по клику. Копируйте строку без пробелов по краям — лишний символ даёт ошибку unauthorized.

### Найдите нужный actor в Apify Store
Агент запускает готовый парсер по имени вида apify~instagram-hashtag-scraper. Откройте Apify Store и запомните имя актора, который вам нужен.

## Частые вопросы

### Как подключить Apify?
Личным API-токеном из консоли console.apify.com: раздел Settings → API & Integrations, там же он и создаётся. Скопируйте строку целиком, без пробелов по краям — лишний символ даёт ошибку unauthorized.

### Что агент видит через Apify?
То, что собрал запущенный actor: публичные посты, видео, профили и страницы. Плюс служебное по вашему аккаунту — статусы и логи запусков, содержимое датасетов и остаток лимитов плана.

### Пишет ли агент куда-нибудь?
В соцсети и на сайты — нет: опубликовать пост, оставить комментарий или отправить сообщение через Apify невозможно. Записи появляются только в вашем аккаунте Apify — запуски акторов, их датасеты и, если нужно, webhook на завершение прогона.

### Что со стоимостью и лимитами?
Бесплатный план даёт $5 расхода в месяц без карты, 25 параллельных запусков и до 16 ГБ памяти на прогон; compute unit — это 1 ГБ памяти в течение часа, $0.2 за CU на бесплатном плане и Starter. Синхронный запуск ждёт результат не дольше 300 секунд: всё, что длиннее, агент ведёт асинхронно с опросом статуса.

[Открыть Apify](https://console.apify.com)