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

# Gerenciamento de Catálogo

> Configure catálogos de produtos, gerencie produtos em lote, crie product sets para segmentação e configure scheduled feeds para Dynamic Product Ads no 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>;
};

**Gerencie catálogos de produtos, produtos, product sets e scheduled feeds programaticamente para Dynamic Product Ads.**

## Links rápidos

* [Referência completa da API](/x-ads-api/catalog-management/reference) — Todos os endpoints e objetos do Catalog Management
* [Guia de especificações de produtos](https://business.x.com/en/help/shopping-specs.html) — Requisitos detalhados de feeds de produtos e melhores práticas

## Visão geral

A Catalog API é uma solução de commerce que dá aos anunciantes a capacidade de configurar feeds de produtos, agrupar produtos em conjuntos e gerenciar produtos de catálogo de forma holística. A Catalog API permite o gerenciamento programático de catálogos e concede aos anunciantes mais controle sobre como seus catálogos são ingeridos e atualizados.

Um catálogo armazena tudo relacionado aos produtos e product set do usuário e está associado ao handle do usuário. **Atualmente, um usuário só pode criar um catálogo.**

A Catalog API suporta duas formas de ingerir produtos:

1. **Scheduled Feed**: Adicione uma URL de feed (CSV, TSV ou XML) que será buscada periodicamente. O X suporta arquivos de até 8GB.
2. **Batch Products API**: Visualize, crie, atualize e exclua atributos de produto com requisições em lote (JSON).

Comerciantes do X podem criar product sets baseados em regras de filtragem. Isso permite anexar metadados adicionais aos produtos e criar product sets especiais para recursos de commerce orgânico ou Dynamic Product Ads. A Catalog API e o X Shopping Manager suportam dois tipos de product sets:

1. **Manual**: Selecione até 50 produtos e defina um nome e descrição.
2. **Filter**: Adicione até 30 filtros para gerar sets automaticamente (preço, categoria de produto do Google, tipo de produto, inventário, preço promocional, campos personalizados, etc.).

### Pré-requisitos

Os endpoints da Catalog API estão atualmente disponíveis apenas por **acesso antecipado**. Para solicitar acesso, entre em contato com seu representante do X ou preencha o formulário apropriado.

Você deve aceitar os termos de serviço no [X Shopping Manager](https://ads.x.com/shopping_manager).

Para especificações de produtos e detalhes do Shopping Manager, consulte o [Guia de especificações de produtos](https://business.x.com/en/help/shopping-specs.html).

### Rate Limits

#### Product Catalog

| Endpoint                                                                                                                                | Rate limit           |
| :-------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |
| [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                                                                                                                                                    | Rate limit           |
| :---------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |
| [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                                                                                                                                                                                                | Rate limit           |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------- |
| [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                                                                                                                                                                                                            | Rate limit           |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------- |
| [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    |

## Referência completa da API

Para a referência completa (endpoints de Product Catalogs, Products, Product Sets e Scheduled Feeds), consulte a página **[Referência da API de Catalog Management](/x-ads-api/catalog-management/reference)**.
