The previous Search Ads 360 Reporting API is decommissioned. You can now create your reports using the new Search Ads 360 Reporting API.

Note that the get and getByCustomerId methods in the Search Ads 360 Conversion API are being deprecated in Q3 2025. To continue accessing conversion data, you must create a report using the conversion resource using the new Search Ads 360 Reporting API. See more details here.

The remaining Search Ads 360 Conversion API functions will continue to be supported.

Conversion: getByCustomerId

AI-generated Key Takeaways

Retrieves a list of conversions from a DoubleClick Search engine account using a new Search Ads 360 customer ID.
Requires authorization with the https://www.googleapis.com/auth/doubleclicksearch scope.
Request parameters include specifying date ranges, result limits, and filtering by ad group, ad, campaign, or criterion IDs.
The response, if successful, returns a Conversion resource.
You can try this method using the provided APIs Explorer or standalone Explorer.

Retrieves a list of conversions from a DoubleClick Search engine account using a new Search Ads 360 customer ID. Try it now.

Request

HTTP request

GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion

Parameters

Parameter name	Value	Description
Path parameters
`customerId`	`string`	New search Ads 360 Customer ID String. Must be a client account.
Required query parameters
`endDate`	`integer`	Last date (inclusive) on which to retrieve conversions. Format is yyyymmdd. Acceptable values are `20091101` to `99991231`, inclusive.
`rowCount`	`integer`	The number of conversions to return per call. Acceptable values are `1` to `1000`, inclusive.
`startDate`	`integer`	First date (inclusive) on which to retrieve conversions. Format is yyyymmdd. Acceptable values are `20091101` to `99991231`, inclusive.
`startRow`	`unsigned integer`	The 0-based starting index for retrieving conversions results.
Optional query parameters
`adGroupId`	`long`	Numeric ID of the ad group.
`adId`	`long`	Numeric ID of the ad.
`campaignId`	`long`	Numeric ID of the campaign.
`criterionId`	`long`	Numeric ID of the criterion.

Authorization

This request requires authorization with the following scope:

Scope
`https://www.googleapis.com/auth/doubleclicksearch`

For more information, see the authentication and authorization page.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a Conversion resource in the response body.

Try it!

Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer.