# Curation Partners API API

> Curation Partners API API on Apizie: 15 endpoints (Activates a data segment., Lists curated packages owned by the specified curator., Creates a new curated package., Deactivates a data segment., …) 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-curationpartners/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `dev-tools:google-curationpartners`
- Category: Dev Tools
- Status: byok
- Source: https://developers.google.com/authorized-buyers/curation/apis/guides/curationpartners/overview
- Page: https://apizie.tech/api/dev-tools/google-curationpartners
- OpenAPI: https://apizie.tech/api/dev-tools/google-curationpartners/openapi.json

Curation partners API is an externally available HTTP API for curators to programmatically manage their data segments and curated packages used by ad agencies.

## Endpoints

### Activates a data segment.
`POST https://apizie.tech/v1/dev-tools:google-curationpartners/curationpartners-curators-data-segments-activate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. Name of data segment to activate. Format: `curators/{accountId}/dataSegments/{curatorDataSegmentId}` |
| body | object | yes | JSON request body |

### Lists curated packages owned by the specified curator.
`GET https://apizie.tech/v1/dev-tools:google-curationpartners/curationpartners-curators-curated-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). Supported… |
| pageSize | integer | no | Optional. Requested page size. The server may return fewer results than requested. Max allowed page size is 500. If unspecified, the… |
| pageToken | string | no | Optional. A page token, received from a previous `ListCuratedPackages` call. Provide this to retrieve the subsequent page. |
| parent | string | yes | Required. The parent curator account which owns this collection of curated packages. Format: `curators/{accountId}` |

### Creates a new curated package.
`POST https://apizie.tech/v1/dev-tools:google-curationpartners/curationpartners-curators-curated-packages-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. The parent curator account where this curated package will be created. Format: `curators/{accountId}` |
| body | object | yes | JSON request body |

### Deactivates a data segment.
`POST https://apizie.tech/v1/dev-tools:google-curationpartners/curationpartners-curators-data-segments-deactivate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. Name of data segment to deactivate. Format: `curators/{accountId}/dataSegments/{curatorDataSegmentId}` |
| 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-curationpartners/curationpartners-curators-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-curationpartners/curationpartners-curators-reports-patch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Identifier. The resource name of the report. Report resource name have the form: `curators/{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-curationpartners/curationpartners-curators-reports-delete` (byok)

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

### List the data segments owned by a curator.
`GET https://apizie.tech/v1/dev-tools:google-curationpartners/curationpartners-curators-data-segments-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | Optional. Requested page size. The server may return fewer results than requested. Max allowed page size is 500. If unspecified, the… |
| pageToken | string | no | Optional. The page token as returned. ListDataSegmentsResponse.nextPageToken |
| parent | string | yes | Required. Name of the parent curator that can access the data segment. Format: `curators/{accountId}` |

### Creates a data segment owned by the listed curator. The data segment will be created in the `ACTIVE` state,…
`POST https://apizie.tech/v1/dev-tools:google-curationpartners/curationpartners-curators-data-segments-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. The parent resource where this data segment will be created. Format: `curators/{accountId}` |
| body | object | yes | JSON request body |

### Lists `Report` objects.
`GET https://apizie.tech/v1/dev-tools:google-curationpartners/curationpartners-curators-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: `curators/{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-curationpartners/curationpartners-curators-reports-create` (byok)

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

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. The report to run. Format: `curators/{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-curationpartners/curationpartners-curators-reports-results-fetch-rows` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | The report result being fetched. Format: `curators/{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… |

### Lists all media planner accounts that the caller has access to. For curators, this will return all media…
`GET https://apizie.tech/v1/dev-tools:google-curationpartners/curationpartners-media-planners-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional query string using the [Cloud API list filtering syntax](/authorized-buyers/apis/guides/list-filters). Supported columns for… |
| pageSize | integer | no | The maximum number of media planners to return. If unspecified, at most 100 media planners will be returned. The maximum value is 500;… |
| pageToken | string | no | Optional. A token identifying a page of results the server should return.This value is received from a previous `ListMediaPlanners` call… |

### Searches for media planner accounts matching the given DSP seat ID.
`GET https://apizie.tech/v1/dev-tools:google-curationpartners/curationpartners-media-planners-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dspSeatId | string | no | Required. The DSP seat ID to search for. The DSP seat ID is provided by the media planner. |
| pageSize | integer | no | Optional. The maximum number of media planners to return. If unspecified, at most 100 media planners will be returned. The maximum value… |
| pageToken | string | no | Optional. A token identifying a page of results the server should return. This value is received from a previous `SearchMediaPlanners`… |

## Example
```
curl "https://apizie.tech/v1/dev-tools:google-curationpartners/curationpartners-curators-data-segments-activate" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Curation Partners API API?
Create a free Apizie key, then send POST https://apizie.tech/v1/dev-tools:google-curationpartners/curationpartners-curators-data-segments-activate with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Curation Partners 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-curationpartners.

### What is the status of the Curation Partners API API?
Needs your own provider key (bring your own key)