Referência da API · v2.2.0

LabAds Growth Command Center — API

Seus dados também via API.Ver exemplo de integração

Leve seus resultados para automações, planilhas e sistemas próprios.

cURL · últimos 30 dias

curl --get \
  "https://engine.labads.com.br/api/v1/metrics" \
  --data-urlencode "range=30d" \
  --header "Authorization: Bearer SUA_API_KEY"

Gere sua chave em Configurações → API Key do workspace e substitua SUA_API_KEY. Use no seu servidor ou automação.

A resposta JSON contém _metadata com o workspace e o período, e data com os resultados dos canais conectados. Sem conexão, os canais retornam sem dados. Cada chave acessa somente seu workspace.

Os períodos aceitos incluem 7d, 30d e month. Respostas 401 indicam ausência de autenticação; 403, chave inválida; 429, limite de consultas atingido — aguarde o tempo informado em Retry-After. Gerar uma nova chave invalida a anterior.

Contrato OpenAPI 3.1 completo da plataforma. Toda superfície do produto está coberta — incluindo o motor de automação Fluxos — com a única exceção do canvas Desenhos/Draws, que é interno.

openapi.yaml Abrir no Redoc Abrir no Swagger Editor

Draws é a única página fora da API

O canvas Desenhos/Draws (/api/draws/*) é interno e fica deliberadamente fora deste contrato — é a única exclusão intencional, garantida por teste de cobertura.

Grupos de endpoints (33)

Public API v1

API pública estável de métricas (autenticação Bearer)

Public API v2

API de métricas com metadados da versão 2

Operational

Endpoints internos de operação e observabilidade

Analytics

Eventos e coleções de análise internos

Snapshots

Snapshots históricos de métricas

Export

Exportação de dados (JSON, CSV, PDF)

Billing

Checkout e gestão de assinaturas pelo Stripe

Webhooks

Recebimento de webhooks (Stripe)

Cron

Tarefas agendadas (autenticação CRON_SECRET)

Health

Verificação de saúde do sistema

Workspace

Gestão e configuração de workspaces

Integrations

Integrações com plataformas externas (Google Ads, Meta, GA4, YouTube)

Registry

Catálogo de métricas e dimensões para agentes de IA

User

Perfil e permissões do usuário

Query

API unificada de consultas baseada no padrão Registry

Jobs

Sistema de tarefas para operações assíncronas

Consultas e análises com IA

RBAC

Controle de acesso por papéis (permissões, papéis e concessões de acesso a recursos)

Organizations

Gestão de organizações e membros

Auth

Fluxos de autenticação OAuth (Google, LinkedIn, Meta)

Google Ads

Endpoints do Google Ads (segmentos de público, sugestões de localização e planejador de palavras-chave)

YouTube

Endpoints do YouTube (canais)