API Threads Посты с медиа

POST

Состояние API

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

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

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

Получите список постов аккаунта Threads с изображениями или видео по username (имя пользователя или ссылка на профиль). В каждой записи есть текст, автор, число лайков, комментариев, репостов, цитат и отправок, время публикации и media — по одному элементу на файл. Ссылки на файлы подписаны и истекают. Каждый вызов возвращает одну страницу до 10 постов, и limit ни на что не влияет. Для следующей страницы передайте next_page_token из ответа обратно как page_token; у последней страницы его нет.

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

Промпт для ИИ

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

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: threads и action: user_media, а параметры передайте в params.
- Обязательные параметры:
  - username: Имя пользователя Threads (с @ или без) для profile, user_posts, followers, user_replies, user_media, user_reposts, followers_list, following_list и engagement.
- Необязательные параметры:
  - page_token: Токен страницы. Для первой страницы не передавайте его, а затем передавайте next_page_token из предыдущего ответа в точности как получили, не меняя остальные параметры.
- Возвращает список записей. Основные поля каждой записи: 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; всего полей: 75, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=threads.
- Пример тела запроса:
{
  "platform": "threads",
  "action": "user_media",
  "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Даuser_mediaИдентификатор возможности, фиксированное значение.
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.
page_tokenbody.paramsstringНет-Токен страницы. Для первой страницы не передавайте его, а затем передавайте next_page_token из предыдущего ответа в точности как получили, не меняя остальные параметры. На странице до 10 постов, каждая страница — один вызов; limit ни на что не влияет. Токены действуют 24 часа; у последней страницы нет next_page_token.

Примеры кода

#
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": "user_media",
  "params": {
    "username": "zuck"
  }
}'

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

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

#
Для этих параметров пока нет примера ответа. Здесь показаны структура ответа и поля из описания API, а … служит заполнителем; это не результат реального вызова.
json
{  "id": "req_…",  "platform": "threads",  "action": "user_media",  "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": …,      "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": …,      "in_reply_to": …,      "reposted_by": …,      "reposted_at": …    }  ],  "next_page_token": …,  "pagination": { … },  "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.
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).
in_reply_toПост, на который дан этот ответ. Поля: id и code, url и text, author_username, author_name, like_count, comment_count и posted_at.
reposted_byАккаунт (username), который репостнул этот пост; сама запись — это исходный пост, который репостнули.
reposted_atКогда был сделан репост поста.

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

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

Ошибки

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