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
Сформулируйте точный исследовательский вопрос в виде поискового выражения, выберите подходящий порядок и сохраняйте запрос вместе с найденными постами.
- Напишите одно точное непустое выражение для постов X, которые хотите найти.
- Выберите latest или top и задайте results_limit от 20 до 2 000 с шагом 20.
- Отправьте запрос методом POST на /v1/x/search, затем опрашивайте /v1/tasks/{task_id} до завершения.
- Сохраните 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 как контекст обнаружения.
Связанные API
Помимо 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 — Находите сообщества по ключевому слову: число участников и ссылки для эндпоинтов участников и постов.
- Twitter User Tweets Scraper API
- X Followers List API
- X Following List API
- X Post Quotes API
- X Post Retweeters API
- Twitter Mentions 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 Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API