/2026-01/retail-media/categories/{categoryId} - Criteo Docs

Documentation Index

Fetch the complete documentation index at: /llms.txt

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

API Endpoint

/2026-01/retail-media/categories/{categoryId}

cURL Example

curl --request GET \
  --url https://api.criteo.com/2026-01/retail-media/categories/{categoryId} \
  --header 'Authorization: Bearer <token>'

Python Example

import requests

url = "https://api.criteo.com/2026-01/retail-media/categories/{categoryId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

JavaScript Example

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

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

PHP Example

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.criteo.com/2026-01/retail-media/categories/{categoryId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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"
    "net/http"
    "io"
)

func main() {
    
    url := "https://api.criteo.com/2026-01/retail-media/categories/{categoryId}"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("Authorization", "Bearer <token>")

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

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

fmt.Println(string(body))
}

Unirest Example

HttpResponse<String> response = Unirest.get("https://api.criteo.com/2026-01/retail-media/categories/{categoryId}")
  .header("Authorization", "Bearer <token>")
  .asString();

Ruby Example

require 'uri'
require 'net/http'

url = URI("https://api.criteo.com/2026-01/retail-media/categories/{categoryId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

Response

200 - application/json

{
  "name": "<string>",
  "parentId": "<string>",
  "text": "<string>"
}

Authorizations

Authorization
string
header
required
The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

categoryId
string
required
ID of the desired category

Response Detail

200 - application/json
object | null
Retrieval completed and category is returned.

List of retailer's categories, including the full hierarchy of categories and their parent category ID.