Каталог
Поля и параметры
Некоторым услугам нужно больше, чем ссылка и количество. На этой странице перечислены все дополнительные поля, их ограничения, способ определения количества и отправка реакций Telegram.
Как работают поля
Каждая услуга перечисляет принимаемые поля в fields (см. «Список услуг»). Передавайте каждое по его key в том же запросе add. Поле относится к одному из типов ниже. Список строк — это по одному элементу в строке, разделённому переводом строки.
Типы полей
integer- Целое число в указанных пределах.
text- Короткий текст до указанной длины.
lines- Список по одному элементу в строке. Пустые строки отбрасываются.
choice- Одно значение из фиксированного списка.
url- Ссылка, начинающаяся с
http://илиhttps://. reactions- Реакции Telegram: смесью или с точным количеством. См. «Реакции Telegram».
- 400
OPTION_NOT_SUPPORTED
This service does not accept {param}Услуга не принимает отправленное вами поле. Сначала исправьте запрос.
- 400
MISSING_PARAMETER
Missing required parameter: {param}Отсутствует обязательный параметр. details.param называет его. Сначала исправьте запрос.
- 400
INVALID_OPTION
Invalid {param}: {rule}У дополнительного поля недопустимое значение. details.param и details.rule указывают, у какого и почему. Сначала исправьте запрос.
Поля и количество по типам услуг
type_key подсказывает, какие поля отправлять. Типы, работающие по присланному вами списку (свои комментарии, ответы на комментарии и свои списки имён пользователей), сами задают количество: это число строк, а другое значение quantity отклоняется с QUANTITY_MISMATCH. Если опустить quantity, оно будет посчитано за вас.
| type_key | Поля | Количество |
|---|---|---|
| default | – | Любое количество от минимума до максимума услуги, кратное её шагу (step). |
| package | – | Задаётся услугой. Количество не указывайте. |
| seo | keywords | Любое количество от минимума до максимума услуги, кратное её шагу (step). |
| custom_comments | comments | Число строк в списке. Количество можно не указывать. |
| custom_comments_package | comments | Задаётся услугой. Количество не указывайте. |
| mentions | usernames | Любое количество от минимума до максимума услуги, кратное её шагу (step). |
| mentions_with_hashtags | usernames, hashtags | Любое количество от минимума до максимума услуги, кратное её шагу (step). |
| mentions_custom_list | usernames | Число строк в списке. Количество можно не указывать. |
| mentions_hashtag | hashtag | Любое количество от минимума до максимума услуги, кратное её шагу (step). |
| mentions_user_followers | username | Любое количество от минимума до максимума услуги, кратное её шагу (step). |
| mentions_media_likers | media | Любое количество от минимума до максимума услуги, кратное её шагу (step). |
| comment_likes | username | Любое количество от минимума до максимума услуги, кратное её шагу (step). |
| poll | answer_number | Любое количество от минимума до максимума услуги, кратное её шагу (step). |
| comment_replies | comments, username | Число строк в списке. Количество можно не указывать. |
| invites_from_groups | groups | Любое количество от минимума до максимума услуги, кратное её шагу (step). |
| web_traffic | country, device, type_of_traffic, google_keyword, referring_url | Любое количество от минимума до максимума услуги, кратное её шагу (step). |
key=YOUR_API_KEY&action=add&service=31&link=https://instagram.com/example/p/abc123&comments=Great shot!%0ALove the colors%0ASo clean{
"order": 1234573,
"status": "Pending",
"status_key": "pending",
"charge": "0.27",
"currency": "USD",
"instant_cancel_until": "2026-10-03T10:00:15Z",
"cancel_available": true,
"cancel_window_seconds": 15,
"cancel_before": "2026-10-03T10:00:15Z"
}Все поля
Имена — это те, что вы передаёте в запросе. Поля, которые используют несколько типов, имеют одно имя: username — автор комментария для лайков и ответов на комментарии и целевой аккаунт для упоминаний подписчиков.
Дополнительные поля
commentslinesОбязательный- Ваши комментарии, по одному в строке.От 1 до 10000 строк, до 500 символов в каждой · Используется в: custom_comments, custom_comments_package, comment_replies
usernameslinesОбязательный- Имена пользователей для упоминания, по одному в строке. Начальный @ удаляется.От 1 до 10000 строк, до 64 символов в каждой · Используется в: mentions, mentions_with_hashtags, mentions_custom_list
hashtagtextОбязательный- Хештег, авторов публикаций с которым нужно охватить.До 100 символов · Используется в: mentions_hashtag
usernametextОбязательный- Аккаунт, чьих подписчиков нужно охватить. Имя пользователя или ссылка на профиль.До 255 символов · Используется в: mentions_user_followers
mediaurlОбязательный- Публикация, чьих лайкнувших нужно охватить.До 2048 символов · Используется в: mentions_media_likers
usernametextОбязательный- Имя пользователя автора комментария.До 64 символов · Используется в: comment_likes, comment_replies
answer_numberintegerОбязательный- Номер варианта ответа в опросе, за который голосовать.Целое число от 1 до 100 · Используется в: poll
keywordslinesОбязательный- Поисковые ключевые слова, по одному в строке.От 1 до 1000 строк, до 255 символов в каждой · Используется в: seo
groupslinesОбязательный- Ссылки на группы, по одной в строке.От 1 до 1000 строк, до 2048 символов в каждой · Используется в: invites_from_groups
countrytextНеобязательно- Страна в виде двухбуквенного кода ISO 3166-1, например
US.До 2 символов · Используется в: web_traffic devicechoiceНеобязательно- Тип устройства для визитов.desktop · android · ios · mobile_mixed · all_mixed · Используется в: web_traffic
type_of_trafficchoiceНеобязательно- Откуда приходят визиты. По умолчанию
direct.google_search · referrer · direct · Используется в: web_traffic google_keywordtextЗависит от типа услуги- Поисковый запрос в Google. Обязателен, когда
type_of_trafficравенgoogle_search.До 255 символов · Используется в: web_traffic referring_urlurlЗависит от типа услуги- Страница, с которой приходят визиты. Обязательна, когда
type_of_trafficравенreferrer.До 2048 символов · Используется в: web_traffic reactionsreactionsНеобязательно- Реакции Telegram: смесью или с точным количеством. См. «Реакции Telegram».Используется в: услугах, у которых оно указано в fields
last_postsintegerОбязательный- Сколько последних публикаций канала охватить. Для этих услуг ссылка — это имя пользователя канала.Целое число от 10 до 500 · Используется в: услугах, у которых оно указано в fields
Реакции Telegram
Telegram принимает 73 эмодзи-реакций и не более 11 разных на одной публикации. Услуги с полем reactions принимают их одним текстовым значением, а всё вне разрешённого набора отклоняется до списания средств. Передавайте эмодзи в запросе обычным текстом.
Два способа отправить реакции
👍,❤️,🔥mix- Список эмодзи. Мы распределяем
quantityмежду ними, поэтомуquantityобязательно. 👍:60,❤️:40exact- Каждое эмодзи со своим числом — целым не менее 1. Количество равно сумме, поэтому
quantityнеобязательно; если вы его передаёте, оно должно быть равно сумме.
key=YOUR_API_KEY&action=add&service=12&link=https://t.me/example/42&quantity=500&reactions=👍,❤️,🔥{
"order": 1234571,
"status": "Pending",
"status_key": "pending",
"charge": "0.45",
"currency": "USD",
"instant_cancel_until": "2026-10-03T10:00:15Z",
"cancel_available": true,
"cancel_window_seconds": 15,
"cancel_before": "2026-10-03T10:00:15Z"
}key=YOUR_API_KEY&action=add&service=12&link=https://t.me/example/42&reactions=👍:60,❤️:40{
"order": 1234572,
"status": "Pending",
"status_key": "pending",
"charge": "0.09",
"currency": "USD",
"instant_cancel_until": "2026-10-03T10:00:15Z",
"cancel_available": true,
"cancel_window_seconds": 15,
"cancel_before": "2026-10-03T10:00:15Z"
}73 разрешённых реакций
Услуга может разрешать меньше. Её запись в fields точно перечисляет принимаемое в allowed вместе с max_distinct и modes. Вариационный селектор при сравнении игнорируется, поэтому сердце с ним и без него — одно и то же эмодзи.
- 👍
- 👎
- ❤️
- 🔥
- 🥰
- 👏
- 😁
- 🤔
- 🤯
- 😱
- 🤬
- 😢
- 🎉
- 🤩
- 🤮
- 💩
- 🙏
- 👌
- 🕊️
- 🤡
- 🥱
- 🥴
- 😍
- 🐳
- ❤️🔥
- 🌚
- 🌭
- 💯
- 🤣
- ⚡
- 🍌
- 🏆
- 💔
- 🤨
- 😐
- 🍓
- 🍾
- 💋
- 🖕
- 😈
- 😴
- 😭
- 🤓
- 👻
- 👨💻
- 👀
- 🎃
- 🙈
- 😇
- 😨
- 🤝
- ✍️
- 🤗
- 🫡
- 🎅
- 🎄
- ☃️
- 💅
- 🤪
- 🗿
- 🆒
- 💘
- 🙉
- 🦄
- 😘
- 💊
- 🙊
- 😎
- 👾
- 🤷♂️
- 🤷
- 🤷♀️
- 😡
Ошибки реакций
- 400
INVALID_OPTION
Invalid {param}: {rule}У дополнительного поля недопустимое значение. details.param и details.rule указывают, у какого и почему. Сначала исправьте запрос.
- 400
QUANTITY_MISMATCH
quantity must equal the number of items in {param} ({count})Количество не совпадает с числом элементов в списке или в поле реакций. Сначала исправьте запрос.
- 400
MISSING_PARAMETER
Missing required parameter: {param}Отсутствует обязательный параметр. details.param называет его. Сначала исправьте запрос.
key=YOUR_API_KEY&action=add&service=12&link=https://t.me/example/42&quantity=100&reactions=🧿,👍{
"error": "Invalid reactions: unsupported_emoji",
"error_code": "INVALID_OPTION",
"retryable": false,
"details": {
"emoji": "🧿",
"param": "reactions",
"rule": "unsupported_emoji"
}
}Слова правил
INVALID_PARAMETER и INVALID_OPTION содержат короткое details.rule, указывающее, что не так. Сначала ветвите по error_code, а неизвестное слово правила считайте общим недопустимым значением, потому что могут появляться новые слова.
Слова правил в details.rule
must_be_integer- Требуется целое число.
too_small- Значение меньше допустимого минимума.
too_large- Значение больше допустимого максимума.
too_long- Текст длиннее допустимого.
bad_format- Значение не в ожидаемом формате.
not_allowed- Значение не входит в допустимые варианты.
not_a_url- Значение не является ссылкой http или https.
too_few_lines- В списке меньше строк, чем требуется.
too_many_lines- В списке больше строк, чем разрешено.
empty- Значение пустое.
unsupported_emoji- Реакция не входит в принимаемые услугой. details.emoji указывает её.
too_many_emoji- Разных реакций больше, чем разрешает услуга.
duplicate_emoji- Одна и та же реакция указана дважды.
bad_count- Число для реакции не является целым не менее 1.
mixed_forms- В одном значении смешаны реакции с числом и без числа.
line_too_long- Строка длиннее допустимого.
bad_length- Текст пустой или длиннее допустимого.
iso_country- Страна не является двухбуквенным кодом ISO 3166-1.
invalid_choice- Значение не входит в допустимые варианты.
url- Значение не является ссылкой http или https.
between_1_and_100- Число вне диапазона поля. Слово называет диапазон, например between_1_and_100.
between_10_and_500- Число вне диапазона поля. Слово называет диапазон, например between_1_and_100.