API Threads Статистика вовлечённости

Временно недоступна

Мы восстанавливаем эту возможность. До тех пор вызовы обычно завершаются ошибкой или не возвращают результатов; неудачные вызовы и пустые результаты не оплачиваются.

POST

Состояние API

Состояние за 24 ч
Временно недоступна
  • Стабильно / норма
  • Доступно
  • Ограничено
  • Почти недоступно
Временно недоступна

Последние 24 часа

Последние 30 дней

Рассчитайте вовлечённость аккаунта Threads по username на основе его последних постов. posts задаёт, сколько постов использовать: от 3 до 50 (по умолчанию 20). Учитываются только посты, написанные самим аккаунтом: ответы и репосты не входят, закреплённые посты входят. Вы получите среднее и медиану лайков и взаимодействий, среднее число ответов, репостов, цитат и отправок, engagement_rate в процентах, posts_per_week, распределение постов по часам и дням недели в UTC, соотношение типов постов и 3 лучших поста. Возвращается один объект, а не список.

Отправьте POST https://api.everyinfra.com/api/v1/social, указав в platform значение threads, а в action — engagement. Цена: $0.56 за 1 000 запросов ($0.000556 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

#
Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Threads Статистика вовлечённости (threads/engagement).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: threads и action: engagement, а параметры передайте в params.
- Обязательные параметры:
  - username: Имя пользователя Threads (с @ или без) для profile, user_posts, followers, user_replies, user_media, user_reposts, followers_list, following_list и engagement.
- Необязательные параметры:
  - posts: Сколько последних постов аккаунта использует engagement: целое число от 3 до 50, по умолчанию 20.
- Возвращает один объект. Основные поля: username, display_name, url, follower_count, is_verified, sample_size (engagement: сколько постов вошло в расч…), period_start (engagement: время публикации (UTC) само…), period_end (engagement: время публикации (UTC) само…), posts_per_week (engagement: среднее число постов в неде…), avg_like_count (engagement: среднее число лайков на пос…), avg_comment_count (engagement: среднее число ответов на по…), avg_repost_count (engagement: среднее число репостов на п…); всего полей: 23, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=threads.
- Пример тела запроса:
{
  "platform": "threads",
  "action": "engagement",
  "params": {
    "username": "zuck"
  }
}
- Цена: $0.56 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.

Параметры запроса

#
ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаthreadsИдентификатор платформы, фиксированное значение.
actionbodystringДаengagementИдентификатор возможности, фиксированное значение.
usernamebody.paramsstringДа-Имя пользователя Threads (с @ или без) для profile, user_posts, followers, user_replies, user_media, user_reposts, followers_list, following_list и engagement. Действия profile и user_posts не принимают полные URL профилей; user_replies, user_media, user_reposts, followers_list, following_list и engagement также принимают ссылку на профиль, например https://www.threads.com/@mosseri. Действие followers возвращает общее число подписчиков; чтобы получить сами аккаунты, используйте followers_list и following_list.
postsbody.paramsintegerНет-Сколько последних постов аккаунта использует engagement: целое число от 3 до 50, по умолчанию 20.

Примеры кода

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "threads",
  "action": "engagement",
  "params": {
    "username": "zuck"
  }
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

Пример ответа

#
Для этих параметров пока нет примера ответа. Здесь показаны структура ответа и поля из описания API, а … служит заполнителем; это не результат реального вызова.
json
{  "id": "req_…",  "platform": "threads",  "action": "engagement",  "results": {    "username": …,    "display_name": …,    "url": …,    "follower_count": …,    "is_verified": …,    "sample_size": …,    "period_start": …,    "period_end": …,    "posts_per_week": …,    "avg_like_count": …,    "avg_comment_count": …,    "avg_repost_count": …,    "avg_quote_count": …,    "avg_share_count": …,    "median_like_count": …,    "avg_interactions": …,    "median_interactions": …,    "engagement_rate": …,    "platform": …,    "posts_by_hour_utc": …,    "top_hours_utc": …,    "posts_by_weekday_utc": …,    "media_mix": …,    "top_posts": …  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Поля ответа

#

Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.

ПолеЗначение
usernameИмя пользователя (@handle).
display_nameОтображаемое имя; может отличаться от username.
urlСсылка на запись на платформе.
follower_countПодписчики. null означает, что значение не раскрыто, а не 0.
is_verifiedПодтверждён ли аккаунт платформой. null означает, что это невозможно определить.
sample_sizeengagement: сколько постов вошло в расчёт. Учитываются только посты, написанные самим аккаунтом: ответы и репосты не входят, закреплённые посты входят.
period_startengagement: время публикации (UTC) самого раннего поста, вошедшего в расчёт.
period_endengagement: время публикации (UTC) самого позднего поста, вошедшего в расчёт.
posts_per_weekengagement: среднее число постов в неделю за этот период.
avg_like_countengagement: среднее число лайков на пост.
avg_comment_countengagement: среднее число ответов на пост.
avg_repost_countengagement: среднее число репостов на пост.
avg_quote_countengagement: среднее число цитат на пост.
avg_share_countengagement: среднее число отправок на пост.
median_like_countengagement: медиана лайков на пост.
avg_interactionsengagement: среднее число взаимодействий на пост; взаимодействия — это сумма лайков, ответов, репостов, цитат и отправок.
median_interactionsengagement: медиана взаимодействий на пост.
engagement_rateengagement: уровень вовлечённости в процентах: avg_interactions ÷ follower_count × 100. 0.17 означает 0,17%.
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).
posts_by_hour_utcengagement: число постов по часам UTC, 24 числа; первое — для часа 0.
top_hours_utcengagement: часы (UTC, от 0 до 23) с наибольшим числом постов, по убыванию.
posts_by_weekday_utcengagement: число постов по дням недели (UTC), 7 чисел, начиная с воскресенья.
media_mixengagement: сколько постов каждого вида: text (только текст), image (одно изображение), video и carousel (несколько изображений или изображения вместе с видео).
top_postsengagement: посты с наибольшим числом взаимодействий (до 3), у каждого есть url, text, posted_at, interactions, like_count, comment_count, repost_count, quote_count и share_count.

Ошибки и оплата

#
401
Ключ отсутствует или недействителен.
402
Недостаточно средств на балансе. Сначала пополните баланс.
422
Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429
Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503
Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто)
Нет данных. Без списания.

Ошибки

Google Analytics: нужно согласие Приватность