Overview

The V4MOS.AI Google Ads API allows you to access and manage campaign data, ad groups, keywords, and much more.

Available EndpointsCopy Anchor Link

• getAccounts/v1/google/accountsRetrieve Google Ads account information and budget details.
• getCampaigns/v1/google/ads/campaignsRetrieve Google Ads campaign data with comprehensive performance metrics.
• getAd Groups/v1/google/ads/ad-groupRetrieve Google Ads ad group data with detailed performance metrics.
• getAd Group Ads/v1/google/ads/ad-group-adsRetrieve Google Ads ad group ads data with comprehensive performance metrics.
• getKeywords/v1/google/ads/keywordsRetrieve Google Ads keyword data with detailed performance metrics.
• getConversions/v1/google/ads/conversionsRetrieve Google Ads conversion data with detailed performance metrics.
• getAge Range/v1/google/ads/age-rangeRetrieve Google Ads age range targeting data with performance metrics.
• getGender/v1/google/ads/genderRetrieve Google Ads gender targeting data with performance metrics.
• getGeographic/v1/google/ads/geographicRetrieve Google Ads geographic targeting data with performance metrics.
• getConversion Segmented Campaigns/v1/google/ads/conversion-segmented-campaignsRetrieve Google Ads conversion segmented campaigns data with detailed conversion metrics.
• getConversion Segmented Ad Groups/v1/google/ads/conversion-segmented-ad-groupRetrieve Google Ads conversion segmented ad groups data with detailed conversion metrics.
• getConversion Segmented Ad Group Ads/v1/google/ads/conversion-segmented-ad-group-adsRetrieve Google Ads conversion segmented ad group ads data with detailed conversion metrics.
• getCampaigns Criterion/v1/google/ads/campaigns-criterionRetrieve Google Ads campaigns criterion data including targeting and exclusion criteria at the campaign level.
• getAd Group Criterion/v1/google/ads/ad-group-criterionRetrieve Google Ads ad group criterion data including targeting and exclusion criteria at the ad group level.

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 - Organization ID (required)
• userId - User ID
• page - Page number (default: 1)
• limit - Limit per page (default: 500, max: 5000)
• orderBy - Field for ordering
• orderDirection - Order direction (ASC/DESC)
• createdStart - Start date for filtering
• createdEnd - End date for filtering

ResponsesCopy Anchor Link

All responses follow the standard format:

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