API YouTube Ответы на комментарии
Состояние API
- Состояние за 24 ч
- Норма
- Стабильно / норма
- Доступно
Последние 24 часа
Последние 30 дней
Read the replies under one YouTube comment, on a video or on a channel post, from the link and the comment's comment_id (a comments or community_post_comments row's id). Each reply has text, author, likes, the time YouTube shows, and creator, pinned, hearted and edited flags. About 10 on the first page and up to about 50 after; pass next_page_token back as page_token for more.
Отправьте POST https://api.everyinfra.com/api/v1/social, указав в platform значение youtube, а в action — comment_replies. Цена: $0.79 за 1 000 запросов ($0.000792 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.
Промпт для ИИ
#Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra YouTube Ответы на комментарии (youtube/comment_replies).
Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: youtube и action: comment_replies, а параметры передайте в params.
- Обязательные параметры:
- url: The video link (watch?v=, youtu.be or shorts) or the channel post link (https://www.youtube.com/post/Ugkx…) the comment is on.
- comment_id: ID of the top-level comment, starting with Ug, taken from the id of a comments or community_post_comments row. A reply's ID also works and reads the comment it belongs to.
- Необязательные параметры:
- page_token: Page token. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, with the other parameters unchanged.
- Возвращает список записей. Основные поля каждой записи: id, url, text, author_name, author_username, author_id, author_url, author_avatar_url, like_count, reply_count, posted_at, is_reply; всего полей: 20, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=youtube.
- Пример тела запроса:
{
"platform": "youtube",
"action": "comment_replies",
"params": {
"url": "https://www.youtube.com/watch?v=aqz-KE-bpKQ",
"comment_id": "UgzrXz18R8jmeI5i-el4AaABAg"
}
}
- Цена: $0.79 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.
Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.Параметры запроса
#| Имя | Расположение | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|---|
Authorization | header | string | Да | - | Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода. |
platform | body | string | Да | youtube | Идентификатор платформы, фиксированное значение. |
action | body | string | Да | comment_replies | Идентификатор возможности, фиксированное значение. |
url | body.params | string | Да | - | The video link (watch?v=, youtu.be or shorts) or the channel post link (https://www.youtube.com/post/Ugkx…) the comment is on. |
comment_id | body.params | string | Да | - | ID of the top-level comment, starting with Ug, taken from the id of a comments or community_post_comments row. A reply's ID also works and reads the comment it belongs to. A value that is not recognized returns 422 and is not charged. |
page_token | body.params | string | Нет | - | Page token. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, with the other parameters unchanged. About 10 replies on the first page and up to about 50 on later pages; each page is one call and limit has no effect. Tokens last 24 hours, and the last page has no next_page_token. |
Примеры кода
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "youtube",
"action": "comment_replies",
"params": {
"url": "https://www.youtube.com/watch?v=aqz-KE-bpKQ",
"comment_id": "UgzrXz18R8jmeI5i-el4AaABAg"
}
}'Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.
Пример ответа
#{ "id": "req_…", "platform": "youtube", "action": "comment_replies", "results": [ { "id": "UgzrXz18R8jmeI5i-el4AaABAg.8vmh3CuTC3B94RkwQvd5d6", "url": "https://www.youtube.com/watch?v=aqz-KE-bpKQ&lc=UgzrXz18R8jmeI5i-el4AaABAg.8vmh3CuTC3B94RkwQvd5d6", "text": "Wait, it was made using free software!?", "author_name": "m•••4", "author_username": "m•••4", "author_id": "•••", "author_url": "https://www.youtube.com/•••", "author_avatar_url": "https://yt3.ggpht.com/•••", "like_count": 61, "reply_count": 0, "posted_at": "6 years ago", "is_reply": true, "reply_to_id": "UgzrXz18R8jmeI5i-el4AaABAg", "is_creator": false, "is_verified": false, "is_pinned": false, "is_hearted": false, "video_id": "aqz-KE-bpKQ", "platform": "youtube" }, { "id": "UgzrXz18R8jmeI5i-el4AaABAg.8vmh3CuTC3B94WIBvAW4q7", "url": "https://www.youtube.com/watch?v=aqz-KE-bpKQ&lc=UgzrXz18R8jmeI5i-el4AaABAg.8vmh3CuTC3B94WIBvAW4q7", "text": "Audy Birdo yes and no", "author_name": "g•••4", "author_username": "g•••4", "author_id": "•••", "author_url": "https://www.youtube.com/•••", "author_avatar_url": "https://yt3.ggpht.com/•••", "like_count": 16, "reply_count": 0, "posted_at": "6 years ago", "is_reply": true, "reply_to_id": "UgzrXz18R8jmeI5i-el4AaABAg", "is_creator": false, "is_verified": false, "is_pinned": false, "is_hearted": false, "video_id": "aqz-KE-bpKQ", "platform": "youtube" } ], "next_page_token": …, "pagination": { … }, "count": 10, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Поля ответа
#Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.
| Поле | Значение |
|---|---|
id | Уникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться. |
url | Ссылка на запись на платформе. |
text | Основной текст без HTML возвращается полностью и никогда не обрезается (на нескольких платформах результаты списковых запросов содержат только фрагмент; это указано в примечаниях к полям платформы). |
author_name | Отображаемое имя автора. |
author_username | Имя пользователя автора (@handle), обычно подходит для URL. |
author_id | Уникальный ID автора на платформе. |
author_url | Ссылка на профиль автора на платформе. |
author_avatar_url | Трактуется так же, как на самой платформе |
like_count | Лайки. null означает, что платформа или эта возможность не раскрывает значение; это не 0. |
reply_count | Ответы, обычно на комментарий. null означает, что значение не раскрыто. |
posted_at | Время публикации в ISO 8601, UTC (например, 2026-08-07T12:34:56+00:00). Нестандартные строки платформы передаются как есть, поэтому учитывайте это при разборе. null означает, что платформа его не раскрывает. |
is_reply | Трактуется так же, как на самой платформе |
reply_to_id | Трактуется так же, как на самой платформе |
is_creator | Whether the channel owner wrote this comment or reply. |
is_verified | Подтверждён ли аккаунт платформой. null означает, что это невозможно определить. |
is_pinned | Whether it is pinned. |
is_hearted | Whether the channel owner gave it a heart. |
is_edited | Whether it was edited after it was posted. |
video_id | ID of the video it belongs to; null for replies to a channel post comment. On channel posts, the ID of the video attached to the post, or null if none is attached. |
post_id | ID of the channel post it belongs to; null for replies to a video comment. |
platform | Идентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok). |
Ошибки и оплата
#- 401
- Ключ отсутствует или недействителен.
- 402
- Недостаточно средств на балансе. Сначала пополните баланс.
- 422
- Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
- 429
- Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
- 503
- Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
- 200 (пусто)
- Нет данных. Без списания.