> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Catalog 관리

> 제품 카탈로그 설정, 대량 제품 관리, 타깃팅을 위한 product set 생성, X의 Dynamic Product Ads를 위한 예약 피드 구성을 지원합니다.

export const Button = ({href, children}) => {
  return <div className="not-prose">
    <a href={href}>
      <button className="x-btn">
        <span>{children}</span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

**Dynamic Product Ads를 위한 제품 카탈로그, 제품, product set, 예약 피드를 프로그래밍 방식으로 관리하세요.**

## 빠른 링크

* [전체 API 참조](/x-ads-api/catalog-management/reference) — 모든 Catalog Management 엔드포인트 및 객체
* [Product Specifications 가이드](https://business.x.com/en/help/shopping-specs.html) — 자세한 product feed 요구 사항 및 모범 사례

## 개요

Catalog API는 광고주에게 product feed를 설정하고, 제품을 세트로 그룹화하며, catalog 제품을 전반적으로 관리할 수 있는 능력을 제공하는 커머스 솔루션입니다. Catalog API는 프로그래밍 방식의 catalog 관리를 지원하며, 광고주에게 catalog가 수집되고 업데이트되는 방식에 대한 더 많은 제어권을 부여합니다.

catalog는 사용자의 제품 및 product set에 관한 모든 것을 담고 있으며, 사용자의 handle과 연결됩니다. **현재 사용자당 하나의 catalog만 생성할 수 있습니다.**

Catalog API는 제품을 수집하는 두 가지 방법을 지원합니다:

1. **Scheduled Feed**: 주기적으로 가져올 feed URL(CSV, TSV, XML)을 추가합니다. X는 최대 8GB 파일을 지원합니다.
2. **Batch Products API**: 배치(JSON) 요청으로 제품 속성을 조회, 생성, 업데이트, 삭제합니다.

X 판매자는 필터 규칙을 기반으로 product set을 만들 수 있습니다. 이를 통해 제품에 추가 메타데이터를 첨부하고 오가닉 커머스 기능이나 Dynamic Product Ads를 위한 특별한 product set을 만들 수 있습니다. Catalog API 및 X Shopping Manager는 두 가지 유형의 product set을 지원합니다:

1. **Manual**: 최대 50개의 제품을 선택하고 이름과 설명을 설정합니다.
2. **Filter**: 최대 30개의 필터를 추가하여 세트를 자동으로 생성합니다(가격, Google 제품 카테고리, 제품 유형, 재고, 세일 가격, 사용자 정의 필드 등).

### 사전 요건

Catalog API 엔드포인트는 현재 **얼리 액세스 전용**으로만 제공됩니다. 액세스를 신청하려면 X 담당자에게 문의하거나 해당 양식을 작성하세요.

[X Shopping Manager](https://ads.x.com/shopping_manager)를 통해 서비스 약관에 동의해야 합니다.

제품 사양 및 Shopping Manager 세부 정보는 [Product specifications 가이드](https://business.x.com/en/help/shopping-specs.html)를 참조하세요.

### Rate Limit

#### Product Catalog

| 엔드포인트                                                                                                                                   | Rate limit |
| :-------------------------------------------------------------------------------------------------------------------------------------- | :--------- |
| [GET /product\_catalogs](/x-ads-api/catalog-management/reference#get-product_catalogs)                                                  | 15분당 1,000 |
| [POST /product\_catalogs](/x-ads-api/catalog-management/reference#post-product_catalogs)                                                | 15분당 20    |
| [PUT /product\_catalogs/:product\_catalog\_id](/x-ads-api/catalog-management/reference#put-product_catalogs%2Fproduct_catalog_id)       | 15분당 20    |
| [DELETE /product\_catalogs/:product\_catalog\_id](/x-ads-api/catalog-management/reference#delete-product_catalogs%2Fproduct_catalog_id) | 15분당 20    |

#### Batch Products API

| 엔드포인트                                                                                                                                                       | Rate limit |
| :---------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- |
| [GET /product\_catalogs/:product\_catalog\_id/products](/x-ads-api/catalog-management/reference#get-product_catalogs%2Fproduct_catalog_id%2Fproducts)       | 15분당 1,000 |
| [PUT /product\_catalogs/:product\_catalog\_id/products](/x-ads-api/catalog-management/reference#put-product_catalogs%2Fproduct_catalog_id%2Fproducts)       | 15분당 600   |
| [DELETE /product\_catalogs/:product\_catalog\_id/products](/x-ads-api/catalog-management/reference#delete-product_catalogs%2Fproduct_catalog_id%2Fproducts) | 15분당 150   |

#### Product Sets

| 엔드포인트                                                                                                                                                                                                   | Rate limit |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------- |
| [GET /product\_catalogs/:product\_catalog\_id/product\_sets](/x-ads-api/catalog-management/reference#product-sets)                                                                                      | 15분당 2,000 |
| [POST /product\_catalogs/:product\_catalog\_id/product\_sets](/x-ads-api/catalog-management/reference#post-product_catalogs%2Fproduct_catalog_id%2Fproduct_sets)                                        | 15분당 100   |
| [PUT /product\_catalogs/:product\_catalog\_id/product\_sets/:product\_set\_id](/x-ads-api/catalog-management/reference#put-product_catalogs%2Fproduct_catalog_id%2Fproduct_sets%2Fproduct_set_id)       | 15분당 500   |
| [DELETE /product\_catalogs/:product\_catalog\_id/product\_sets/:product\_set\_id](/x-ads-api/catalog-management/reference#delete-product_catalogs%2Fproduct_catalog_id%2Fproduct_sets%2Fproduct_set_id) | 15분당 100   |

#### Scheduled Feeds

| 엔드포인트                                                                                                                                                                                                               | Rate limit |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------- |
| [GET /product\_catalogs/:product\_catalog\_id/scheduled\_feeds](/x-ads-api/catalog-management/reference#get-product_catalogs%2Fproduct_catalog_id%2Fscheduled_feeds)                                                | 15분당 1,000 |
| [POST /product\_catalogs/:product\_catalog\_id/scheduled\_feeds](/x-ads-api/catalog-management/reference#post-product_catalogs%2Fproduct_catalog_id%2Fscheduled_feeds)                                              | 15분당 20    |
| [PUT /product\_catalogs/:product\_catalog\_id/scheduled\_feeds/:scheduled\_feed\_id](/x-ads-api/catalog-management/reference#put-product_catalogs%2Fproduct_catalog_id%2Fscheduled_feeds%2Fscheduled_feed_id)       | 15분당 20    |
| [DELETE /product\_catalogs/:product\_catalog\_id/scheduled\_feeds/:scheduled\_feed\_id](/x-ads-api/catalog-management/reference#delete-product_catalogs%2Fproduct_catalog_id%2Fscheduled_feeds%2Fscheduled_feed_id) | 15분당 20    |

## 전체 API 참조

전체 참조(Product Catalogs, Products, Product Sets, Scheduled Feeds 엔드포인트)는 **[Catalog Management API Reference](/x-ads-api/catalog-management/reference)** 페이지를 참조하세요.
