Developer documentation
V4MOS.AI API
One unified REST API for the marketing, e-commerce and CRM data of your organization: Google Ads, Meta Ads, Shopify, VTEX, HubSpot and more, in one place.
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
}
}Integrations
Every integration has an overview and one page per endpoint, with parameters, schemas and a playground.
- Google Ads14 endpointsAccounts, campaigns, ad groups, keywords, conversions and segmentations
- Facebook Ads14 endpointsAccounts, campaigns, ad sets, ads, creatives and breakdowns
- Google Analytics6 endpointsGA4 sessions, events, transactions, customers and products
- Tray3 endpointsCustomers, orders and products
- Shopify4 endpointsCustomers, orders, order items and products
- VTEX2 endpointsOrders and order items
- E-commerce Summary3 endpointsAggregated order summary for VTEX, Shopify and Tray
- HubSpot5 endpointsContacts, deals, companies, pipelines and products
- Kommo4 endpointsLeads, contacts, pipelines and users
- CRM V45 endpointsLeads, opportunities, companies, contacts and pipelines
- Profitability5 endpointsProfitability indicators, metric evolution and cohorts
- Products5 endpointsSales, margin, stock and entry cohort per product
- Acquisition8 endpointsFunnel, channels, campaigns and paid media
How it works in 3 steps
From credentials to your first response in a few minutes.
Generate your credentials
On app.v4mos.ai, open Settings → Data API (requires Admin permission in the organization) and copy the client_id and client_secret.
Read AuthenticationSend the headers
Include x-client-id and x-client-secret in every request, always over HTTPS.
See a request examplePass the organization and call
Send organizationId as a query parameter and call any endpoint on https://data.v4mos.ai.
Read about organizationId