X Post Quotes
X Post Quotes API собирает публичные посты-цитаты вокруг указанных постов X и возвращает данные об авторе, комментарий в цитате, медиафайлы, время публикации и видимую вовлеченность для отслеживания мнений, анализа тональности и оценки эффективности распространения.
Возможности X Post Quotes API
- Расширение до постов-цитатНачинайте с одного или нескольких URL публичных статусов и собирайте публичные посты, которые цитируют эти источники, а не ответы или профили тех, кто просто сделал репост.
- Независимые лимиты на каждый источникЗапрашивайте от 20 до 2 000 записей на исходный пост с шагом 20; каждый переданный статус продвигается по собственному курсору провайдера.
- Нормализованные записи комментариевПолучайте текст цитаты, язык, данные об авторе, время публикации и сбора, медиафайлы, сущности и видимую вовлеченность в единой структуре.
- Привязка к источнику и удаление дублейСохраняет переданный URL и ID родительского поста в extra, а повторяющиеся ID постов-цитат хранятся в задаче один раз.
Параметры X Post Quotes API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательные URL публичных статусов на x.com или twitter.com. Поддерживаемые варианты домена должны содержать числовой ID поста после /status/. |
results_limit | Необязательный | Необязательный максимум на каждый переданный исходный пост. По умолчанию 100, значение должно быть кратно 20 в диапазоне от 20 до 2 000. |
Как использовать X Post Quotes API
Передайте известные URL публичных статусов, затем опрашивайте асинхронную задачу и постранично читайте ее нормализованные записи постов-цитат.
- Подготовьте публичные URL x.com или twitter.com, путь которых содержит /status/{numeric_id}.
- Отправьте массив urls методом POST на /v1/x/post-quotes с необязательным results_limit и сохраните task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте data.results.items и используйте next_cursor, пока has_more равно true; этот курсор результатов не связан с пагинацией провайдера.
X_POST_URL="https://x.com/OpenAI/status/1950240351547248941"
curl -X POST "https://api.socq.ai/v1/x/post-quotes" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"urls\":[\"${X_POST_URL}\"],\"results_limit\":100}"
# Poll GET /v1/tasks/{task_id}?limit=50
# Follow data.results.next_cursor while data.results.has_more is trueСценарии использования X Post Quotes API
- Изучение добавленных комментариев: Составляйте выборку того, что публичные авторы добавили, цитируя запуск продукта, анонс, ссылку на исследование или пост рекламной кампании.
- Поиск публичных усилителей: Сравнивайте авторов цитат и видимую вовлеченность, чтобы находить аккаунты, чья подача вызвала заметный публичный отклик.
- Архив снимков постов-цитат: Сохраняйте комментарии, ссылки на медиафайлы, метки времени и счетчики на момент сбора для заданного списка исходных постов.
Практические советы по X Post Quotes API
- Перед отправкой проверяйте имя хоста и числовой ID после /status/; ссылки на профили, поиск и другие ссылки без статуса отклоняются.
- Планируйте results_limit на исходный пост, а не на задачу: два URL с лимитом 100 могут дать оценку до 200 записей.
- Учитывайте, что один и тот же ID поста-цитаты появится в сохраненных результатах задачи только один раз, даже если к нему ведут несколько переданных источников.
- Считайте запрошенный лимит верхним пределом, а не гарантией полноты: удаленные, защищенные, ограниченные или исключенные из поиска посты могут отсутствовать.
- Сохраняйте поля медиа, сущностей, беседы и вовлеченности с расчетом на то, что они могут быть null, и используйте collected_at при сравнении меняющихся счетчиков.
Связанные API
Помимо X Post Quotes API, используйте эти API, когда нужен другой тип публичных данных X.
- Twitter Tweet Scraper API — Получайте по URL статусов x.com или twitter.com текст публичных постов, авторов, вовлеченность, медиа, хештеги, упоминания и связи в обсуждении.
- Twitter User Tweets Scraper API — Собирайте свежие публичные посты, авторов, медиа, хештеги, упоминания и вовлеченность по имени пользователя без ответов.
- X Post Replies API — Собирайте публичные ответы по URL постов X с выбором порядка: текст ответа, авторы, видимая вовлеченность, медиа и контекст родительского поста.
- X Post Retweeters API — Собирайте уникальный в рамках задачи набор нормализованных публичных профилей аккаунтов, сделавших репост известных URL статусов X или Twitter.
- Twitter Mentions API — Собирайте публичные посты с упоминанием заданного аккаунта.
- X Community Posts API — Получайте публичные посты сообщества: текст, авторы и счетчики взаимодействий.
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Trends API
- Twitter User Search API
- X Community 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 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