> ## 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.

# Gestión de catálogos

> Configura catálogos de productos, gestiona productos de forma masiva, crea product sets para segmentación y configura feeds programados para Dynamic Product Ads en X.

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>;
};

**Gestiona de forma programática catálogos de productos, productos, product sets y feeds programados para Dynamic Product Ads.**

## Enlaces rápidos

* [Referencia completa de la API](/x-ads-api/catalog-management/reference) — Todos los endpoints y objetos de gestión de catálogos
* [Guía de especificaciones de productos](https://business.x.com/en/help/shopping-specs.html) — Requisitos detallados de los feeds de productos y buenas prácticas

## Descripción general

La Catalog API es una solución de comercio que ofrece a los anunciantes la capacidad de configurar feeds de productos, agrupar productos en sets y gestionar de forma integral los productos del catálogo. La Catalog API permite la gestión programática del catálogo y otorga a los anunciantes más control sobre cómo se ingieren y actualizan sus catálogos.

Un catálogo contiene todo lo relativo al producto y product set del usuario y está asociado al handle del usuario. **Actualmente, un usuario solo puede crear un catálogo.**

La Catalog API admite dos formas de ingerir productos:

1. **Scheduled Feed**: añade una URL de feed (CSV, TSV o XML) que se recuperará periódicamente. X admite archivos de hasta 8GB.
2. **Batch Products API**: consulta, crea, actualiza y elimina atributos de productos con solicitudes por lotes (JSON).

Los merchants de X pueden crear product sets basados en reglas de filtro. Esto permite adjuntar metadatos adicionales a los productos y crear product sets especiales para funcionalidades de comercio orgánico o Dynamic Product Ads. La Catalog API y X Shopping Manager admiten dos tipos de product sets:

1. **Manual**: selecciona hasta 50 productos y establece un nombre y una descripción.
2. **Filter**: añade hasta 30 filtros para generar sets automáticamente (precio, categoría de producto de Google, tipo de producto, inventario, precio en oferta, campos personalizados, etc.).

### Requisitos previos

Los endpoints de la Catalog API están disponibles actualmente solo mediante **acceso anticipado**. Para solicitar acceso, contacta con tu representante de X o rellena el formulario correspondiente.

Debes aceptar los términos del servicio a través del [X Shopping Manager](https://ads.x.com/shopping_manager).

Para especificaciones de productos y detalles de Shopping Manager, consulta la [Guía de especificaciones de productos](https://business.x.com/en/help/shopping-specs.html).

### Límites de uso

#### Product Catalog

| Endpoint                                                                                                                                | Límite de uso        |
| :-------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |
| [GET /product\_catalogs](/x-ads-api/catalog-management/reference#get-product_catalogs)                                                  | 1.000 por 15 minutos |
| [POST /product\_catalogs](/x-ads-api/catalog-management/reference#post-product_catalogs)                                                | 20 por 15 minutos    |
| [PUT /product\_catalogs/:product\_catalog\_id](/x-ads-api/catalog-management/reference#put-product_catalogs%2Fproduct_catalog_id)       | 20 por 15 minutos    |
| [DELETE /product\_catalogs/:product\_catalog\_id](/x-ads-api/catalog-management/reference#delete-product_catalogs%2Fproduct_catalog_id) | 20 por 15 minutos    |

#### Batch Products API

| Endpoint                                                                                                                                                    | Límite de uso        |
| :---------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |
| [GET /product\_catalogs/:product\_catalog\_id/products](/x-ads-api/catalog-management/reference#get-product_catalogs%2Fproduct_catalog_id%2Fproducts)       | 1.000 por 15 minutos |
| [PUT /product\_catalogs/:product\_catalog\_id/products](/x-ads-api/catalog-management/reference#put-product_catalogs%2Fproduct_catalog_id%2Fproducts)       | 600 por 15 minutos   |
| [DELETE /product\_catalogs/:product\_catalog\_id/products](/x-ads-api/catalog-management/reference#delete-product_catalogs%2Fproduct_catalog_id%2Fproducts) | 150 por 15 minutos   |

#### Product Sets

| Endpoint                                                                                                                                                                                                | Límite de uso        |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------- |
| [GET /product\_catalogs/:product\_catalog\_id/product\_sets](/x-ads-api/catalog-management/reference#product-sets)                                                                                      | 2.000 por 15 minutos |
| [POST /product\_catalogs/:product\_catalog\_id/product\_sets](/x-ads-api/catalog-management/reference#post-product_catalogs%2Fproduct_catalog_id%2Fproduct_sets)                                        | 100 por 15 minutos   |
| [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)       | 500 por 15 minutos   |
| [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) | 100 por 15 minutos   |

#### Scheduled Feeds

| Endpoint                                                                                                                                                                                                            | Límite de uso        |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------- |
| [GET /product\_catalogs/:product\_catalog\_id/scheduled\_feeds](/x-ads-api/catalog-management/reference#get-product_catalogs%2Fproduct_catalog_id%2Fscheduled_feeds)                                                | 1.000 por 15 minutos |
| [POST /product\_catalogs/:product\_catalog\_id/scheduled\_feeds](/x-ads-api/catalog-management/reference#post-product_catalogs%2Fproduct_catalog_id%2Fscheduled_feeds)                                              | 20 por 15 minutos    |
| [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)       | 20 por 15 minutos    |
| [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) | 20 por 15 minutos    |

## Referencia completa de la API

Para consultar la referencia completa (endpoints de Product Catalogs, Products, Product Sets y Scheduled Feeds), consulta la página **[Referencia de la API de gestión de catálogos](/x-ads-api/catalog-management/reference)**.
