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

Age Range

GET
/v1/google/ads/age-range

Retrieve Google Ads age range targeting data with performance metrics.

This endpoint provides demographic insights segmented by age range, including campaign and ad group associations.

Dimensions Available:

  • Campaign ID/name
  • Ad group ID/name, age range, status, bidding strategy type
  • Metrics: impressions, clicks, cost, conversions, conversions value, all conversions, all conversions value
  • Date

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/age-range?organizationId=organization_123&createdStart=2024-01-01&createdEnd=2024-12-31"
{  "data": [    {      "campaign_id": "string",      "campaign_name": "string",      "date": "2019-08-24",      "impressions": 0,      "clicks": 0,      "cost": 0,      "conversions": 0,      "conversions_value": 0,      "all_conversions": 0,      "all_conversions_value": 0,      "status": "string",      "ad_group_id": "string",      "ad_group_name": "string",      "age_range": "string",      "bidding_strategy_type": "string",      "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  }}

Conversions GET

Previous Page

Gender GET

Next Page