Google Ads

Campaigns Criterion

GET
/v1/google/ads/campaigns-criterion

Retrieve Google Ads campaigns criterion data including targeting and exclusion criteria at the campaign level.

This endpoint provides campaign-level targeting configuration details.

Dimensions Available:

  • Campaign resource name/ID/name/status
  • Campaign criterion resource name, criterion type, criterion ID

Limitations:

  • Maximum 5000 records per page
  • Supports sorting via orderBy and orderDirection (ASC/DESC)

Filters:

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

Note: This endpoint does not support date filtering as it returns configuration data rather than time-series metrics.

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)

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/campaigns-criterion?organizationId=organization_123"
{  "data": [    {      "campaign_resource_name": "string",      "campaign_status": "string",      "campaign_name": "string",      "campaign_id": "string",      "campaign_criterion_resource_name": "string",      "campaign_criterion_type": "string",      "campaign_criterion_criterion_id": "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  }}