Visão geral da API ImportBR
O ImportBR oferece uma API REST completa para desenvolvedores e usuários técnicos que precisam ir além do que a interface visual oferece. Com a API, você pode:
- Disparar importações programaticamente a partir de uma lista de URLs
- Sincronizar preços e estoque em tempo real com seu ERP
- Criar fluxos de automação com ferramentas no-code (Zapier, Make/Integromat)
- Receber notificações via webhook quando produtos são publicados ou atualizados
- Integrar o ImportBR com planilhas Google Sheets para gestão centralizada
Base URL da API: https://api.importbr.com.br/v1/
Formato: JSON REST
Autenticação: Bearer Token (API Key)
Rate limit: 100 requests/minuto (plano Pro)
Autenticação e credenciais
Para usar a API, você precisa de uma API Key. Para gerar:
- Acesse o painel ImportBR → Configurações → API.
- Clique em "Gerar nova API Key".
- Copie e armazene com segurança — a key é exibida apenas uma vez.
- Use a key no header de cada request:
Authorization: Bearer SUA_API_KEY.
Principais endpoints
Importar produto por URL
POST /products/import
Body JSON:
{"url": "https://shopee.com.br/produto/...", "store_id": "sua-loja-id", "markup": 3.5, "auto_publish": true}
Resposta: {"job_id": "abc123", "status": "processing"}
Listar produtos importados
GET /products?status=published&page=1&limit=50
Retorna lista paginada de produtos com dados completos: id, título, preço, variações, status de sincronização.
Atualizar preço em lote
PATCH /products/bulk-price
Body: {"product_ids": ["id1", "id2"], "markup": 4.0}
Atualiza o markup de múltiplos produtos e sincroniza com a loja automaticamente.
Configurando webhooks
Webhooks permitem que o ImportBR notifique seu sistema quando eventos acontecem. Para configurar:
- Acesse Configurações → Webhooks → Adicionar endpoint.
- Informe a URL do seu servidor que receberá as notificações.
- Selecione os eventos: product.published, product.price_changed, product.out_of_stock.
- Salve e teste o webhook usando o botão "Enviar evento de teste".
Cada webhook envia um payload JSON com os dados do evento. Seu servidor deve responder com status 200 em menos de 5 segundos para confirmar o recebimento.
Integrações no-code
Sem precisar escrever código, você pode integrar o ImportBR com centenas de ferramentas via Zapier ou Make (Integromat):
- Google Sheets + ImportBR: quando um produto é publicado (webhook), adiciona automaticamente uma linha na planilha com dados do produto, preço e margem.
- Slack + ImportBR: receba notificação no Slack sempre que um produto ficar sem estoque ou o preço do fornecedor mudar mais de 10%.
- Airtable + ImportBR: banco de dados centralizado de todos os produtos importados para gestão e análise.
- WhatsApp + ImportBR: receba alertas via WhatsApp Business API quando pedidos chegam em produtos específicos.
A documentação completa da API está disponível em docs.importbr.com.br — com exemplos em Python, JavaScript e curl para cada endpoint.
Pronto para colocar em prática?
Comece a importar produtos agora mesmo — grátis, sem cartão de crédito.
Criar conta gratuita