# Authorized Buyers Marketplace API API

> Authorized Buyers Marketplace API API on Apizie: 27 endpoints (List the auction packages. Buyers can use the URL path "/v1/buyers/{accountId}/auctionPackages" to list…, Lists finalized deals. Use the URL path "/v1/buyers/{accountId}/finalizedDeals" to list finalized deals for…, Sets the given finalized deal as ready to serve. By default, deals are set as ready to serve as soon as…, Gets the requested publisher profile by name., …) 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://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `analytics:googleapis-authorizedbuyersmarketplace`
- Category: Analytics
- Status: byok
- Source: https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/
- Page: https://zieapi.vercel.app/api/analytics/googleapis-authorizedbuyersmarketplace
- OpenAPI: https://zieapi.vercel.app/api/analytics/googleapis-authorizedbuyersmarketplace/openapi.json

The Authorized Buyers Marketplace API lets buyers programmatically discover inventory; propose, retrieve and negotiate deals with publishers.

## Endpoints

### List the auction packages. Buyers can use the URL path "/v1/buyers/{accountId}/auctionPackages" to list…
`GET https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-auction-packages-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional. Optional query string using the [Cloud API list filtering syntax](/authorized-buyers/apis/guides/list-filters). Only supported… |
| orderBy | string | no | Optional. An optional query string to sort auction packages using the [Cloud API sorting… |
| pageSize | integer | no | Requested page size. The server may return fewer results than requested. Max allowed page size is 500. |
| pageToken | string | no | The page token as returned. ListAuctionPackagesResponse.nextPageToken |
| parent | string | yes | Required. Name of the parent buyer that can access the auction package. Format: `buyers/{accountId}`. When used with a bidder account, the… |

### Lists finalized deals. Use the URL path "/v1/buyers/{accountId}/finalizedDeals" to list finalized deals for…
`GET https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-finalized-deals-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional query string using the [Cloud API list filtering… |
| orderBy | string | no | An optional query string to sort finalized deals using the [Cloud API sorting… |
| pageSize | integer | no | Requested page size. The server may return fewer results than requested. If requested more than 500, the server will return 500 results… |
| pageToken | string | no | The page token as returned from ListFinalizedDealsResponse. |
| parent | string | yes | Required. The buyer to list the finalized deals for, in the format: `buyers/{accountId}`. When used to list finalized deals for a bidder,… |

### Sets the given finalized deal as ready to serve. By default, deals are set as ready to serve as soon as…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-finalized-deals-set-ready` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| deal | string | yes | Required. Format: `buyers/{accountId}/finalizedDeals/{dealId}` or `bidders/{accountId}/finalizedDeals/{dealId}` |
| body | object | yes | JSON request body |

### Gets the requested publisher profile by name.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-publisher-profiles-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. Name of the publisher profile. Format: `buyers/{buyerId}/publisherProfiles/{publisherProfileId}` |

### Updates the given deal at the buyer known revision number. If the server revision has advanced since the…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-proposals-deals-patch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Immutable. The unique identifier of the deal. Auto-generated by the server when a deal is created. Format:… |
| updateMask | string | no | List of fields to be updated. If empty or unspecified, the service will update all fields populated in the update request excluding the… |
| body | object | yes | JSON request body |

### Deletes an existing client user. The client user will lose access to the Authorized Buyers UI. Note that if…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-clients-users-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. Format: `buyers/{buyerAccountId}/clients/{clientAccountId}/clientUsers/{userId}` |

### Subscribe to the auction package for the specified buyer. Once subscribed, the bidder will receive a call…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-auction-packages-subscrib` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. Name of the auction package. Format: `buyers/{accountId}/auctionPackages/{auctionPackageId}` |
| body | object | yes | JSON request body |

### Subscribe the specified clients of the buyer to the auction package. If a client in the list does not belong…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-auction-packages-subscrib-2` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| auctionPackage | string | yes | Required. Name of the auction package. Format: `buyers/{accountId}/auctionPackages/{auctionPackageId}` |
| body | object | yes | JSON request body |

### Unsubscribe from the auction package for the specified buyer. Once unsubscribed, the bidder will no longer…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-auction-packages-unsubscr` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. Name of the auction package. Format: `buyers/{accountId}/auctionPackages/{auctionPackageId}` |
| body | object | yes | JSON request body |

### Unsubscribe from the auction package for the specified clients of the buyer. Unsubscribing a client that is…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-auction-packages-unsubscr-2` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| auctionPackage | string | yes | Required. Name of the auction package. Format: `buyers/{accountId}/auctionPackages/{auctionPackageId}` |
| body | object | yes | JSON request body |

### Activates an existing client user. The state of the client user will be updated from "INACTIVE" to "ACTIVE".…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-clients-users-activate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. Format: `buyers/{buyerAccountId}/clients/{clientAccountId}/clientUsers/{userId}` |
| body | object | yes | JSON request body |

### Lists all the clients for the current buyer.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-clients-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Query string using the [Filtering Syntax](https://developers.google.com/authorized-buyers/apis/guides/list-filters) Supported fields for… |
| pageSize | integer | no | Requested page size. If left blank, a default page size of 500 will be applied. |
| pageToken | string | no | A token identifying a page of results the server should return. Typically, this is the value of ListClientsResponse.nextPageToken returned… |
| parent | string | yes | Required. The name of the buyer. Format: `buyers/{accountId}` |

### Creates a new client.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-clients-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. The name of the buyer. Format: `buyers/{accountId}` |
| body | object | yes | JSON request body |

### Deactivates an existing client user. The state of the client user will be updated from "ACTIVE" to…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-clients-users-deactivate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. Format: `buyers/{buyerAccountId}/clients/{clientAccountId}/clientUsers/{userId}` |
| body | object | yes | JSON request body |

### Lists all client users for a specified client.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-clients-users-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | Requested page size. If left blank, a default page size of 500 will be applied. |
| pageToken | string | no | A token identifying a page of results the server should return. Typically, this is the value of ListClientUsersResponse.nextPageToken… |
| parent | string | yes | Required. The name of the client. Format: `buyers/{buyerAccountId}/clients/{clientAccountId}` |

### Creates a new client user in "INVITED" state. An email invitation will be sent to the new user, once…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-clients-users-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. The name of the client. Format: `buyers/{accountId}/clients/{clientAccountId}` |
| body | object | yes | JSON request body |

### Add creative to be used in the bidding process for a finalized deal. For programmatic guaranteed deals, it's…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-finalized-deals-add-creat` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| deal | string | yes | Required. Name of the finalized deal in the format of: `buyers/{accountId}/finalizedDeals/{dealId}` |
| body | object | yes | JSON request body |

### Pauses serving of the given finalized deal. This call only pauses the serving status, and does not affect…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-finalized-deals-pause` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. Format: `buyers/{accountId}/finalizedDeals/{dealId}` |
| body | object | yes | JSON request body |

### Resumes serving of the given finalized deal. Calling this method for an running deal has no effect. If a…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-finalized-deals-resume` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. Format: `buyers/{accountId}/finalizedDeals/{dealId}` |
| body | object | yes | JSON request body |

### Accepts the proposal at the given revision number. If the revision number in the request is behind the…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-proposals-accept` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Name of the proposal. Format: `buyers/{accountId}/proposals/{proposalId}` |
| body | object | yes | JSON request body |

### Creates a note for this proposal and sends to the seller. This method is not supported for proposals with…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-proposals-add-note` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| proposal | string | yes | Name of the proposal. Format: `buyers/{accountId}/proposals/{proposalId}` |
| body | object | yes | JSON request body |

### Cancels an ongoing negotiation on a proposal. This does not cancel or end serving for the deals if the…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-proposals-cancel-negotiat` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| proposal | string | yes | Name of the proposal. Format: `buyers/{accountId}/proposals/{proposalId}` |
| body | object | yes | JSON request body |

### Lists proposals. A filter expression using [Cloud API list filtering…
`GET https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-proposals-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional query string using the [Cloud API list filtering… |
| pageSize | integer | no | Requested page size. The server may return fewer results than requested. If unspecified, the server will put a size of 500. |
| pageToken | string | no | The page token as returned from ListProposalsResponse. |
| parent | string | yes | Required. Parent that owns the collection of proposals Format: `buyers/{accountId}` |

### Sends a request for proposal (RFP) to a publisher to initiate the negotiation regarding certain inventory.…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-proposals-send-rfp` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| buyer | string | yes | Required. The current buyer who is sending the RFP in the format: `buyers/{accountId}`. |
| body | object | yes | JSON request body |

### Batch updates multiple deals in the same proposal.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-proposals-deals-batch-upd` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. The name of the proposal containing the deals to batch update. Format: buyers/{accountId}/proposals/{proposalId} |
| body | object | yes | JSON request body |

### Lists all deals in a proposal. To retrieve only the finalized revision deals regardless if a deal is being…
`GET https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-proposals-deals-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | Requested page size. The server may return fewer results than requested. If requested more than 500, the server will return 500 results… |
| pageToken | string | no | The page token as returned from ListDealsResponse. |
| parent | string | yes | Required. The name of the proposal containing the deals to retrieve. Format: buyers/{accountId}/proposals/{proposalId} |

### Lists publisher profiles. The returned publisher profiles aren't in any defined order. The order of the…
`GET https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-publisher-profiles-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional query string using the [Cloud API list filtering] (https://developers.google.com/authorized-buyers/apis/guides/list-filters)… |
| pageSize | integer | no | Requested page size. The server may return fewer results than requested. If requested more than 500, the server will return 500 results… |
| pageToken | string | no | The page token as returned from a previous ListPublisherProfilesResponse. |
| parent | string | yes | Required. Parent that owns the collection of publisher profiles Format: `buyers/{buyerId}` |

## Example
```
curl "https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-auction-packages-list" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Authorized Buyers Marketplace API API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/analytics:googleapis-authorizedbuyersmarketplace/authorizedbuyersmarketplace-buyers-auction-packages-list with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Authorized Buyers Marketplace API API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key analytics:googleapis-authorizedbuyersmarketplace.

### What is the status of the Authorized Buyers Marketplace API API?
Needs your own provider key (bring your own key)