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
Отправьте ссылки на посты, в которых опубликованы статьи, и прочитайте по одной строке на статью.
- Отправьте {"urls": ["https://x.com/USDOL/status/2119796255089947070"]} методом POST на /v1/x/article.
- Опрашивайте GET /v1/tasks/{task_id}, пока статус задачи не станет succeeded.
- Читайте статьи из 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 как число ответов на пост со статьей.
Связанные API
Помимо 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 — Собирайте публичные посты с упоминанием заданного аккаунта.
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API