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 списков, дождитесь завершения задачи и читайте ленту постранично.
- Отправьте {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} методом POST на /v1/x/list-posts.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте посты из 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.
Связанные 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 — Выгружайте аккаунты из списка в виде полных профилей с описанием, местоположением и счетчиками.
- Twitter Profile Scraper 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
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API