/2026-01/retail-media/accounts/{account-id}/audience-segments - Criteo Docs

Documentation Index

Fetch the complete documentation index at: /llms.txt

Use this file to discover all available pages before exploring further.

PATCH Request Example

curl --request PATCH \
  --url https://api.criteo.com/2026-01/retail-media/accounts/{account-id}/audience-segments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": [\
    {\
      "attributes": {\
        "contactList": {},\
        "description": {\
          "value": "<string>"\
        },\
        "events": {\
          "brandIds": [\
            "<string>"\
          ],\
          "categoryIds": [\
            "<string>"\
          ],\
          "maxPrice": {\
            "value": 123\
          },\
          "minPrice": {\
            "value": 123\
          }\
        },\
        "name": "<string>"\
      },\
      "id": "<string>",\
      "type": "<string>"\
    }\
  ]
}'

Python Example

import requests

url = "https://api.criteo.com/2026-01/retail-media/accounts/{account-id}/audience-segments"

payload = { "data": [\
        {\
            "attributes": {\
                "contactList": {},\
                "description": { "value": "<string>" },\
                "events": {\
                    "brandIds": ["<string>"],\
                    "categoryIds": ["<string>"],\
                    "maxPrice": { "value": 123 },\
                    "minPrice": { "value": 123 }\
                },\
                "name": "<string>"\
            },\
            "id": "<string>",\
            "type": "<string>"\
        }\
    ] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

JavaScript Fetch Example

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    data: [\
      {\
        attributes: {\
          contactList: {},\
          description: {value: '<string>'},\
          events: {\
            brandIds: ['<string>'],\
            categoryIds: ['<string>'],\
            maxPrice: {value: 123},\
            minPrice: {value: 123}\
          },\
          name: '<string>'\
        },\
        id: '<string>',\
        type: '<string>'\
      }\
    ]
  })
};

fetch('https://api.criteo.com/2026-01/retail-media/accounts/{account-id}/audience-segments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

PHP cURL Example

<?php

$curl = curl_init();

curl_setopt_array($curl, [\
  CURLOPT_URL => "https://api.criteo.com/2026-01/retail-media/accounts/{account-id}/audience-segments",\
  CURLOPT_RETURNTRANSFER => true,\
  CURLOPT_ENCODING => "",\
  CURLOPT_MAXREDIRS => 10,\
  CURLOPT_TIMEOUT => 30,\
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\
  CURLOPT_CUSTOMREQUEST => "PATCH",\
  CURLOPT_POSTFIELDS => json_encode([\
    'data' => [\
        [\
                'attributes' => [\
                                'contactList' => [\
\
                                ],\
                                'description' => [\
                                                                'value' => '<string>'\
                                ],\
                                'events' => [\
                                                                'brandIds' => [\
                                                                                                                                '<string>'\
                                                                ],\
                                                                'categoryIds' => [\
                                                                                                                                '<string>'\
                                                                ],\
                                                                'maxPrice' => [\
                                                                                                                                'value' => 123\
                                                                ],\
                                                                'minPrice' => [\
                                                                                                                                'value' => 123\
                                                                ]\
                                ],\
                                'name' => '<string>'\
                ],\
                'id' => '<string>',\
                'type' => '<string>'\
        ]\
    ]\
  ]),\
  CURLOPT_HTTPHEADER => [\
    "Authorization: Bearer <token>",\
    "Content-Type: application/json"\
  ],\
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
?>

Go Example

package main

import (
    "fmt"
    "strings"
    "net/http"
    "io"
)

func main() {

url := "https://api.criteo.com/2026-01/retail-media/accounts/{account-id}/audience-segments"

payload := strings.NewReader("{\n  \"data\": [\n    {\n      \"attributes\": {\n        \"contactList\": {},\n        \"description\": {\n          \"value\": \"<string>\"\n        },\n        \"events\": {\n          \"brandIds\": [\n            \"<string>\"\n          ],\n          \"categoryIds\": [\n            \"<string>\"\n          ],\n          \"maxPrice\": {\n            \"value\": 123\n          },\n          \"minPrice\": {\n            \"value\": 123\n          }\n        },\n        \"name\": \"<string>\"\n      },\n      \"id\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ]}\")

req, _ := http.NewRequest("PATCH", url, payload)

req.Header.Add("Authorization", "Bearer <token>")
    req.Header.Add("Content-Type", "application/json")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
    body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))
}

Sample HTTP Response

{
  "data": [\
    {\
      "attributes": {\
        "accountId": "<string>",\
        "channels": [],\
        "contactList": {\
          "isReadOnly": true\
        },\
        "createdAt": "2023-11-07T05:31:56Z",\
        "createdById": "<string>",\
        "description": "<string>",\
        "events": {\
          "brandIds": [\
            "<string>"\
          ],\
          "categoryIds": [\
            "<string>"\
          ],\
          "maxPrice": 123,\
          "minPrice": 123\
        },\
        "name": "<string>",\
        "retailerId": "<string>",\
        "updatedAt": "2023-11-07T05:31:56Z"\
      },\
      "id": "<string>",\
      "type": "<string>"\
    }\
  ],\
  "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>"\
    }\
  ]
}

Authorization