API Threads Ветка

POST

Состояние API

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

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

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

Получите целую ветку Threads по url любого поста в ней. Каждая запись — один пост ветки с текстом, автором, счётчиками, временем публикации и thread_position; в первой записи также есть thread_full_text — вся ветка, объединённая в один текст. Ответы других людей в ветку не входят; для них используйте comments.

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

Промпт для ИИ

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

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: threads и action: thread, а параметры передайте в params.
- Обязательные параметры:
  - url: Полный URL поста (например, https://www.threads.com/@username/post/POST_CODE) для действий post_detail, comments, thread и post_activity.
- Необязательные параметры:
  - 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; всего полей: 76, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=threads.
- Пример тела запроса:
{
  "platform": "threads",
  "action": "thread",
  "params": {
    "url": "https://www.threads.com/@openai/post/DW7RXR7EnRC"
  }
}
- Цена: $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ДаthreadИдентификатор возможности, фиксированное значение.
urlbody.paramsstringДа-Полный URL поста (например, https://www.threads.com/@username/post/POST_CODE) для действий post_detail, comments, thread и post_activity. Для thread и post_activity подходят также ссылки threads.net и короткие ссылки вида https://www.threads.com/t/<post code>; для thread URL любого поста ветки возвращает всю ветку. Действие comments не гарантирует получение всех вложенных веток комментариев.
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": "thread",
  "params": {
    "url": "https://www.threads.com/@openai/post/DW7RXR7EnRC"
  }
}'

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

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

#
Для этих параметров пока нет примера ответа. Здесь показаны структура ответа и поля из описания API, а … служит заполнителем; это не результат реального вызова.
json
{  "id": "req_…",  "platform": "threads",  "action": "thread",  "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": …,      "thread_full_text": …    }  ],  "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Когда был сделан репост поста.
thread_full_textthread: вся ветка, объединённая в один текст; только в первой записи.

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

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

Ошибки

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