Catálogo
Campos e opções
Alguns serviços precisam de mais que um link e uma quantidade. Esta página lista cada campo extra, seus limites, como a quantidade é definida e como as reações do Telegram são enviadas.
Como os campos funcionam
Cada serviço lista os campos que aceita em fields (veja Listar serviços). Envie cada um pela sua key na mesma requisição add. Um campo é de um dos tipos abaixo. Uma lista de linhas tem um item por linha, separado por uma quebra de linha.
Tipos de campo
integer- Um número inteiro dentro dos limites indicados.
text- Um texto curto, até o comprimento indicado.
lines- Uma lista com um item por linha. Linhas em branco são descartadas.
choice- Um valor de uma lista fixa.
url- Um link que começa com
http://ouhttps://. reactions- Reações do Telegram, em mistura ou com quantidades exatas. Veja Reações do Telegram.
- 400
OPTION_NOT_SUPPORTED
This service does not accept {param}O serviço não aceita um campo que você enviou. Corrija a requisição primeiro.
- 400
MISSING_PARAMETER
Missing required parameter: {param}Falta um parâmetro obrigatório. details.param o indica. Corrija a requisição primeiro.
- 400
INVALID_OPTION
Invalid {param}: {rule}Um campo extra tem um valor inválido. details.param e details.rule dizem qual e por quê. Corrija a requisição primeiro.
Campos e quantidade por tipo de serviço
type_key informa quais campos enviar. Os tipos que partem de uma lista enviada por você (comentários personalizados, respostas a comentários e listas personalizadas de nomes de usuário) definem a quantidade por conta própria: é o número de linhas, e uma quantity diferente é recusada com QUANTITY_MISMATCH. Se você omitir quantity, ela é calculada para você.
| type_key | Campos | Quantidade |
|---|---|---|
| default | – | Qualquer quantidade do mínimo ao máximo do serviço, em múltiplos do seu passo (step). |
| package | – | Definida pelo serviço. Omita a quantidade. |
| seo | keywords | Qualquer quantidade do mínimo ao máximo do serviço, em múltiplos do seu passo (step). |
| custom_comments | comments | O número de linhas da lista. Você pode omitir a quantidade. |
| custom_comments_package | comments | Definida pelo serviço. Omita a quantidade. |
| mentions | usernames | Qualquer quantidade do mínimo ao máximo do serviço, em múltiplos do seu passo (step). |
| mentions_with_hashtags | usernames, hashtags | Qualquer quantidade do mínimo ao máximo do serviço, em múltiplos do seu passo (step). |
| mentions_custom_list | usernames | O número de linhas da lista. Você pode omitir a quantidade. |
| mentions_hashtag | hashtag | Qualquer quantidade do mínimo ao máximo do serviço, em múltiplos do seu passo (step). |
| mentions_user_followers | username | Qualquer quantidade do mínimo ao máximo do serviço, em múltiplos do seu passo (step). |
| mentions_media_likers | media | Qualquer quantidade do mínimo ao máximo do serviço, em múltiplos do seu passo (step). |
| comment_likes | username | Qualquer quantidade do mínimo ao máximo do serviço, em múltiplos do seu passo (step). |
| poll | answer_number | Qualquer quantidade do mínimo ao máximo do serviço, em múltiplos do seu passo (step). |
| comment_replies | comments, username | O número de linhas da lista. Você pode omitir a quantidade. |
| invites_from_groups | groups | Qualquer quantidade do mínimo ao máximo do serviço, em múltiplos do seu passo (step). |
| web_traffic | country, device, type_of_traffic, google_keyword, referring_url | Qualquer quantidade do mínimo ao máximo do serviço, em múltiplos do seu passo (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"
}Todos os campos
Os nomes são os nomes de campo que você envia. Campos usados por mais de um tipo têm um único nome: username é o autor do comentário em curtidas e respostas de comentários, e a conta alvo em menções de seguidores.
Campos extras
commentslinesObrigatório- Seus comentários, um por linha.De 1 a 10000 linhas, até 500 caracteres cada · Usado por: custom_comments, custom_comments_package, comment_replies
usernameslinesObrigatório- Nomes de usuário a mencionar, um por linha. Um @ no início é removido.De 1 a 10000 linhas, até 64 caracteres cada · Usado por: mentions, mentions_with_hashtags, mentions_custom_list
hashtagtextObrigatório- O hashtag cujos autores serão o alvo.Até 100 caracteres · Usado por: mentions_hashtag
usernametextObrigatório- A conta cujos seguidores serão o alvo. Um nome de usuário ou um link de perfil.Até 255 caracteres · Usado por: mentions_user_followers
mediaurlObrigatório- A publicação cujos curtidores serão o alvo.Até 2048 caracteres · Usado por: mentions_media_likers
usernametextObrigatório- O nome de usuário do autor do comentário.Até 64 caracteres · Usado por: comment_likes, comment_replies
answer_numberintegerObrigatório- O número da resposta da enquete em que votar.Número inteiro de 1 a 100 · Usado por: poll
keywordslinesObrigatório- Palavras-chave de busca, uma por linha.De 1 a 1000 linhas, até 255 caracteres cada · Usado por: seo
groupslinesObrigatório- Links de grupo, um por linha.De 1 a 1000 linhas, até 2048 caracteres cada · Usado por: invites_from_groups
countrytextOpcional- País como código ISO 3166-1 de duas letras, por exemplo
US.Até 2 caracteres · Usado por: web_traffic devicechoiceOpcional- Tipo de dispositivo das visitas.desktop · android · ios · mobile_mixed · all_mixed · Usado por: web_traffic
type_of_trafficchoiceOpcional- De onde vêm as visitas. O padrão é
direct.google_search · referrer · direct · Usado por: web_traffic google_keywordtextDepende do tipo de serviço- A palavra-chave de busca do Google. Obrigatória quando
type_of_trafficégoogle_search.Até 255 caracteres · Usado por: web_traffic referring_urlurlDepende do tipo de serviço- A página de onde as visitas chegam. Obrigatória quando
type_of_trafficéreferrer.Até 2048 caracteres · Usado por: web_traffic reactionsreactionsOpcional- Reações do Telegram, em mistura ou com quantidades exatas. Veja Reações do Telegram.Usado por: serviços que o listam em fields
last_postsintegerObrigatório- Quantas das últimas publicações do canal cobrir. Nesses serviços, o link é o nome de usuário do canal.Número inteiro de 10 a 500 · Usado por: serviços que o listam em fields
Reações do Telegram
O Telegram aceita 73 emojis de reação e no máximo 11 diferentes em uma publicação. Serviços com um campo reactions recebem as reações em um único valor de texto, e qualquer coisa fora do conjunto permitido é recusada antes de você ser cobrado. Envie os emojis como texto simples na requisição.
Duas formas de enviar reações
👍,❤️,🔥mix- Uma lista de emojis. Distribuímos
quantityentre eles, entãoquantityé obrigatória. 👍:60,❤️:40exact- Cada emoji com a sua própria contagem, um número inteiro de pelo menos 1. A quantidade é a soma, então
quantityé opcional; se você enviá-la, ela deve ser igual à soma.
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"
}As 73 reações permitidas
Um serviço pode permitir menos. A entrada dele em fields lista exatamente o que ele aceita em allowed, com max_distinct e modes. Um seletor de variação é ignorado na comparação, então um coração com ou sem ele conta como o mesmo emoji.
- 👍
- 👎
- ❤️
- 🔥
- 🥰
- 👏
- 😁
- 🤔
- 🤯
- 😱
- 🤬
- 😢
- 🎉
- 🤩
- 🤮
- 💩
- 🙏
- 👌
- 🕊️
- 🤡
- 🥱
- 🥴
- 😍
- 🐳
- ❤️🔥
- 🌚
- 🌭
- 💯
- 🤣
- ⚡
- 🍌
- 🏆
- 💔
- 🤨
- 😐
- 🍓
- 🍾
- 💋
- 🖕
- 😈
- 😴
- 😭
- 🤓
- 👻
- 👨💻
- 👀
- 🎃
- 🙈
- 😇
- 😨
- 🤝
- ✍️
- 🤗
- 🫡
- 🎅
- 🎄
- ☃️
- 💅
- 🤪
- 🗿
- 🆒
- 💘
- 🙉
- 🦄
- 😘
- 💊
- 🙊
- 😎
- 👾
- 🤷♂️
- 🤷
- 🤷♀️
- 😡
Erros de reações
- 400
INVALID_OPTION
Invalid {param}: {rule}Um campo extra tem um valor inválido. details.param e details.rule dizem qual e por quê. Corrija a requisição primeiro.
- 400
QUANTITY_MISMATCH
quantity must equal the number of items in {param} ({count})A quantidade não corresponde ao número de itens de uma lista ou de um campo de reações. Corrija a requisição primeiro.
- 400
MISSING_PARAMETER
Missing required parameter: {param}Falta um parâmetro obrigatório. details.param o indica. Corrija a requisição primeiro.
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"
}
}Palavras de regra
INVALID_PARAMETER e INVALID_OPTION trazem um details.rule curto que diz o que está errado. Ramifique primeiro por error_code e trate uma palavra de regra desconhecida como um valor inválido genérico, porque novas palavras podem ser adicionadas.
Palavras de regra em details.rule
must_be_integer- É necessário um número inteiro.
too_small- O valor está abaixo do mínimo permitido.
too_large- O valor está acima do máximo permitido.
too_long- O texto é mais longo que o permitido.
bad_format- O valor não está no formato esperado.
not_allowed- O valor não é uma das opções permitidas.
not_a_url- O valor não é um link http ou https.
too_few_lines- A lista tem menos linhas do que o exigido.
too_many_lines- A lista tem mais linhas do que o permitido.
empty- O valor está vazio.
unsupported_emoji- Uma reação não é aceita pelo serviço. details.emoji a indica.
too_many_emoji- Mais reações diferentes do que o serviço permite.
duplicate_emoji- A mesma reação aparece duas vezes.
bad_count- A contagem de uma reação não é um número inteiro de pelo menos 1.
mixed_forms- Reações com contagem e sem contagem estão misturadas em um mesmo valor.
line_too_long- Uma linha é mais longa que o permitido.
bad_length- O texto está vazio ou é mais longo que o permitido.
iso_country- O país não é um código ISO 3166-1 de duas letras.
invalid_choice- O valor não é uma das opções permitidas.
url- O valor não é um link http ou https.
between_1_and_100- O número está fora do intervalo do campo. A palavra indica o intervalo, por exemplo between_1_and_100.
between_10_and_500- O número está fora do intervalo do campo. A palavra indica o intervalo, por exemplo between_1_and_100.