API para Parceiros
Integre as promoções do Pechincha.ai ao seu produto

Visão geral

A API de parceiros dá acesso ao catálogo de promoções e produtos do Pechincha.ai. Todas as respostas são JSON e todos os endpoints são de leitura (GET).

Base URL: https://api.pechincha.ai/api-partner

Autenticação

Toda requisição precisa do header x-api-key com a sua chave de parceiro. Para obter uma chave, fale com a gente pela página comercial. Requisições sem chave válida retornam 401.

curl -H "x-api-key: pk_sua_chave_aqui" \
  "https://api.pechincha.ai/api-partner/promotions?search=tv"

Listar promoções

GET https://api.pechincha.ai/api-partner/promotions

Retorna as promoções ativas, 25 por página. Parâmetros de query (todos opcionais):

Exemplo de resposta (resumida):

{
  "count": 1834,
  "page": 1,
  "data": [
    {
      "id": "9b2f4c81-77aa-4a2b-9c1e-0f3d2a1b5c6d",
      "slug": "smart-tv-50-4k",
      "title": "Smart TV 50\" 4K",
      "description": "Menor preço dos últimos 90 dias...",
      "coupon_code": null,
      "discount": 12.5,
      "price": 1999.9,
      "old_price": 2285.6,
      "type": "PROMOTION",
      "url": "https://pechincha.link/p/a3f9c02b1e",
      "images": ["https://..."],
      "is_active": true,
      "is_verified": true,
      "created_at": "2026-08-29T14:00:00.000Z",
      "total_views": 240,
      "total_shares": 12,
      "total_reactions": 31,
      "reactions": { "fire": 18, "loved": 9, "...": 0 },
      "tags": [{ "id": "...", "slug": "tv", "name": "TV" }],
      "product": { "id": "...", "slug": "...", "name": "...", "images": ["..."] },
      "store": { "id": "...", "slug": "magalu", "name": "Magalu", "avatar": "...", "is_verified": true },
      "category": { "id": "...", "slug": "eletronicos", "name": "Eletrônicos" }
    }
  ]
}

Produtos

GET https://api.pechincha.ai/api-partner/product/:productId            → detalhes do produto
GET https://api.pechincha.ai/api-partner/product/slug/:productSlug     → detalhes por slug
GET https://api.pechincha.ai/api-partner/product/:productId/promotions → comparação de preços entre lojas
GET https://api.pechincha.ai/api-partner/product/:productId/price-history → histórico de preços
GET https://api.pechincha.ai/api-partner/product/:productId/related    → produtos relacionados

Exemplo de resposta de /product/:productId/promotions:

{
  "count": 4,
  "data": [
    {
      "id": "9b2f4c81-...",
      "slug": "smart-tv-50-4k",
      "title": "Smart TV 50\" 4K",
      "price": 1999.9,
      "old_price": 2285.6,
      "coupon_code": null,
      "url": "https://pechincha.link/p/a3f9c02b1e",
      "is_expired": false,
      "created_at": "2026-08-29T14:00:00.000Z",
      "store": { "id": "...", "name": "Magalu", "slug": "magalu", "avatar": "...", "is_verified": true }
    }
  ]
}

Links de promoção

O campo url de toda promoção é um link curto no formato pechincha.link/p/:codigo. Ao ser acessado, ele exibe uma pré-visualização da oferta (Open Graph para WhatsApp e redes sociais) e redireciona automaticamente para a loja. Use sempre esse link — não tente extrair ou reconstruir o link da loja.

Para atribuição, adicione o parâmetro ref com o seu identificador de parceiro e, opcionalmente, parâmetros utm_*:

https://pechincha.link/p/a3f9c02b1e?ref=seu-id&utm_source=newsletter

Limites e erros

O limite é de 60 requisições por minuto. Acima disso a API responde 429. Use as páginas e o cache do seu lado para reduzir chamadas.

Quer ser parceiro?

Entre em contato pela página comercial ou pelo fale conosco para receber sua API key e alinhar o uso.