# Search Ads 360 API API

> Search Ads 360 API API on Apizie: 11 endpoints (Retrieves a list of conversions from a DoubleClick Search engine account., Retrieves a list of conversions from a DoubleClick Search engine account., Inserts a batch of new conversions into DoubleClick Search., Updates a batch of conversions in DoubleClick Search., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/analytics:googleapis-doubleclicksearch/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `analytics:googleapis-doubleclicksearch`
- Category: Analytics
- Status: byok
- Source: https://developers.google.com/search-ads
- Page: https://apizie.tech/api/analytics/googleapis-doubleclicksearch
- OpenAPI: https://apizie.tech/api/analytics/googleapis-doubleclicksearch/openapi.json

The Search Ads 360 API allows developers to automate uploading conversions and downloading reports from Search Ads 360.

## Endpoints

### Retrieves a list of conversions from a DoubleClick Search engine account.
`GET https://apizie.tech/v1/analytics:googleapis-doubleclicksearch/doubleclicksearch-conversion-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| adGroupId | string | no | Numeric ID of the ad group. |
| adId | string | no | Numeric ID of the ad. |
| advertiserId | string | yes | Numeric ID of the advertiser. |
| agencyId | string | yes | Numeric ID of the agency. |
| campaignId | string | no | Numeric ID of the campaign. |
| criterionId | string | no | Numeric ID of the criterion. |
| customerId | string | no | Customer ID of a client account in the new Search Ads 360 experience. |
| endDate | integer | yes | Last date (inclusive) on which to retrieve conversions. Format is yyyymmdd. |
| engineAccountId | string | yes | Numeric ID of the engine account. |
| rowCount | integer | yes | The number of conversions to return per call. |
| startDate | integer | yes | First date (inclusive) on which to retrieve conversions. Format is yyyymmdd. |
| startRow | integer | yes | The 0-based starting index for retrieving conversions results. |

### Retrieves a list of conversions from a DoubleClick Search engine account.
`GET https://apizie.tech/v1/analytics:googleapis-doubleclicksearch/doubleclicksearch-conversion-get-by-customer-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| adGroupId | string | no | Numeric ID of the ad group. |
| adId | string | no | Numeric ID of the ad. |
| advertiserId | string | no | Numeric ID of the advertiser. |
| agencyId | string | no | Numeric ID of the agency. |
| campaignId | string | no | Numeric ID of the campaign. |
| criterionId | string | no | Numeric ID of the criterion. |
| customerId | string | yes | Customer ID of a client account in the new Search Ads 360 experience. |
| endDate | integer | yes | Last date (inclusive) on which to retrieve conversions. Format is yyyymmdd. |
| engineAccountId | string | no | Numeric ID of the engine account. |
| rowCount | integer | yes | The number of conversions to return per call. |
| startDate | integer | yes | First date (inclusive) on which to retrieve conversions. Format is yyyymmdd. |
| startRow | integer | yes | The 0-based starting index for retrieving conversions results. |

### Inserts a batch of new conversions into DoubleClick Search.
`POST https://apizie.tech/v1/analytics:googleapis-doubleclicksearch/doubleclicksearch-conversion-insert` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Updates a batch of conversions in DoubleClick Search.
`POST https://apizie.tech/v1/analytics:googleapis-doubleclicksearch/doubleclicksearch-conversion-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Updates the availabilities of a batch of floodlight activities in DoubleClick Search.
`POST https://apizie.tech/v1/analytics:googleapis-doubleclicksearch/doubleclicksearch-conversion-update-availability` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Generates and returns a report immediately.
`POST https://apizie.tech/v1/analytics:googleapis-doubleclicksearch/doubleclicksearch-reports-generate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Polls for the status of a report request.
`GET https://apizie.tech/v1/analytics:googleapis-doubleclicksearch/doubleclicksearch-reports-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| reportId | string | yes | ID of the report request being polled. |

### Downloads a report file encoded in UTF-8.
`GET https://apizie.tech/v1/analytics:googleapis-doubleclicksearch/doubleclicksearch-reports-get-file` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| reportFragment | integer | yes | The index of the report fragment to download. |
| reportId | string | yes | ID of the report. |

### Downloads a csv file(encoded in UTF-8) that contains ID mappings between legacy SA360 and new SA360. The…
`GET https://apizie.tech/v1/analytics:googleapis-doubleclicksearch/doubleclicksearch-reports-get-id-mapping-file` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| advertiserId | string | yes | Legacy SA360 advertiser ID. |
| agencyId | string | yes | Legacy SA360 agency ID. |

### Inserts a report request into the reporting system.
`POST https://apizie.tech/v1/analytics:googleapis-doubleclicksearch/doubleclicksearch-reports-request` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Retrieve the list of saved columns for a specified advertiser.
`GET https://apizie.tech/v1/analytics:googleapis-doubleclicksearch/doubleclicksearch-saved-columns-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| advertiserId | string | yes | DS ID of the advertiser. |
| agencyId | string | yes | DS ID of the agency. |

## Example
```
curl "https://apizie.tech/v1/analytics:googleapis-doubleclicksearch/doubleclicksearch-conversion-get" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Search Ads 360 API API?
Create a free Apizie key, then send GET https://apizie.tech/v1/analytics:googleapis-doubleclicksearch/doubleclicksearch-conversion-get with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Search Ads 360 API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Search Ads 360 API itself also needs your own key from googleapis.com.

### Can AI agents use the Search Ads 360 API API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key analytics:googleapis-doubleclicksearch.

### What is the status of the Search Ads 360 API API?
Needs your own provider key (bring your own key)