Skip to main content
POST
/
preview
/
marketing-solutions
/
ad-sets
/
search
/preview/marketing-solutions/ad-sets/search
curl --request POST \
  --url https://api.criteo.com/preview/marketing-solutions/ad-sets/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": {
    "advertiserIds": [
      "12345"
    ]
  }
}
'
{
  "data": [
    {
      "attributes": {
        "advertiserId": "<string>",
        "attributionConfiguration": {},
        "bidding": {
          "bidAmount": 123
        },
        "budget": {
          "budgetAmount": 123
        },
        "campaignId": "<string>",
        "datasetId": "<string>",
        "name": "<string>",
        "schedule": {
          "endDate": {
            "value": "2023-11-07T05:31:56Z"
          },
          "startDate": {
            "value": "2023-11-07T05:31:56Z"
          }
        },
        "targeting": {
          "deliveryLimitations": {
            "devices": [],
            "environments": [],
            "operatingSystems": []
          },
          "frequencyCapping": {
            "value": {
              "maximumImpressions": 123
            }
          },
          "geoLocation": {
            "countries": {
              "value": {
                "values": [
                  "<string>"
                ]
              }
            },
            "subdivisions": {
              "value": {
                "values": [
                  "<string>"
                ]
              }
            },
            "zipCodes": {
              "value": {
                "values": [
                  "<string>"
                ]
              }
            }
          }
        }
      },
      "id": "<string>",
      "type": "ReadAdSetV26Q1"
    }
  ],
  "errors": [
    {
      "code": "<string>",
      "detail": "<string>",
      "instance": "<string>",
      "source": {},
      "stackTrace": "<string>",
      "title": "<string>",
      "traceId": "<string>",
      "traceIdentifier": "<string>"
    }
  ],
  "warnings": [
    {
      "code": "<string>",
      "detail": "<string>",
      "instance": "<string>",
      "source": {},
      "stackTrace": "<string>",
      "title": "<string>",
      "traceId": "<string>",
      "traceIdentifier": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

request payload of the search endpoint

filters
object

Filter on ad set ids.

Multiple filters are combined with an implicit AND operation. Identifiers are string-encoded integers; invalid values are ignored. If no filter is provided (both arrays are null or empty), the search returns all accessible campaigns.

meta
object

Optional metadata for searching ad sets

Response

200 - application/json

data for the ad sets

List of output resources

data
(object | null)[] | null
read-only

read model data for resources

errors
object[] | null
read-only
warnings
object[] | null
read-only