API Pública de Cupons

Dados de cupons verificados e atualizados diariamente do Boa do Dia.

CC BY-SA 4.0 Uso gratuito com atribuição obrigatória: Dados via boadodia.com.br

Endpoint

GET /api/public/cupons

Filtros

Parâmetro	Tipo	Default	Descrição
`loja`	string	—	Filtra por loja (case-insensitive). Ex: `?loja=Amazon`
`categoria`	string	—	Categoria canônica: `tecnologia`, `moda`, `beleza`, `mercado`, `pet`, `esporte`, `casa`
`tag`	string	—	Busca textual em título, descrição e código
`destaque`	bool	false	`true` para só cupons em destaque
`limite`	int	20	Máximo 50
`offset`	int	0	Paginação

Rate limit

60 requisições por minuto por IP. Caso exceda, retorna HTTP 429.

Exemplos

# Todos os cupons (20 por página)
curl https://boadodia.com.br/api/public/cupons

# Cupons da Amazon
curl "https://boadodia.com.br/api/public/cupons?loja=Amazon"

# Cupons de tecnologia
curl "https://boadodia.com.br/api/public/cupons?categoria=tecnologia"

# Busca por "frete"
curl "https://boadodia.com.br/api/public/cupons?tag=frete"

# Paginação
curl "https://boadodia.com.br/api/public/cupons?limite=50&offset=50"

Resposta

{
  "meta": {
    "total": 28,
    "count": 20,
    "offset": 0,
    "limit": 20,
    "license": "CC BY-SA 4.0",
    "attribution": "Dados via boadodia.com.br",
    "documentation": "https://boadodia.com.br/api/public/docs"
  },
  "data": [
    {
      "id": 10,
      "codigo": "BOADODIA",
      "titulo": "10% OFF em Tudo na Petz",
      "loja": "Petz",
      "desconto": {"tipo": "porcentagem", "valor": 10},
      "validade": "2026-12-31",
      "destaque": true,
      "link": "https://boadodia.com.br/cupom/BOADODIA"
    }
  ]
}

Licença

Creative Commons BY-SA 4.0 — você pode compartilhar e adaptar, desde que atribua crédito ao Boa do Dia e licencie a obra derivada sob a mesma licença.

Atribuição obrigatória: incluir Dados via boadodia.com.br em qualquer uso público dos dados.

O campo link sempre aponta para a página interna no Boa do Dia. Não expomos link de afiliado diretamente — isso preserva a atribuição de comissão e evita scraping malicioso.

Dúvidas? fale conosco.