> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/de/data-api/catalog-products-2/syncing-catalog-via-api.md).

# Katalog über API synchronisieren

Um Produkte zu synchronisieren, benötigen Sie einen `catalogId` an den gesendet werden kann. In den meisten Integrationen wird dieser in Ihrem Namen von Ihrem Technical Account Manager erstellt. Sobald ein Katalog erstellt wurde, muss Ihr Technical Account Manager ihn in Ihrem Epsilon Retail Media -Portal sichtbar machen.

## Kontext für die Katalogerstellung

Unten finden Sie einen Beispielkontext für die Erstellung eines Katalogs:

```http
POST $BASE_URL/v1/catalogs HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "catalogs": [
        {
            "name": "Retailer A"
        }
    ]
}
```

Bei Erfolgsfall wird das folgende Objekt zurückgegeben:

```json
{
    "catalogs": [
        {
            "teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
            "name": "Retailer A",
            "id": "216af452-d219-4807-b8ca-578bba446541"
        }
    ]
}
```

{% hint style="danger" %}
️

Sobald ein Objekt erfolgreich zurückgegeben wurde, erhalten Sie eine `id` für Ihren neuen Katalog. Wenn Sie dieselbe Anfrage erneut senden, erhalten Sie eine neue `id`, wodurch zwei Kataloge erstellt werden.
{% endhint %}

{% hint style="info" %}
Sie benötigen diese `id` für die Produktsynchronisierung.
{% endhint %}

## Erstellen mehrerer Kataloge

Wenn Sie mehrere Kataloge erstellen, können Sie bis zu 100 pro Anfrage sequenzieren. Unten finden Sie einen Beispielkontext für die Erstellung von zwei Katalogen:

```http
POST $BASE_URL/v1/catalogs HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "catalogs": [
        {
            "name": "Retailer A"
        },
        {
            "name": "Retailer B"
        }
    ]
}
```

Bei Erfolgsfall wird das folgende Objekt zurückgegeben (jeder Katalog hat seine eigene individuelle `id`):

```json
{
    "catalogs": [
        {
            "teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
            "name": "Retailer A",
            "id": "216af452-d219-4807-b8ca-578bba446541"
        },
        {
            "teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
            "name": "Retailer B",
            "id": "75047339-65f5-41b8-8f2c-e76b04716cd4"
        }
    ]
}
```

{% hint style="warning" %}
Ein Katalog ist nach seiner Erstellung standardmäßig ausgeblendet. Wenden Sie sich an Ihren Technical Account Manager, um Ihren Katalog in Ihrem Namespace sichtbar zu machen.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.citrusad.com/retail-media-interface/integration/de/data-api/catalog-products-2/syncing-catalog-via-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.