# Agencies and Brands API API

> Agencies and Brands API API on Apizie: 7 endpoints (Lists `Report` objects., Creates a `Report` object., Gets the latest state of a long-running operation. Clients can use this method to poll the operation result…, Updates a `Report` object., …) 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/dev-tools:google-agenciesandbrands/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `dev-tools:google-agenciesandbrands`
- Category: Dev Tools
- Status: byok
- Source: https://developers.google.com/authorized-buyers/agencies-and-brands/get-started/start
- Page: https://apizie.tech/api/dev-tools/google-agenciesandbrands
- OpenAPI: https://apizie.tech/api/dev-tools/google-agenciesandbrands/openapi.json

Agencies and brands API is an externally available HTTP API for ad agencies and brands to programmatically manage their deals and spending with Google Ad Manager publishers.

## Endpoints

### Lists `Report` objects.
`GET https://apizie.tech/v1/dev-tools:google-agenciesandbrands/agenciesandbrands-agencies-reports-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional. Expression to filter the response. See syntax details at https://developers.google.com/ad-manager/api/beta/filters |
| orderBy | string | no | Optional. Expression to specify sorting order. See syntax details at https://developers.google.com/ad-manager/api/beta/filters#order |
| pageSize | integer | no | Optional. The maximum number of `Reports` to return. The service may return fewer than this value. If unspecified, at most 50 `Reports`… |
| pageToken | string | no | Optional. A page token, received from a previous `ListReports` call. Provide this to retrieve the subsequent page. When paginating, all… |
| parent | string | yes | Required. The parent, which owns this collection of reports. Format: `agencies/{account_id}` |
| skip | integer | no | Optional. Number of individual resources to skip while paginating. |

### Creates a `Report` object.
`POST https://apizie.tech/v1/dev-tools:google-agenciesandbrands/agenciesandbrands-agencies-reports-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. The parent resource where this `Report` will be created. Format: `agencies/{account_id}` |
| body | object | yes | JSON request body |

### Gets the latest state of a long-running operation. Clients can use this method to poll the operation result…
`GET https://apizie.tech/v1/dev-tools:google-agenciesandbrands/agenciesandbrands-agencies-reports-operations-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | The name of the operation resource. |

### Updates a `Report` object.
`POST https://apizie.tech/v1/dev-tools:google-agenciesandbrands/agenciesandbrands-agencies-reports-patch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Identifier. The resource name of the report. Report resource name have the form: `agencies/{account_id}/reports/{report_id}` |
| updateMask | string | no | Optional. The list of fields to update. |
| body | object | yes | JSON request body |

### Deletes a `Report` object.
`POST https://apizie.tech/v1/dev-tools:google-agenciesandbrands/agenciesandbrands-agencies-reports-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. Resource name of the report to delete. Format: `agencies/{account_id}/reports/{report_id}` |

### Initiates the execution of an existing report asynchronously. Users can get the report by polling this…
`POST https://apizie.tech/v1/dev-tools:google-agenciesandbrands/agenciesandbrands-agencies-reports-run` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. The report to run. Format: `agencies/{account_id}/reports/{report_id}` |
| body | object | yes | JSON request body |

### Returns the result rows from a completed report. The caller must have previously called `RunReport` and…
`GET https://apizie.tech/v1/dev-tools:google-agenciesandbrands/agenciesandbrands-agencies-reports-results-fetch-rows` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | The report result being fetched. Format: `agencies/{account_id}/reports/{report_id}/results/{report_result_id}` |
| pageSize | integer | no | Optional. The maximum number of rows to return. The service may return fewer than this value. If unspecified, at most 1,000 rows will be… |
| pageToken | string | no | Optional. A page token, received from a previous `FetchReportResultRows` call. Provide this to retrieve the second and subsequent batches… |

## Example
```
curl "https://apizie.tech/v1/dev-tools:google-agenciesandbrands/agenciesandbrands-agencies-reports-list" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Agencies and Brands API API?
Create a free Apizie key, then send GET https://apizie.tech/v1/dev-tools:google-agenciesandbrands/agenciesandbrands-agencies-reports-list with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Agencies and Brands 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 dev-tools:google-agenciesandbrands.

### What is the status of the Agencies and Brands API API?
Needs your own provider key (bring your own key)