API Reddit Comments by link

POST

Состояние API

Состояние за 24 ч
Норма
  • Стабильно / норма
  • Доступно
Норма

Последние 24 часа

Последние 30 дней

Получите сразу до 20 комментариев Reddit по comment_urls, где каждый элемент — ссылка на один комментарий, например url комментария, возвращённого comments. Используйте, когда у вас уже есть ссылки на комментарии и нужно узнать их актуальный текст и рейтинг или проверить, существуют ли они, не перелистывая ветку заново. Каждый прочитанный комментарий — одна запись с теми же полями, что у записи comments, плюс post_title и post_url его поста и input — переданный вами элемент. Работают и ответы на пост, и вложенные ответы. Одного ID комментария недостаточно. Оплата за запрос, а не за комментарий. Удалённый комментарий записи не даёт, списка missed нет, поэтому сопоставляйте записи по input. Запрос, в котором не прочитан ни один комментарий, не оплачивается. Недопустимый массив отклоняется с кодом 422 до какого-либо списания.

Отправьте POST https://api.everyinfra.com/api/v1/social, указав в platform значение reddit, а в action — comments_lookup. Цена: $0.79 за 1 000 запросов ($0.000792 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

#
Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Reddit Comments by link (reddit/comments_lookup).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: reddit и action: comments_lookup, а параметры передайте в params.
- Обязательные параметры:
  - comment_urls: Reddit comment links for comments_lookup, as an array of up to 20 entries; a comma-separated string is not accepted.
- Необязательные параметры:
  - limit: Максимальное число записей в этом вызове, целое число не меньше 1. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей.
- Возвращает список записей. Основные поля каждой записи: id, text, author_username, like_count, community, url, posted_at, post_title (Заголовок публикации, под которой остав…), post_url (Link to the post the comment was left o…), input (The entry that this row answers, return…).
- Пример тела запроса:
{
  "platform": "reddit",
  "action": "comments_lookup",
  "params": {
    "comment_urls": [
      "https://www.reddit.com/r/pics/comments/1xwxo1e/comment/19sogasefdc5g/"
    ]
  }
}
- Цена: $0.79 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

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

Параметры запроса

#
ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаredditИдентификатор платформы, фиксированное значение.
actionbodystringДаcomments_lookupИдентификатор возможности, фиксированное значение.
comment_urlsbody.paramsarrayДа-Reddit comment links for comments_lookup, as an array of up to 20 entries; a comma-separated string is not accepted. Each entry is the link to one comment itself, such as the url of a comment returned by comments: https://www.reddit.com/r/<subreddit>/comments/<post_id>/comment/<comment_id>/. The older /comments/<post_id>/<title>/<comment_id>/ form, old.reddit.com links and links with a query string such as ?context=3 also work. A comment ID alone is not enough, because Reddit finds a comment by post ID plus comment ID, and a post link is not a comment link. The url that user_comments returns points to the post, so it cannot be used here. List each comment once. A request with an unrecognized entry, a duplicate or more than 20 entries is rejected with a 422 before any charge, and so is a limit smaller than the number of entries. Billed per request, not per comment; comments not read (deleted, or not under that post) produce no row, so match the rows to your entries with input. A request that reads none is not charged.
limitbody.paramsinteger (1–)Нет-Максимальное число записей в этом вызове, целое число не меньше 1. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей.

Примеры кода

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "reddit",
  "action": "comments_lookup",
  "params": {
    "comment_urls": [
      "https://www.reddit.com/r/pics/comments/1xwxo1e/comment/19sogasefdc5g/"
    ]
  }
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

Пример ответа

#
Для этих параметров пока нет примера ответа. Здесь показаны структура ответа и поля из описания API, а … служит заполнителем; это не результат реального вызова.
json
{  "id": "req_…",  "platform": "reddit",  "action": "comments_lookup",  "results": [    {      "id": …,      "text": …,      "author_username": …,      "like_count": …,      "community": …,      "url": …,      "posted_at": …,      "platform": …,      "post_title": …,      "post_url": …,      "input": …    }  ],  "count": …,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Поля ответа

#

Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.

ПолеЗначение
idУникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться.
textОсновной текст без HTML возвращается полностью и никогда не обрезается (на нескольких платформах результаты списковых запросов содержат только фрагмент; это указано в примечаниях к полям платформы).
author_usernameИмя пользователя автора (@handle), обычно подходит для URL.
like_countЛайки. null означает, что платформа или эта возможность не раскрывает значение; это не 0.
communityТрактуется так же, как на самой платформе
urlСсылка на запись на платформе.
posted_atВремя публикации в ISO 8601, UTC (например, 2026-08-07T12:34:56+00:00). Нестандартные строки платформы передаются как есть, поэтому учитывайте это при разборе. null означает, что платформа его не раскрывает.
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).
post_titleЗаголовок публикации, под которой оставлен комментарий (user_comments, comments_lookup; записи pain_comment в painpoint).
post_urlLink to the post the comment was left on (comments_lookup).
inputThe entry that this row answers, returned exactly as you passed it: for posts_batch an entry of urls, for comments_lookup an entry of comment_urls. Use it to match rows to your entries; the returned url can be written differently, for example a full post link where you passed a redd.it short link.

Ошибки и оплата

#
401
Ключ отсутствует или недействителен.
402
Недостаточно средств на балансе. Сначала пополните баланс.
422
Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429
Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503
Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто)
Нет данных. Без списания.

Ошибки

Google Analytics: нужно согласие Приватность