x/
list-posts

Собирайте последние посты и репосты из лент публичных списков X по URL списка: текст, автор, лайки, просмотры, медиафайлы и признак репоста у каждого элемента, сначала новые.

X List Tweets API

URL списка на входе
Репосты помечены
Сначала новые посты
0,7 кредита за результат
Готово
Готово

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

README

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

X List Tweets

Лента списка X — это поток твитов и ретвитов от аккаунтов, которые кто-то объединил в список, и у каждого поста есть текст, автор, лайки, комментарии, репосты, просмотры, прикрепленные изображения или видео, хештеги и упоминания. Если читать эти посты вместе, можно следить за тем, что обсуждает подобранная группа журналистов, основателей или конкурентов, видеть, чьи посты вызывают больше всего вовлеченности, и выяснять, чей контент группа распространяет чаще всего.

Возможности X List Tweets API

  • Лента любого публичного списка по URLПередайте одну или несколько ссылок вида x.com/i/lists/<id>, и лента каждого списка вернется в порядке от новых к старым, до 2 000 твитов на список.
  • Репосты помечены, исходный автор указан отдельноis_repost отмечает каждый репост; в author остается участник списка, который сделал репост, а reposted_author и reposted_post_id указывают на исходного автора и исходный пост.
  • Вовлеченность и медиафайлы у каждого постаmetrics содержит лайки, комментарии, репосты и просмотры, а media перечисляет каждое изображение или видео с URL, миниатюрой, шириной и высотой.
  • Хештеги и упоминания в отдельных массивахhashtags и mentions приходят отдельными списками, поэтому темы, которые обсуждает список, и аккаунты, к которым обращаются его участники, можно посчитать прямо по полям.

Параметры X List Tweets API

ПараметрыОбязательныйОписание
urlsОбязательныйURL публичных списков X вида https://x.com/i/lists/<numeric id>. Лента каждого списка собирается отдельно.
results_limitНеобязательныйЧисло постов для сбора из каждого списка: значение, кратное 20, от 20 до 2 000. По умолчанию 100.

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

Отправьте URL списков, дождитесь завершения задачи и читайте ленту постранично.

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

# Reposts arrive with is_repost set to true and the original creator in reposted_author.

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

  • Отслеживание темы через подобранный список: Каждое утро забирайте ленту списка журналистов или аналитиков и читайте text, author и published_at, чтобы увидеть, о чем писала группа с прошлого запуска.
  • Рейтинг постов, на которые реагирует ниша: Оставьте оригинальные посты (is_repost равно false) и отсортируйте их по views_count и likes_count, чтобы найти, чьи публикации привлекли больше всего внимания.
  • Кого продвигает группа: Посчитайте reposted_author.username по всем репостам, чтобы увидеть, какие внешние аккаунты и каких участников список распространяет чаще всего.
  • Анонсы конкурентов в одной ленте: Добавьте аккаунты конкурирующих брендов в один список и собирайте его ленту, чтобы получать их посты о запусках, ссылки и прикрепленные медиафайлы вместе.
  • Тематический датасет для сообщества: Группируйте хештеги и упоминания из постов списка по published_at, чтобы показать, какие темы и аккаунты сообщество обсуждает с течением времени.

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

  • Фильтруйте по is_repost, прежде чем ранжировать участников по вовлеченности: репост несет лайки и просмотры исходного поста.
  • Когда несколько участников делают репост одного и того же поста, удаляйте дубли по reposted_post_id, чтобы каждый оригинал учитывался один раз.
  • Увеличьте results_limit, если из активного списка нужно много оригинальных постов: репосты могут занимать большую часть его ленты.
  • Текст репоста начинается с «RT @user:», а его mentions включают этого пользователя, поэтому перед подсчетом ключевых слов и упоминаний отбрасывайте репосты или удаляйте этот префикс.
  • При запусках по расписанию оставляйте только элементы с новыми для вашего хранилища id: лента от новых к старым пересекается с предыдущим запуском.
  • Чтобы увидеть все аккаунты, которые наполняют ленту, включая редко публикующих участников, соберите тот же список через Twitter List Members API.

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

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

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

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

X List Tweets API — FAQ

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

Откройте список на x.com, скопируйте его URL (он выглядит как https://x.com/i/lists/1940592907737845989) и передайте его в urls. Посты возвращаются от новых к старым — в том же порядке, что и в ленте самого списка.

Это число после /i/lists/ в URL списка. При отправке передавайте в urls полный URL.

Да. Репосты участников списка возвращаются с пометкой is_repost, ID исходного поста указан в reposted_post_id, а его автор — в reposted_author. Если нужны только оригинальные посты, фильтруйте по is_repost.

URL, указывающий на несуществующий список, возвращает пустой результат; задача все равно завершается успешно, и ничего не списывается. Проверьте, что число после /i/lists/ указано полностью.

Да. Добавьте URL каждого списка в urls. results_limit считается на каждый список, поэтому три списка с лимитом 100 могут вернуть до 300 постов.