API Instagram Аналитика аккаунта
Состояние API
- Состояние за 24 ч
- Норма
- Среднее время за 24 ч
- —
- Стабильно / норма
- Доступно
- Ограничено
- Почти недоступно
Последние 24 часа
Последние 30 дней
Получите обзор аккаунта Instagram по имени пользователя на основе публичного профиля. В ответе есть описание, категория, число подписчиков и постов, флаги типа аккаунта и недавние посты. Ответ не содержит сведений о возрасте, поле, интересах, покупателях или других характеристиках и не делает выводов о них.
Те же параметры и поля, что и у profile. Ответ также содержит объект persona верхнего уровня: сгенерированный ИИ профиль аккаунта на основе данных профиля и последних публикаций.
Цена: $0.56 за 1 000 запросов ($0.000556 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.
Промпт для ИИ
Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Instagram Аналитика аккаунта (instagram/persona).
Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: instagram и action: persona, а параметры передайте в params.
- Обязательные параметры:
- username: Имя пользователя аккаунта Instagram без символа @ или полный URL профиля. Используется в profile, persona, user_posts и reels для получения данных аккаунта.
- Возвращает один объект. Основные поля: username, display_name, bio, follower_count, following_count, post_count, is_private, is_verified, is_business, is_professional, category, external_url; всего полей: 19, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=instagram.
- Ответы также содержат объект persona верхнего уровня (industry, niche, authenticity, summary): сгенерированный ИИ профиль аккаунта на английском языке; null, если его не удалось сгенерировать.
- Пример тела запроса:
{
"platform": "instagram",
"action": "persona",
"params": {
"username": "nasa"
}
}
- Цена: $0.56 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.
Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.Параметры запроса
| Имя | Расположение | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|---|
Authorization | header | string | Да | - | Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода. |
platform | body | string | Да | instagram | Идентификатор платформы, фиксированное значение. |
action | body | string | Да | persona | Идентификатор возможности, фиксированное значение. |
username | body.params | string | Да | - | Имя пользователя аккаунта Instagram без символа @ или полный URL профиля. Используется в profile, persona, user_posts и reels для получения данных аккаунта. Действие followers возвращает только общее число подписчиков, а followers_list и following_list возвращают списки аккаунтов. |
Примеры кода
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "instagram",
"action": "persona",
"params": {
"username": "nasa"
}
}'Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.
Пример ответа
Получено September 26, 2026 at 08:56 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты). id, billing и quota меняются при каждом вызове, поэтому показана только их структура.
{
"id": "req_…",
"platform": "instagram",
"action": "persona",
"results": {
"username": "nasa",
"display_name": "NASA",
"bio": "Making the seemingly impossible, possible. ✨",
"follower_count": 104336090,
"following_count": 89,
"post_count": 4934,
"is_private": false,
"is_verified": true,
"is_business": false,
"is_professional": false,
"external_url": "https://www.nasa.gov",
"avatar_url": "https://scontent.cdninstagram.com/•••",
"recent_posts": [
{
"post_id": "DdHyaYAifb6",
"url": "https://www.instagram.com/p/DdHyaYAifb6",
"text": "Cementing their names in history.\n\nThe Artemis III crew is leaving their mark — literally. The astronauts recently signed their names on the hardware that will be inside their Orion spacecraft during their low Earth orbit mission, launching in 2027.\n\nImage descriptions:\n\n1. The A…",
"media_type": "image",
"like_count": 0,
"comment_count": 0,
"view_count": 0,
"author_username": "nasa",
"posted_at": "2026-09-10T00:00:00+00:00"
},
{
"post_id": "DdWyDLcGiqo",
"url": "https://www.instagram.com/p/DdWyDLcGiqo",
"text": "Southern Hemisphere Milky Way galaxy view from the @••• cupola. This 3s exposure series captured two of my favorite cupola views, the particularly dense Milky Way galaxy as seen from the Southern Hemisphere, and the bright, colorful lights of squid fishing boats (here, the brig…",
"media_type": "image",
"like_count": 0,
"comment_count": 0,
"view_count": 0,
"author_username": "•••",
"posted_at": "2026-09-16T00:00:00+00:00"
},
{
"post_id": "DdT_4GMka0z",
"url": "https://www.instagram.com/p/DdT_4GMka0z",
"text": "In a class of their own\n\nHidden within this star-forming nebula (captured by our Webb telescope in one of its largest images to date) are strange objects called brown dwarfs. Generally less massive than stars and more massive than planets, they are neither. They form the same way…",
"media_type": "image",
"like_count": 0,
"comment_count": 0,
"view_count": 0,
"author_username": "•••",
"posted_at": "2026-09-15T00:00:00+00:00"
}
]
},
"persona": {
"industry": …,
"niche": …,
"authenticity": …,
"summary": …
},
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}Поля ответа
Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.
| Поле | Значение |
|---|---|
username | Имя пользователя (@handle). |
display_name | Отображаемое имя; может отличаться от username. |
bio | Описание профиля, написанное владельцем аккаунта; может содержать переносы строк и эмодзи. |
follower_count | Подписчики. null означает, что значение не раскрыто, а не 0. |
following_count | Подписки. null означает, что значение не раскрыто, а не 0. |
post_count | Всего публикаций. null означает, что значение не раскрыто, а не 0. |
is_private | Трактуется так же, как на самой платформе |
is_verified | Подтверждён ли аккаунт платформой. null означает, что это невозможно определить. |
is_business | Трактуется так же, как на самой платформе |
is_professional | Трактуется так же, как на самой платформе |
category | Название категории во внутренней классификации платформы. Категории разных платформ не унифицированы. |
external_url | Трактуется так же, как на самой платформе |
avatar_url | Ссылка на аватар. Некоторые платформы возвращают CDN-ссылки с заданным размером, срок действия которых может истечь. |
user_id | Уникальный ID пользователя на платформе. |
avatar_hd_url | Трактуется так же, как на самой платформе |
external_urls | Трактуется так же, как на самой платформе |
has_reels | Трактуется так же, как на самой платформе |
highlight_count | Трактуется так же, как на самой платформе |
recent_posts | Трактуется так же, как на самой платформе |
Ответ также содержит объект persona на верхнем уровне, рядом с results, как при синхронных вызовах, так и в асинхронных задачах (mode: async): сгенерированный ИИ профиль аккаунта на английском языке на основе данных профиля и не более 6 последних публикаций. Если профиль не удалось сгенерировать, значение равно null, а results возвращаются как обычно.
| Поле | Значение |
|---|---|
persona.industry | Отрасль, к которой относится аккаунт. |
persona.niche | Ниша внутри этой отрасли. |
persona.authenticity | Оценка подлинности, обычно с кратким обоснованием. |
persona.summary | Краткое описание аккаунта в нескольких предложениях. |
Ошибки и оплата
- 401
- Ключ отсутствует или недействителен.
- 402
- Недостаточно средств на балансе. Сначала пополните баланс.
- 422
- Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
- 429
- Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
- 503
- Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
- 200 (пусто)
- Нет данных. Без списания.