V4MOS.AI API
GuidesAPI Referenceapp.v4mos.ai
Google Ads

Ad Group Ads

GET
/v1/google/ads/ad-group-ads

Retrieve Google Ads ad group ads data with comprehensive performance metrics.

This endpoint provides ad-level insights including ad status, type, strength, creative elements, and performance indicators.

Dimensions Available:

  • Ad group resource name/ID
  • Ad resource name/ID, ad status, type, strength
  • Final URLs: desktop/mobile
  • Responsive search ad: headlines/descriptions
  • Metrics: clicks, impressions, cost, conversions, CTR, CPC, cost per conversion, all conversions, conversions value
  • Date segments

Limitations:

  • Maximum 5000 records per page
  • Supports date filtering via createdStart and createdEnd (YYYY-MM-DD format)
  • Supports sorting via orderBy and orderDirection (ASC/DESC)

Filters:

  • organizationId (required)
  • userId (optional)
  • integrationName (optional)
  • createdStart (optional)
  • createdEnd (optional)

Authorization

ClientIdAuthClientSecretAuth
headerx-client-id<token>

Client ID

headerx-client-secret<token>

Client secret

Query Parameters

organizationId*string

Organization identifier (required)

userId?string

User identifier (optional)

integrationName?string

Integration name identifier (optional)

createdStart?string

Start date for filtering (optional, YYYY-MM-DD format)

Formatdate
createdEnd?string

End date for filtering (optional, YYYY-MM-DD format)

Formatdate
page?integer

Page number for pagination (optional)

Default1
limit?integer

Number of items per page (optional, max 5000)

Rangevalue <= 5000
Default500
orderBy?string

Field to order by (optional)

orderDirection?string

Order direction (optional)

Value in"ASC""DESC"

Response Body

Successful response

application/json
  1. response
data?array<>
meta?
curl -X GET "https://example.com/v1/google/ads/ad-group-ads?organizationId=organization_123&createdStart=2024-01-01&createdEnd=2024-12-31"
{  "data": [    {      "ad_group_resource_name": "string",      "ad_group_id": "string",      "ad_group_ad_resource_name": "string",      "ad_group_ad_status": "string",      "ad_group_ad_ad_resource_name": "string",      "ad_group_ad_ad_id": "string",      "ad_group_ad_ad_strength": "string",      "ad_group_ad_ad_type": "string",      "ad_group_ad_ad_final_urls": {},      "ad_group_ad_ad_final_mobile_urls": {},      "ad_group_ad_ad_responsive_search_ad_headlines": {},      "ad_group_ad_ad_responsive_search_ad_descriptions": {},      "metrics_clicks": 0,      "metrics_conversions_from_interactions_rate": 0,      "metrics_conversions": 0,      "metrics_cost_micros": 0,      "metrics_cost_per_conversion": 0,      "metrics_ctr": 0,      "metrics_all_conversions_value": 0,      "metrics_all_conversions": 0,      "metrics_average_cpc": 0,      "metrics_impressions": 0,      "metrics_cost": 0,      "segments_date": "2019-08-24",      "organization_id": "string",      "user_id": "string",      "document_id": "string",      "integration_name": "string",      "inserted_at": "2019-08-24T14:15:22Z"    }  ],  "meta": {    "page": 0,    "limit": 0,    "hasNextPage": true,    "hasPreviousPage": true  }}

Ad Groups GET

Previous Page

Keywords GET

Next Page