Datasets

A dataset is an entity that encompasses data related to a website or app, captured events through our OneTag, product catalogs, currency, language, and country.

📘

Dataset is a mandatory requirement when creating a new ad-set through API.

Each advertiser can link to one dataset or more. On the other side, the datasets connect to a single advertiser.

Search for Datasets

You can retrieve through Criteo's API all datasets of a specified advertiser by its ID.

https://api.criteo.com/preview/advertisers/{advertiser-id}/datasets

 
The API will return an array of the IDs and names of all datasets associated with the specified advertiser ID. Please note that the advertiser ID is required in the request URL.

{
    "data": [
        {
            "type": "dataset",
            "id": "12345",
            "attributes": {
                "name": "ACME Dehydrated Rocks"
            },
        },
        {
            "type": "dataset",
            "id": "54321",
            "attributes": {
                "name": "ACME Exploding Bird Seed"
        }
    ],
    "errors": [     /* omitted if no errors */
        ...
    ],
    "warnings": [   /* omitted if no warnings */
        ...
    ]
}