Curation

  • Use the curators.dataSegments.get method to view an individual data segment.

  • Use the curators.dataSegments.list method to view a list of all your data segments.

  • Both methods involve making an HTTP GET request to specific API endpoints.

View an individual data segment

To view one of your data segments, use the curators.dataSegments.get method.

The following example makes an HTTP GET request to an API endpoint that responds with the specified data segment.

Example curl API call

Request

curl \
'https://authorizedbuyersmarketplace.googleapis.com/v1beta/curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-1?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
 --compressed

Response

{
  "name": "curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-1",
  "createTime": "2025-08-13T12:14:03.421Z",
  "updateTime": "2025-08-14T19:47:40.253938Z",
  "cpmFee": {
    "currencyCode": "USD",
    "units": "1000000"
  },
  "state": "INACTIVE"
}

View a list of all your data segments

To view all of your data segments, use the curators.dataSegments.list method.

The following example makes an HTTP GET request to an API endpoint that responds with all data segments for the specified curator account.

Example curl API call

Request

curl \
'https://authorizedbuyersmarketplace.googleapis.com/v1beta/curators/[YOUR_ACCOUNT_ID]/dataSegments?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed

Response

{
  "dataSegments": [
    {
      "name": "curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-1",
      "createTime": "2025-08-13T12:14:03.421Z",
      "updateTime": "2025-08-14T20:05:51.439110Z",
      "cpmFee": {
        "currencyCode": "USD",
        "units": "1"
      },
      "state": "INACTIVE"
    },
    {
      "name": "curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-2",
      "createTime": "2025-08-14T17:45:08.744Z",
      "updateTime": "2025-08-14T17:56:02.200619Z",
      "cpmFee": {
        "currencyCode": "USD",
        "nanos": 50
      },
      "state": "ACTIVE"
    }
  ]
}

Next steps