Documentação para desenvolvedores

V4MOS.AI API

Uma API REST unificada para os dados de marketing, e-commerce e CRM da sua organização: Google Ads, Meta Ads, Shopify, VTEX, HubSpot e mais, em um só lugar.

ComeçarReferência da API
Requisição
curl -G "https://data.v4mos.ai/v1/google/accounts" \
  -H "x-client-id: $V4MOS_CLIENT_ID" \
  -H "x-client-secret: $V4MOS_CLIENT_SECRET" \
  --data-urlencode "organizationId=$V4MOS_ORGANIZATION_ID" \
  --data-urlencode "limit=100"
Resposta · 200 OK
{
  "data": [
    {
      "customer_id": "999-111-2222",
      "customer_descriptive_name": "Marca Brasil",
      "customer_currency_code": "BRL",
      "customer_status": "ENABLED"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 100,
    "hasNextPage": false,
    "hasPreviousPage": false
  }
}

Integrações

Cada integração tem uma visão geral e uma página por endpoint, com parâmetros, schemas e playground.

Como funciona em 3 passos

Da credencial à primeira resposta em poucos minutos.

  1. Gere suas credenciais

    Em app.v4mos.ai, acesse Configurações → API de Dados (requer permissão de Admin na organização) e copie o client_id e o client_secret.

    Ver Autenticação

  2. Envie os headers

    Inclua x-client-id e x-client-secret em todas as requisições, sempre via HTTPS.

    Ver exemplo de requisição

  3. Informe a organização e chame

    Passe o organizationId como query parameter e chame qualquer endpoint em https://data.v4mos.ai.

    Ver o parâmetro organizationId