x/
post-quotes

Собирайте публичные посты-цитаты для известных URL статусов X: комментарии, данные об авторе, медиафайлы, метки времени, контекст беседы и видимые метрики вовлеченности.

X Post Quotes API

Комментарии в цитатах
Контекст исходного поста
Лимиты на пост
0,5 кредита за результат
Готово
Готово

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

README

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

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 публичных статусов, затем опрашивайте асинхронную задачу и постранично читайте ее нормализованные записи постов-цитат.

  1. Подготовьте публичные URL x.com или twitter.com, путь которых содержит /status/{numeric_id}.
  2. Отправьте массив urls методом POST на /v1/x/post-quotes с необязательным results_limit и сохраните task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте 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 при сравнении меняющихся счетчиков.

Помимо 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 — Получайте публичные посты сообщества: текст, авторы и счетчики взаимодействий.

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

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

X Post Quotes API — FAQ

X Post Quotes API — это программный интерфейс для сбора публичных постов-цитат, ссылающихся на известные URL статусов X. Он возвращает нормализованные комментарии, авторов, вовлеченность, медиафайлы, метки времени и контекст исходного поста.

Передайте непустой массив urls со ссылками на публичные посты x.com или twitter.com, путь которых содержит /status/ и числовой ID поста.

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

По умолчанию он равен 100 на каждый переданный исходный URL и принимает значения, кратные 20, от 20 до 2 000. Доступных публичных результатов может быть меньше запрошенного предела.

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

Задача оценивается в 0,5 кредита за каждый запрошенный результат по всем переданным URL, затем итоговое списание составляет 0,5 кредита за каждый уникальный сохраненный результат, а неиспользованные предоплаченные кредиты возвращаются.