> 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/ko/data-api/catalog-products-2/syncing-catalog-via-api.md).

# API를 통한 카탈로그 동기화

제품을 동기화하려면 푸시할 `catalogId` 이 필요합니다. 대부분의 연동에서 이 항목은 담당 테크니컬 계정 관리자가 대신 생성합니다. 카탈로그가 생성되면 테크니컬 계정 관리자가 Epsilon Retail Media 포털 내에서 카탈로그를 볼 수 있도록 설정해야 합니다.

## 카탈로그 생성 컨텍스트

다음은 카탈로그 생성을 위한 컨텍스트 예시입니다.

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

성공하면 다음 객체가 반환됩니다.

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

{% hint style="danger" %}
️

객체가 성공적으로 반환되면 새 카탈로그에 대한 `id` 을 받게 됩니다. 동일한 요청을 다시 제출하면 새로운 `id`이 생성되어 두 개의 카탈로그가 생성됩니다.
{% endhint %}

{% hint style="info" %}
제품 동기화를 위해 이 `id` 이 필요합니다.
{% endhint %}

## 다중 카탈로그 생성

여러 카탈로그를 생성하는 경우 요청당 최대 100개까지 순차적으로 처리할 수 있습니다. 다음은 두 개의 카탈로그를 생성하는 컨텍스트 예시입니다.

```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"
        }
    ]
}
```

성공하면 다음 객체가 반환됩니다(각 카탈로그는 고유한 `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" %}
카탈로그는 생성 후 기본적으로 숨겨집니다. 네임스페이스에서 카탈로그를 볼 수 있도록 하려면 담당 테크니컬 계정 관리자에게 문의하세요.
{% 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/ko/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.