Bot do AfiliadoA API REST permite converter links e obter dados de produto a partir de qualquer sistema. É a mesma engine usada pelo bot do Telegram.
📖 Referência completa e interativa: explore e teste todos os endpoints na referência Scalar da API » — com busca, schemas de request/response e try it out direto no navegador.
Base URL
https://botdoafiliado.com/api/v1/Autenticação
Use o header X-API-Key com uma chave gerada no painel (formato bk_...). Requer o módulo de API ativo. Veja autenticação.
X-API-Key: bk_xxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxEndpoints
Todos os endpoints abaixo estão detalhados (schemas, exemplos e try it out) na referência interativa.
Conversão — ver na referência »
| Endpoint | Método | O que faz |
|---|---|---|
/api/v1/convert-links |
POST | Converte 1 ou vários links (até 150). Guia: convert-links. |
/api/v1/convert |
POST | Conversão unitária (legado). Guia: convert (legado). |
Produtos — ver na referência »
| Endpoint | Método | O que faz |
|---|---|---|
/api/v1/product |
POST | Dados completos do produto (título, preço, preço “de”, estoque quando o marketplace fornece) + link de afiliado + histórico de preço. Guia: product. |
/api/v1/product/history |
GET | Só o histórico de preços de um produto. |
/api/v1/product/shipping |
POST | Frete de um produto AliExpress. |
/api/v1/search-products |
POST | Busca produtos por título no marketplace escolhido (site: shopee, aliexpress, amazon, magalu, kabum…). |
/api/v1/amazon-prices |
POST | Preços frescos de até 10 ASINs da Amazon de uma vez. |
Ofertas — ver na referência »
| Endpoint | Método | O que faz |
|---|---|---|
/api/v1/execute |
POST | Monta um post de oferta pronto (mesmo formato do bot) a partir de links, preços e cupom. |
/api/v1/chat |
POST | Processa uma mensagem como se fosse enviada ao bot. |
/api/v1/templates |
GET/POST | Lê e edita os templates de mensagem do bot. |
/api/v1/promo-card |
POST | Gera a arte de promo (card 1080×1080 ou story 1080×1920) com foto, preços, cupom e gatilho — devolve o PNG (ou grava e devolve a URL com store:true). |
/api/v1/showcase/items |
GET/POST | Lista e publica ofertas na vitrine pública do bot (DELETE /api/v1/showcase/items/{id} remove). |
Cupons — ver na referência »
| Endpoint | Método | O que faz |
|---|---|---|
/api/v1/coupons |
GET/POST | Lista e cadastra cupons do bot. |
/api/v1/coupons/{id} |
DELETE | Desativa um cupom. |
/api/v1/coupons/{id}/activate |
POST | Reativa um cupom. |
/api/v1/coupons/categories |
GET | Lista as categorias de cupom. |
/api/v1/coupons/ingest |
POST | Ingestão de cupons em massa (texto bruto → cupons). |
Formatos e limites
- Corpo e resposta em JSON.
- Batch: até 150 URLs por requisição em
/convert-links. - Erros e limites detalhados em erros e limites.
- Referência interativa em Scalar.
Próximos passos
- Ative o módulo de API.
- Gere uma API key.
- Faça sua primeira chamada em convert-links.