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
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.