API: dados do produto (POST /product)

Retorna dados do produto, o link de afiliado, o link final e o histórico de preços a partir de uma URL. O site/provider é detectado automaticamente.

• Método: POST
• Path: /api/v1/product
• Auth: header X-API-Key

A extração aceita o formato atual de produto do Magazine Você. Para Magalu e Terabyte, bloqueios no acesso direto podem usar uma segunda tentativa pelo proxy de extração. URLs de outras lojas com /produto/ não são tratadas como produtos da KaBuM.

No Mercado Livre, anúncios sem catálogo também são identificados no destaque do link de afiliado, com sua variação. Os produtos da seção “Para você” não substituem o produto destacado.

Request

{
  "url": "https://shopee.com.br/...",
  "telegram_user_id": 123456789,
  "history_limit": 10
}

• url (obrigatório): URL do produto.
• telegram_user_id (opcional): tracking/telemetria.
• history_limit (opcional): limite do histórico (1 a 50; padrão 10).

Response (200)

{
  "success": true,
  "url_original": "https://shopee.com.br/...",
  "url_resolvida": "https://shopee.com.br/...",
  "affiliate_url": "https://...",
  "final_url": "https://...",
  "tracking_id": "....",
  "site": "shopee",
  "provider": "shopee",
  "product": {
    "title": "Nome do produto",
    "price": "199.90",
    "price_number": 199.9,
    "currency": "BRL",
    "image_url": "https://..."
  },
  "price_history": [
    { "createdAt": "2026-05-21T12:34:56.000Z", "price": "199.90", "priceNumber": 199.9, "currency": "BRL" }
  ]
}

Campos de product.* podem vir null quando não foi possível extrair. price_history pode ser [].

Erros

• 401 — {"success": false, "error": "invalid_api_key"}
• 400 — {"success": false, "error": "conversion_failed"} (sem rota/conversor elegível)

Veja a tabela completa em erros e limites.

Preço anterior e parcelamento

O produto pode retornar original_price e seu alias old_price para o preço anterior, além de installments. Campos ausentes retornam null; o preço anterior só é válido quando maior que o preço atual.

{
  "price": "199.90",
  "original_price": "299",
  "old_price": "299",
  "installments": { "count": 10, "amount": 19.99, "interest_free": true }
}

Os valores de amount e total são em reais. interest_free só aparece quando a fonte informa os juros. Não calcule parcelas dividindo o preço à vista: a condição do cartão pode ter outro total. A extração depende dos dados disponíveis no marketplace; a extensão também pode capturar a condição da página aberta pelo usuário.