x/
article

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

X Articles API

Поиск по URL поста
Полный текст статьи
Заголовок, превью и обложка
0,7 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

X Articles

Статьи X (X Articles), которые до сих пор часто называют статьями Twitter, — это длинные посты с заголовком, обложкой и форматированным текстом, которые публикуют подписчики Premium; в ленте они показываются как короткое превью и собирают лайки, ответы, цитаты и просмотры, как любой другой пост. Если хранить заголовок, превью и весь текст рядом с этими счетчиками, можно архивировать длинные материалы, кратко излагать или классифицировать их и сравнивать, как статьи работают по сравнению с обычными постами автора.

Возможности X Articles API

  • Посты со статьями по URLОтправьте одну или несколько ссылок на твиты, в которых опубликованы статьи, в формате x.com/{username}/status/{post_id}, и каждая статья вернется одной строкой, id и url которой принадлежат этому посту.
  • Весь текст как обычный текстtext содержит всю статью с пустой строкой между абзацами — ее можно сразу разбить на абзацы или передать в программу для чтения, поисковый индекс или языковую модель.
  • Заголовок, строка превью и обложкаtitle, summary (превью, которое X показывает в ленте) и cover_url описывают статью такой, какой читатели впервые видят ее в своей ленте.
  • Автор и вовлеченностьauthor содержит имя пользователя, отображаемое имя, аватар и признак верификации, metrics — лайки, ответы, цитаты и просмотры, а published_at фиксирует время публикации статьи.

Параметры X Articles API

ПараметрыОбязательныйОписание
urlsОбязательныйОдин или несколько URL постов X в формате /{username}/status/{post_id}, каждый из которых указывает на пост, где опубликована статья.

Как использовать X Articles API

Отправьте ссылки на посты, в которых опубликованы статьи, и прочитайте по одной строке на статью.

  1. Отправьте {"urls": ["https://x.com/USDOL/status/2119796255089947070"]} методом POST на /v1/x/article.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока статус задачи не станет succeeded.
  3. Читайте статьи из results.items; пока has_more равно true, передавайте results.next_cursor, чтобы получить следующую страницу.
curl -X POST "https://api.socq.ai/v1/x/article" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/USDOL/status/2119796255089947070"]}'

# text holds the whole Article, with a blank line between paragraphs.

Сценарии использования X Articles API

  • Архив длинных материалов автора: Сохраняйте title, text, cover_url, published_at и url каждой статьи, чтобы хранить копию с поиском всего, что аккаунт опубликовал в длинном формате.
  • Краткое изложение статей с помощью языковой модели: Разбейте text по пустым строкам и передайте абзацы в инструмент для суммаризации или языковую модель, добавив title как контекст, чтобы превращать длинные статьи в короткие дайджесты.
  • Сравнение статей с обычными постами автора: Сопоставьте views_count, likes_count и quotes_count статей автора с теми же показателями его обычных постов, чтобы увидеть, какой формат аудитория читает и передает дальше.
  • Отслеживание статьи после публикации: Запрашивайте тот же URL через определенные интервалы и записывайте, как растут просмотры, ответы и цитаты в дни после published_at.
  • Дословное цитирование объявлений: Когда ведомство, компания или основатель публикует объявление в виде статьи, берите точные фрагменты из text и цитируйте их со ссылкой на url и published_at.

Практические советы по X Articles API

  • Если вы не уверены, какие посты являются статьями, отправьте их одним пакетом: строки возвращаются и тарифицируются только для статей, а пакет, целиком состоящий из обычных постов, завершается ошибкой с полным возвратом кредитов.
  • Показывайте summary в превью и карточках, а text — в режиме чтения; summary повторяет первые строки текста, поэтому при их объединении этот фрагмент выводится дважды.
  • Храните каждую статью под id — ID поста, в котором она опубликована, — чтобы повторный сбор той же статьи обновлял сохраненные метрики.
  • Когда выводите вовлеченность статей на аналитические панели, показывайте metrics.comments_count как число ответов на пост со статьей.

Помимо X Articles API, используйте эти API, когда нужен другой тип публичных данных X.

  • Twitter Tweet Scraper API — Получайте по URL статусов x.com или twitter.com текст публичных постов, авторов, вовлеченность, медиа, хештеги, упоминания и связи в обсуждении.
  • Twitter Profile Scraper API — Получайте по имени пользователя публичные данные аккаунта, описание, аватар, обложку, статус аккаунта и видимую статистику аудитории.
  • Twitter User Tweets Scraper API — Собирайте свежие публичные посты, авторов, медиа, хештеги, упоминания и вовлеченность по имени пользователя без ответов.
  • X Post Quotes API — Собирайте публичные цитаты известных URL статусов: комментарий, авторы, вовлеченность, медиа, метки времени и контекст исходного поста.
  • X Post Replies API — Собирайте публичные ответы по URL постов X с выбором порядка: текст ответа, авторы, видимая вовлеченность, медиа и контекст родительского поста.
  • Twitter Mentions API — Собирайте публичные посты с упоминанием заданного аккаунта.

Другие платформы

Объединяйте данные X с публичными данными других поддерживаемых соцсетей.

X Articles API — FAQ

X Articles API — это программный интерфейс для чтения статей X, то есть длинных постов с заголовком и обложкой, по URL постов, в которых они опубликованы. Он возвращает заголовок, превью в ленте, полный текст, URL обложки, автора и число лайков, ответов, цитат и просмотров.

Статьи X (X Articles) — это длинные посты с заголовком, обложкой и форматированным текстом, которые подписчики Premium могут публиковать на платформе X. В ленте они выглядят как пост с коротким превью, а чтобы прочитать материал целиком, его нужно открыть.

Используйте ссылку на пост, в котором опубликована статья, в формате x.com/{username}/status/{post_id}. В urls можно передать сразу несколько ссылок, и каждая статья вернется отдельной строкой.

Для такого поста строка не возвращается и ничего не списывается, а статьи из того же запроса всё равно возвращаются. Если ни один URL не ведет на статью, задача завершается ошибкой и кредиты возвращаются полностью.

Обложка возвращается в cover_url. Изображения, размещенные в тексте статьи, не включаются; text содержит только письменный контент.

Да. text содержит весь материал как обычный текст с пустой строкой между абзацами — его можно сохранить в файл .txt или использовать как абзацы Markdown, добавив title сверху в качестве заголовка.