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
- TikTok Ads8 endpointsCampaigns, ad groups, ads and daily reports
- LinkedIn Ads6 endpointsCampaigns, creatives and daily analytics
- Pinterest Ads7 endpointsCampaigns, ad groups, ads and daily analytics
- Microsoft Ads9 endpointsCampaigns, ads, keywords and performance reports
- OpenAI Ads8 endpointsCampaigns, ad groups, ads and daily insights
- Tray3 endpointsCustomers, orders and products
- Shopify4 endpointsCustomers, orders, order items and products
- VTEX2 endpointsOrders and order items
- WooCommerce7 endpointsOrders, customers, catalog and stock
- Nuvemshop9 endpointsOrders, abandoned checkouts, customers, catalog and coupons
- Mercos4 endpointsB2B orders, customers and products
- 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
- RD Station CRM6 endpointsDeals, contacts, pipelines and stages
- Salesforce5 endpointsOpportunities, leads and contacts
- Zoho CRM3 endpointsDeals, leads and contacts
- Pipedrive10 endpointsDeals, leads, persons, pipelines and stages
- Agendor10 endpointsDeals, people, organizations and funnels
- Ploomes13 endpointsDeals, leads, contacts and pipelines
- Moskit8 endpointsDeals, contacts, pipelines and stages
- Exact Sales12 endpointsLeads, sales, losses and stage history
- Meetime7 endpointsLeads, prospections, activities and cadences
- Bitrix247 endpointsDeals, leads, contacts and stage history
- PipeRun11 endpointsDeals, persons, companies and pipelines
- Profitability5 endpointsProfitability indicators, metric evolution and cohorts
- Products5 endpointsSales, margin, stock and entry cohort per product
- Coupons2 endpointsOrders, units, discount and revenue per coupon code
- Acquisition8 endpointsFunnel, channels, campaigns and paid media
- Forecast2 endpointsRevenue baseline and 12-month scenarios
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