API Threads Пакетное получение постов
Состояние 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 время и повторите попытку.
Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.Параметры запроса
#| Имя | Расположение | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|---|
Authorization | header | string | Да | - | Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода. |
platform | body | string | Да | threads | Идентификатор платформы, фиксированное значение. |
action | body | string | Да | posts_batch | Идентификатор возможности, фиксированное значение. |
urls | body.params | array | Да | - | Ссылки на посты Threads для posts_batch в виде массива до 20 элементов; строка с элементами через запятую не принимается. Указывайте каждую ссылку так же, как для post_detail. Указывайте каждый пост один раз. Запрос с нераспознанным элементом, дубликатом или более чем 20 элементами отклоняется с кодом 422 до какого-либо списания. Оплата за каждый пост; ненайденные посты не оплачиваются и перечисляются в missed. |
limit | body.params | integer (1–) | Нет | - | Максимальное число записей в этом вызове, целое число не меньше 1. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. |
Примеры кода
#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; скопированный код никогда не содержит ваш ключ.
Пример ответа
#{ "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_url | URL аватара автора; подписанная ссылка с ограниченным сроком действия. |
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_url | URL первого вложения; подписанная ссылка с ограниченным сроком действия. |
video_duration_seconds | Длительность первого видео в секундах; длительность каждого видео указана в duration_seconds соответствующей записи media. |
topic | Внутреннее название темы, к которой привязан пост, например bakingthreads; отображаемое название — в topic_name. |
topic_id | ID темы, к которой привязан пост. |
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_id | ID цепочки автора — серии постов, опубликованных подряд; у постов одной цепочки это значение совпадает. |
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_urls | URL всех видео; подписанные ссылки с ограниченным сроком действия. |
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. |
gif | GIF в посте: 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). |
input | profiles_batch и posts_batch: элемент запроса, которому соответствует эта запись, в точности в том виде, в каком вы его передали. |
Ошибки и оплата
#- 401
- Ключ отсутствует или недействителен.
- 402
- Недостаточно средств на балансе. Сначала пополните баланс.
- 422
- Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
- 429
- Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
- 503
- Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
- 200 (пусто)
- Нет данных. Без списания.