Google Ads
Ad Group Criterion
GET
Retrieve Google Ads ad group criterion data including targeting and exclusion criteria at the ad group level.
This endpoint provides ad group-level targeting configuration details including keywords, placements, and other targeting criteria.
Dimensions Available:
- Ad group resource name/ID/name
- Ad group criterion resource name, criterion status, criterion type, criterion ID
Limitations:
- Maximum 5000 records per page
- Supports sorting via
orderByandorderDirection(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.
ClientIdAuthClientSecretAuthheader
x-client-id<token>Client ID
header
x-client-secret<token>Client secret
organizationId*stringOrganization identifier (required)
userId?stringUser identifier (optional)
integrationName?stringIntegration name identifier (optional)
page?integerPage number for pagination (optional)
Default
1limit?integerNumber of items per page (optional, max 5000)
Range
value <= 5000Default
500orderBy?stringField to order by (optional)
orderDirection?stringOrder direction (optional)
Value in
"ASC""DESC"Successful response
application/json- response
data?array<>meta?curl -X GET "https://example.com/v1/google/ads/ad-group-criterion?organizationId=organization_123"{ "data": [ { "ad_group_resource_name": "string", "ad_group_id": "string", "ad_group_name": "string", "ad_group_criterion_resource_name": "string", "ad_group_criterion_status": "string", "ad_group_criterion_type": "string", "ad_group_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 }}