Google Ads
Conversions
GET
Retrieve Google Ads conversion data with detailed performance metrics.
This endpoint provides conversion-level insights including conversion action details, categories, and performance indicators segmented by conversion type.
Dimensions Available:
- Conversion action name/ID/category
- Conversion adjustment flag
- Conversions, conversions value, all conversions, all conversions value
- Ad group ID/name/status/type
- Campaign ID/name/group, bidding strategy type, ad ID
- Date
Limitations:
- Maximum 5000 records per page
- Supports date filtering via
createdStartandcreatedEnd(YYYY-MM-DD format) - Supports sorting via
orderByandorderDirection(ASC/DESC)
Filters:
organizationId(required)userId(optional)integrationName(optional)createdStart(optional)createdEnd(optional)
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)
createdStart?stringStart date for filtering (optional, YYYY-MM-DD format)
Format
datecreatedEnd?stringEnd date for filtering (optional, YYYY-MM-DD format)
Format
datepage?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/conversions?organizationId=organization_123&createdStart=2024-01-01&createdEnd=2024-12-31"{ "data": [ { "date": "2019-08-24", "conversion_action_name": "string", "conversion_action_id": "string", "conversion_action_category": "string", "conversion_adjustment": true, "all_conversions": 0, "all_conversions_value": 0, "conversions": 0, "conversions_value": 0, "ad_group_type": "string", "ad_group_status": "string", "ad_group_name": "string", "ad_group_id": "string", "ad_id": "string", "ad_group_campaign": "string", "campaign_bidding_strategy_type": "string", "campaign_id": "string", "campaign_name": "string", "campaign_group": "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 }}