x/
user-posts

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

Twitter User Tweets Scraper API

Ленты аккаунтов
Без ответов
Лимит на пользователя
0,5 кредита за результат
Готово
Готово

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

README

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

Twitter User Tweets Scraper

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

Возможности Twitter User Tweets Scraper API

  • Ленты для нескольких пользователейПередайте одно или несколько публичных имен пользователей X, с начальным @ или без него, и соберите недавние посты каждого аккаунта в задаче.
  • Более чистая картина недавних публикацийОтветы не собираются, поэтому возвращенная лента сосредоточена на недавней публичной активности аккаунта.
  • Отдельный лимит для каждого аккаунтаresults_limit применяется независимо к каждому имени пользователя и принимает значения, кратные 20, от 20 до 2 000; по умолчанию используется 20.
  • Контент, готовый к анализу аккаунтовКаждый пост может содержать текст, язык, данные автора, видимую вовлеченность, медиа, сущности, временные метки и связи в беседе.
  • Прослеживаемый аккаунт и источник сбораextra.input_username указывает переданный аккаунт, а collected_at фиксирует, когда был собран снимок ленты.

Параметры Twitter User Tweets Scraper API

ПараметрыОбязательныйОписание
usernamesОбязательныйОбязательный список публичных имен пользователей X. Каждое значение может начинаться с @ или без него.
results_limitНеобязательныйНеобязательный максимум, который запрашивается отдельно для каждого имени пользователя. По умолчанию 20, допустимы значения, кратные 20, от 20 до 2 000.

Как использовать Twitter User Tweets Scraper API

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

  1. Добавьте одно или несколько публичных имен пользователей X; начальный @ необязателен.
  2. Задайте results_limit для каждого аккаунта значением, кратным 20, от 20 до 2 000.
  3. Отправьте запрос методом POST на /v1/x/user-posts и опрашивайте /v1/tasks/{task_id}, пока задача не завершится.
  4. Добавляйте data.results.items к своим данным и используйте next_cursor, когда доступна следующая страница результатов.
curl -X POST "https://api.socq.ai/v1/x/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["nasa","OpenAI"],"results_limit":40}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Сценарии использования Twitter User Tweets Scraper API

  • Список аккаунтов для наблюдения: Группируйте недавние посты по extra.input_username, чтобы поддерживать актуальную картину по выбранным брендам, авторам, конкурентам или публичным организациям.
  • Сравнение частоты публикаций: По created_at измеряйте, как часто публикует каждый аккаунт, и выявляйте изменения во времени публикаций, использовании медиа или повторяющихся темах.
  • Корпус недавних постов: Объединяйте текст, автора, медиа, сущности и поля вовлеченности в датасет с привязкой к аккаунтам для классификации или проверки контента.

Практические советы по Twitter User Tweets Scraper API

  • Удаляйте начальные символы @ и убирайте дубли имен пользователей без учета регистра перед отправкой.
  • При сравнении активности аккаунтов используйте одинаковый results_limit с допустимым значением, кратным 20.
  • Считайте results_limit лимитом на аккаунт: аккаунт может вернуть меньше подходящих недавних постов.
  • Удаляйте дубли из плановых сборов по id поста, прежде чем добавлять записи в существующий датасет лент.
  • Используйте created_at для хронологии публикаций, а collected_at — для определения возраста полученного снимка.

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

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

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

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

Twitter User Tweets Scraper API — FAQ

Twitter User Tweets Scraper API собирает недавние публичные посты X для одного или нескольких имен пользователей. Он возвращает привязанный к аккаунту контент постов, авторов, вовлеченность, медиа, сущности, связи и временные метки сбора.

Добавляйте публичные имена пользователей в массив usernames с начальным @ или без него. В одной задаче можно обработать несколько имен пользователей.

Нет. Он применяется отдельно к каждому имени пользователя, по умолчанию равен 20 и должен быть кратен 20 в диапазоне от 20 до 2 000.

Ответы исключаются из собранных лент аккаунтов, поэтому записи содержат другие недавние публичные посты каждого переданного пользователя.

Вы можете работать с текстом, языком, данными автора, видимой вовлеченностью, медиа, хештегами, упоминаниями, временными метками, связями в беседе и переданным именем пользователя.

Запрошенное значение — это верхняя граница сбора. Фактическое число зависит от подходящих недавних публичных постов, доступных у этого аккаунта на момент выполнения задачи.

Каждая нормализованная запись поста аккаунта стоит 0,5 кредита SocQ.