x/
search

Ищите публичные посты X по одному точному выражению, выбирайте порядок latest или top и получайте подходящий контент, авторов, вовлеченность, медиафайлы, сущности и контекст исходного запроса.

Twitter Search API

Поиск по запросу
Latest или Top
Привязка к запросу
0,7 кредита за результат
Готово
Готово

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

README

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

Twitter Search

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

Возможности Twitter Search API

  • Поиск по одному выражениюПередайте непустое ключевое слово или поисковое выражение и превратите подходящие публичные посты X в структурированные записи.
  • Порядок для двух режимов исследованияИспользуйте latest, чтобы следить за свежими совпадениями, или top, чтобы изучать заметные; по умолчанию выбран latest.
  • Практичный лимит результатов поискаЗапрашивайте от 20 до 2 000 результатов с шагом 20, чтобы задать максимальную глубину поискового сбора.
  • Совпадения с сохраненным запросомОбъединяйте текст, автора, вовлеченность, медиафайлы, сущности, метки времени и поля связей с extra.search_query и collected_at.

Параметры Twitter Search API

ПараметрыОбязательныйОписание
queryОбязательныйОбязательное непустое ключевое слово или поисковое выражение для постов X, по которому находятся подходящие публичные посты.
results_limitНеобязательныйНеобязательный лимит запрашиваемых результатов. По умолчанию 20, допускаются значения, кратные 20, от 20 до 2 000.
sort_byНеобязательныйНеобязательный порядок: latest для свежих совпадений или top для заметных. По умолчанию latest.

Как использовать Twitter Search API

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

  1. Напишите одно точное непустое выражение для постов X, которые хотите найти.
  2. Выберите latest или top и задайте results_limit от 20 до 2 000 с шагом 20.
  3. Отправьте запрос методом POST на /v1/x/search, затем опрашивайте /v1/tasks/{task_id} до завершения.
  4. Сохраните data.results.items и переходите по next_cursor, пока has_more не станет false.
curl -X POST "https://api.socq.ai/v1/x/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"artificial intelligence","results_limit":40,"sort_by":"latest"}'

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

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

  • Мониторинг вокруг конкретного запуска: Ищите по названию продукта, релиза, конференции или кампании и упорядочивайте найденные посты по времени публикации и сбора.
  • Отслеживание упоминаний бренда и продукта: Собирайте вместе авторов, текст, видимую вовлеченность, хештеги, упоминания и медиафайлы по конкретному названию или фразе.
  • Картирование развивающейся темы: Используйте результаты latest, чтобы следить за новыми постами, и результаты top, чтобы изучать заметный контент в рамках одного исследовательского выражения.
  • Регулярно обновляемый датасет по запросу: Сохраняйте extra.search_query с каждым совпадением, повторно запускайте версионированное выражение и добавляйте только ранее не встречавшиеся ID постов.

Практические советы по Twitter Search API

  • Начинайте с точного выражения, изучите совпадения и расширяйте формулировку, только если охват слишком узкий.
  • Выбирайте latest для мониторинга, где важна оперативность, и top, когда заметные совпадения важнее хронологии.
  • Задавайте results_limit кратным 20 и считайте его верхним пределом, а не гарантированным числом результатов.
  • Присваивайте запросу новую версию при каждом изменении его терминов, чтобы повторяющиеся наборы результатов оставались сопоставимыми.
  • Убирайте дубли по id поста, сохраняя extra.search_query и collected_at как контекст обнаружения.

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

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

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

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

Twitter Search API — FAQ

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

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

Выбирайте latest, чтобы в приоритете были свежие совпадения, и top, чтобы изучать заметные. По умолчанию используется latest.

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

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

Да. extra.search_query содержит переданное выражение, поэтому совпадение остается связанным с правилом, по которому оно было найдено.

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

Каждый возвращенный нормализованный результат поиска стоит 0,7 кредита SocQ.