Overview

The V4MOS.AI Google Analytics API centralizes sessions, events, custom events, customers, products, and transactions data from Google Analytics 4 properties connected to your organization. All endpoints live under the /v1/google-analytics prefix and follow the same authentication, pagination, and response patterns used across the platform.

Available EndpointsCopy Anchor Link

• getSessions/v1/google-analytics/sessionsRetrieve Google Analytics sessions with campaign, page, and traffic source metrics.
• getEvents/v1/google-analytics/eventsRetrieve Google Analytics events with engagement metrics.
• getCustom Events/v1/google-analytics/custom-eventsRetrieve Google Analytics custom events with metric mappings.
• getCustomers/v1/google-analytics/customersRetrieve Google Analytics customer metrics with geographic and device segmentation.
• getProducts/v1/google-analytics/productsRetrieve Google Analytics e-commerce product metrics.
• getTransactions/v1/google-analytics/transactionsRetrieve Google Analytics transaction metrics.

AuthenticationCopy Anchor Link

All endpoints require the x-client-id and x-client-secret headers, plus the organizationId query parameter. See Authentication.

Common ParametersCopy Anchor Link

• organizationId (required) – Organization that owns the Google Analytics integration
• userId – User scope
• page – Page number (default: 1)
• limit – Records per page (default: 500, max: 5000)
• createdStart / createdEnd – Filter by date range (ISO 8601)

Resource-Specific FiltersCopy Anchor Link

Sessions (/v1/google-analytics/sessions)Copy Anchor Link

• createdStart / createdEnd

Events (/v1/google-analytics/events)Copy Anchor Link

• createdStart / createdEnd

Custom Events (/v1/google-analytics/custom-events)Copy Anchor Link

• createdStart / createdEnd

Customers (/v1/google-analytics/customers)Copy Anchor Link

• createdStart / createdEnd

Products (/v1/google-analytics/products)Copy Anchor Link

• createdStart / createdEnd

Transactions (/v1/google-analytics/transactions)Copy Anchor Link

• createdStart / createdEnd

Google Analytics Data Model HighlightsCopy Anchor Link

SessionsCopy Anchor Link

• Campaign and traffic: campaign_id, campaign_name, source_medium, session_source_medium
• Page details: page_title, page_path
• Users and sessions: sessions, total_users, new_users, engaged_sessions, sessions_per_user
• Date: date

EventsCopy Anchor Link

• Identity: event_name, date
• Metrics: event_count, event_count_per_user, event_value, events_per_session, key_events

Custom EventsCopy Anchor Link

• Identity: event_name, event_date
• Metrics: metric_name, metric_value
• RD Station mapping: custom_rd_action, custom_rd_asset_id, custom_rd_filter
• Categorization: custom_event_category, custom_event_label

CustomersCopy Anchor Link

• Campaign and segmentation: campaign_id, campaign_name, device_category, source_medium
• Geography: city, region, country
• Audience metrics: active_users, total_users, sessions, engaged_sessions, bounce_rate
• Revenue metrics: purchase_revenue, total_revenue, total_purchases, purchaser_rate
• Date: date

ProductsCopy Anchor Link

• Product identity: item_id, item_name
• Revenue and purchases: item_revenue, items_purchased
• Interaction metrics: items_viewed, items_added_to_cart, items_checked_out, items_clicked_in_promotion, item_list_click_through_rate
• Date: date

TransactionsCopy Anchor Link

• Identity: event_name, date
• Metrics: transactions, transactions_per_purchaser

ResponsesCopy Anchor Link

All responses follow the standard format:

{
  "data": [...],
  "meta": {
    "page": 1,
    "limit": 500,
    "hasNextPage": true,
    "hasPreviousPage": false
  }
}