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.
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"{
"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.
- Google Ads14 endpointsContas, campanhas, grupos de anúncios, palavras-chave, conversões e segmentações
- Facebook Ads14 endpointsContas, campanhas, conjuntos de anúncios, anúncios, criativos e breakdowns
- Google Analytics10 endpointsSessões, eventos, transações, clientes e produtos do GA4
- Google Search Console5 endpointsCliques, impressões, CTR e posição por dia, país, dispositivo, página e consulta
- Perfil da Empresa no Google5 endpointsLocais, contas, métricas diárias, palavras-chave de busca e avaliações
- TikTok Ads8 endpointsCampanhas, grupos de anúncios, anúncios e relatórios diários
- LinkedIn Ads6 endpointsCampanhas, criativos e métricas diárias
- Pinterest Ads7 endpointsCampanhas, grupos de anúncios, anúncios e métricas diárias
- Microsoft Ads9 endpointsCampanhas, anúncios, palavras-chave e relatórios de desempenho
- OpenAI Ads8 endpointsCampanhas, grupos de anúncios, anúncios e insights diários
- Tray3 endpointsClientes, pedidos e produtos
- Shopify4 endpointsClientes, pedidos, itens de pedido e produtos
- VTEX2 endpointsPedidos e itens de pedido
- WooCommerce7 endpointsPedidos, clientes, catálogo e estoque
- Nuvemshop9 endpointsPedidos, checkouts abandonados, clientes, catálogo e cupons
- Mercos4 endpointsPedidos B2B, clientes e produtos
- E-commerce Summary4 endpointsResumo agregado de pedidos de VTEX, Shopify e Tray
- HubSpot5 endpointsContatos, negócios, empresas, pipelines e produtos
- Kommo4 endpointsLeads, contatos, pipelines e usuários
- CRM V47 endpointsLeads, oportunidades, empresas, contatos e pipelines
- RD Station CRM6 endpointsNegócios, contatos, funis e etapas
- Salesforce5 endpointsOportunidades, leads e contatos
- Zoho CRM3 endpointsNegócios, leads e contatos
- Pipedrive10 endpointsNegócios, leads, pessoas, funis e etapas
- Agendor10 endpointsNegócios, pessoas, empresas e funis
- Ploomes13 endpointsNegócios, leads, clientes e funis
- Moskit8 endpointsNegócios, contatos, funis e etapas
- Exact Sales12 endpointsLeads, vendas, perdas e histórico de etapas
- Meetime7 endpointsLeads, prospecções, atividades e cadências
- Bitrix247 endpointsNegócios, leads, contatos e histórico de fases
- PipeRun11 endpointsOportunidades, pessoas, empresas e funis
- GTM Motions1 endpointAs motions de go-to-market da organização e o gtmMotionId de cada uma
- Lucratividade11 endpointsIndicadores de lucratividade, evolução de métricas e cohort
- Produtos5 endpointsVenda, margem, estoque e cohort de entrada por produto
- Cupons2 endpointsPedidos, unidades, desconto e receita por código de cupom
- Aquisição8 endpointsFunil, canais, campanhas e mídia paga
- Forecast2 endpointsBase de receita e cenários de 12 meses
Como funciona em 3 passos
Da credencial à primeira resposta em poucos minutos.
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çãoEnvie os headers
Inclua x-client-id e x-client-secret em todas as requisições, sempre via HTTPS.
Ver exemplo de requisiçãoInforme 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