API Threads Пакетное получение постов

POST

Состояние API

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

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

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

Получите данные до 20 постов Threads за один вызов по urls, каждый элемент — ссылка на пост. Каждый найденный пост — одна запись с текстом, автором, числом лайков, комментариев, репостов, цитат, отправок и просмотров, временем публикации и медиа, а также input — переданным вами элементом. Оплата за каждый пост; ненайденные посты не оплачиваются и возвращаются в missed. Массив с дубликатом, нераспознанным элементом или более чем 20 элементами отклоняется с кодом 422 до какого-либо списания.

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

Промпт для ИИ

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

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: threads и action: posts_batch, а параметры передайте в params.
- Обязательные параметры:
  - urls: Ссылки на посты Threads для posts_batch в виде массива до 20 элементов; строка с элементами через запятую не принимается. Указывайте каждую ссылку так же, как для post_detail. Указывайте каждый пост один раз.
- Необязательные параметры:
  - limit: Максимальное число записей в этом вызове, целое число не меньше 1. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей.
- Возвращает список записей. Основные поля каждой записи: id, code (Код поста: часть ссылки на пост после /…), url, text, author_username, author_name, author_id, author_avatar_url (URL аватара автора), author_is_verified (Есть ли у аккаунта автора значок подтве…), author_is_private (Закрыт ли аккаунт автора), author_follower_count, like_count; всего полей: 74, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=threads.
- Пример тела запроса:
{
  "platform": "threads",
  "action": "posts_batch",
  "params": {
    "urls": [
      "https://www.threads.com/@zuck/post/DfaNgswkQPG"
    ]
  }
}
- Цена: $0.56 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Этот эндпоинт работает только синхронно; не добавляйте "mode": "async" в тело запроса.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

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

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

#
ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаthreadsИдентификатор платформы, фиксированное значение.
actionbodystringДаposts_batchИдентификатор возможности, фиксированное значение.
urlsbody.paramsarrayДа-Ссылки на посты Threads для posts_batch в виде массива до 20 элементов; строка с элементами через запятую не принимается. Указывайте каждую ссылку так же, как для post_detail. Указывайте каждый пост один раз. Запрос с нераспознанным элементом, дубликатом или более чем 20 элементами отклоняется с кодом 422 до какого-либо списания. Оплата за каждый пост; ненайденные посты не оплачиваются и перечисляются в missed.
limitbody.paramsinteger (1–)Нет-Максимальное число записей в этом вызове, целое число не меньше 1. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей.

Примеры кода

#
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": "posts_batch",
  "params": {
    "urls": [
      "https://www.threads.com/@zuck/post/DfaNgswkQPG"
    ]
  }
}'

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

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

#
Для этих параметров пока нет примера ответа. Здесь показаны структура ответа и поля из описания API, а … служит заполнителем; это не результат реального вызова.
json
{  "id": "req_…",  "platform": "threads",  "action": "posts_batch",  "results": [    {      "id": …,      "code": …,      "url": …,      "text": …,      "author_username": …,      "author_name": …,      "author_id": …,      "author_avatar_url": …,      "author_is_verified": …,      "author_is_private": …,      "author_follower_count": …,      "like_count": …,      "comment_count": …,      "repost_count": …,      "quote_count": …,      "share_count": …,      "view_count": …,      "posted_at": …,      "media_type": …,      "image_count": …,      "video_count": …,      "media_url": …,      "video_duration_seconds": …,      "topic": …,      "topic_id": …,      "topic_name": …,      "topic_emoji": …,      "topic_is_community": …,      "language": …,      "is_edited": …,      "is_reply": …,      "reply_to_username": …,      "root_post_author_username": …,      "reply_level": …,      "is_pinned": …,      "is_pinned_by_author": …,      "is_spoiler": …,      "reply_control": …,      "counts_hidden": …,      "thread_id": …,      "thread_length": …,      "thread_position": …,      "is_federated": …,      "is_paid_partnership": …,      "ai_label": …,      "text_translation": …,      "attached_text": …,      "fediverse_like_count": …,      "fediverse_reply_count": …,      "is_liked_by_author": …,      "is_collapsed": …,      "reply_approval_enabled": …,      "is_ghost_post": …,      "ghost_expires_at": …,      "is_markup": …,      "hashtags": …,      "mentions": …,      "links": …,      "image_urls": …,      "video_urls": …,      "tagged_users": …,      "media": …,      "link_preview": …,      "location": …,      "quoted_post": …,      "reposted_post": …,      "gif": …,      "music": …,      "podcast": …,      "scorecard": …,      "trend": …,      "author_badge": …,      "custom_like": …,      "platform": …,      "input": …    }  ],  "count": …,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Поля ответа

#

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

ПолеЗначение
idУникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться.
codeКод поста: часть ссылки на пост после /post/.
urlСсылка на запись на платформе.
textОсновной текст без HTML возвращается полностью и никогда не обрезается (на нескольких платформах результаты списковых запросов содержат только фрагмент; это указано в примечаниях к полям платформы).
author_usernameИмя пользователя автора (@handle), обычно подходит для URL.
author_nameОтображаемое имя автора.
author_idУникальный ID автора на платформе.
author_avatar_urlURL аватара автора; подписанная ссылка с ограниченным сроком действия.
author_is_verifiedЕсть ли у аккаунта автора значок подтверждения.
author_is_privateЗакрыт ли аккаунт автора.
author_follower_countЧисло подписчиков автора. null означает, что значение не раскрыто.
like_countЛайки. null означает, что платформа или эта возможность не раскрывает значение; это не 0.
comment_countКомментарии. null означает, что значение не раскрыто, а не 0.
repost_countРепосты (без учёта цитирований). null означает, что значение не раскрыто.
quote_countЦитирования: сколько раз другие процитировали этот пост в своих постах. null означает, что значение не раскрывается, а не 0.
share_countКоличество раз, когда записью поделились. null означает, что значение не раскрыто, а не 0.
view_countПросмотры или воспроизведения. null означает, что значение не раскрыто, а не 0.
posted_atВремя публикации в ISO 8601, UTC (например, 2026-08-07T12:34:56+00:00). Нестандартные строки платформы передаются как есть, поэтому учитывайте это при разборе. null означает, что платформа его не раскрывает.
media_typeТип поста: text (только текст), image (одно изображение), video (одно видео) или carousel (несколько изображений либо изображения вместе с видео).
image_countЧисло изображений.
video_countЧисло видео.
media_urlURL первого вложения; подписанная ссылка с ограниченным сроком действия.
video_duration_secondsДлительность первого видео в секундах; длительность каждого видео указана в duration_seconds соответствующей записи media.
topicВнутреннее название темы, к которой привязан пост, например bakingthreads; отображаемое название — в topic_name.
topic_idID темы, к которой привязан пост.
topic_nameОтображаемое название темы, например Baking Threads.
topic_emojiЭмодзи-значок темы (сообщества).
topic_is_communityЯвляется ли тема сообществом.
languageКод языка контента (например, zh, en) по определению платформы; может быть неточным.
is_editedБыл ли пост отредактирован.
is_replyЯвляется ли этот пост ответом.
reply_to_usernameИмя пользователя, которому отвечает этот пост; отсутствует, если пост не является ответом.
root_post_author_usernameИмя пользователя автора поста, с которого начинается эта ветка.
reply_levelГлубина ответа: 1 — прямой ответ на основной пост, 2 — ответ на ответ и так далее.
is_pinnedЗакрепил ли автор пост в своём профиле.
is_pinned_by_authorТолько для ответов: закрепил ли автор основного поста этот ответ в разделе ответов.
is_spoilerСкрыт ли пост как спойлер.
reply_controlКто может отвечать на этот пост, например everyone.
counts_hiddenСкрыл ли автор число отметок «Нравится» и репостов; если скрыл, like_count равен null.
thread_idID цепочки автора — серии постов, опубликованных подряд; у постов одной цепочки это значение совпадает.
thread_lengthЧисло постов в цепочке автора; 1, если пост не входит в цепочку.
thread_positionПозиция этого поста в цепочке.
is_federatedСинхронизируется ли пост с федивёрсом.
is_paid_partnershipОтмечен ли пост как платное партнёрство. Используйте для выявления рекламы.
ai_labelКак пост отмечен как созданный ИИ, например SELF_DISCLOSURE_FLOW (отметил сам автор); отсутствует, если отметки нет.
text_translationПеревод текста на английский от Threads; присутствует, только если текст не на английском и Threads предоставляет перевод.
attached_textПолный текст длинного текстового вложения поста (текстовое вложение Threads).
fediverse_like_countЧисло отметок «Нравится» со стороны федивёрса (Mastodon и другие).
fediverse_reply_countЧисло ответов со стороны федивёрса.
is_liked_by_authorТолько для ответов: поставил ли автор основного поста отметку «Нравится» этому ответу.
is_collapsedТолько для ответов: платформа свернула этот ответ. Присутствует, только когда значение true.
reply_approval_enabledАвтор включил одобрение ответов, поэтому ответы сначала проходят одобрение. Присутствует, только когда значение true.
is_ghost_postПост — исчезающий (ghost post): он автоматически пропадает через некоторое время. Присутствует, только когда значение true.
ghost_expires_atВремя, когда исчезающий пост пропадёт.
is_markupПост — Markup-пост: рисунок или пометки поверх чужого поста. Присутствует, только когда значение true.
hashtagsХештеги в тексте в порядке появления; поле отсутствует, если их нет.
mentionsИмена пользователей, упомянутых в тексте через @.
linksСсылки в тексте и ссылки, прикреплённые к посту.
image_urlsМассив ссылок на изображения в порядке показа на платформе; поле отсутствует, если изображений нет.
video_urlsURL всех видео; подписанные ссылки с ограниченным сроком действия.
tagged_usersИмена пользователей, отмеченных на изображениях и видео.
mediaСписок вложений, по одной записи на вложение; отсутствует, если вложений нет. В каждой записи: type (image или video), url (URL файла; подписанная ссылка с ограниченным сроком действия), width и height (пиксели), alt_text (альтернативный текст, созданный Threads или написанный автором); у видео есть также thumbnail_url (обложка), has_audio (есть ли звук) и duration_seconds (длительность в секундах).
link_previewКарточка ссылки: url, title (заголовок карточки), description (описание карточки), display_url (отображаемый домен), image_url (изображение карточки) и favicon_url (значок сайта).
locationМесто, прикреплённое к посту: id (ID места), name (название места) и url (страница этого места в Threads).
quoted_postИсходный пост, который цитирует этот пост: id, code, url, text, author_username и posted_at.
reposted_postИсходный пост, репостом которого является этот пост; структура та же, что у quoted_post.
gifGIF в посте: url, webp_url (URL в формате WebP), width и height (в пикселях).
musicМузыка, прикреплённая к посту: song_id, title (название трека), artist, cover_url (обложка) и start_ms (миллисекунда трека, с которой начинается воспроизведение); текст песни не включён.
podcastВ постах — карточка выпуска подкаста, прикреплённая к посту: episode_name, episode_url, podcast_name, platform (платформа подкаста, например SPOTIFY, APPLE) и image_url. В profile (данные аккаунта) — подкаст, прикреплённый к странице профиля: name, url, platform и image_url, а у некоторых ещё links (ссылки для прослушивания на разных платформах, в каждой platform и url).
scorecardСпортивное табло, прикреплённое к посту: status (upcoming — не начался, live — идёт, past — завершён), starts_at (время начала), clock (игровое время), period (период, например Q4), home_team и away_team (в каждой name, short_name, score и logo_url) и url (ссылка внизу карточки).
trendТренд, в котором показан этот пост: keyword (поисковый запрос тренда), id и summary (краткое описание от платформы; есть не у всех).
author_badgeЗначок автора в этом сообществе: type (тип значка, например MEMBER) и label (подпись, которую автор выбрал в сообществе, например название команды).
custom_likeОсобый вид отметки «Нравится», заменяющий стандартное сердечко в этом посте: type (EMOJI или STICKER), emoji и sticker_url (URL GIF-стикера).
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).
inputprofiles_batch и posts_batch: элемент запроса, которому соответствует эта запись, в точности в том виде, в каком вы его передали.

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

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

Ошибки

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