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

# Referência da API de Gerenciamento de Catálogo

> Referência técnica completa para todos os endpoints de Catalog Management na X Ads API — Product Catalogs, Products, Product Sets e Scheduled Feeds.

## Referência da API

<Note>
  Esta é a referência técnica completa. Para uma visão geral de conceitos de Catalog Management, feeds de produtos e Dynamic Product Ads, consulte a{" "}
  <a href="/x-ads-api/catalog-management">Visão Geral de Catalog Management</a>.
</Note>

<Note type="warning">
  Estes endpoints estão atualmente disponíveis apenas por early-access. Para solicitar acesso, preencha <a href="https://docs.google.com/forms/d/1EbtgnfDjAaSYH_QkWq64eNl6cZM-snVuppjpxoBxWJ8/viewform?edit_requested=true">este formulário</a> ou entre em contato com seu representante do X.
</Note>

### Product Catalogs

<Button href="https://app.getpostman.com/run-collection/1d12b9fc623b8e149f87">
  Executar no Postman
</Button>

#### GET product\_catalogs

Recupera detalhes de alguns ou todos os catálogos de produtos associados ao usuário autenticado (padrão) ou ao usuário especificado no parâmetro `user_id`.

**URL do recurso**

`https://ads-api.x.com/12/product_catalogs`

<ParamField query="user_id" type="long" optional>
  Uma referência ao usuário com o qual você está operando na requisição. Use GET users/lookup para recuperar um user ID a partir de um screen name.
</ParamField>

**Exemplo de requisição**

```json theme={null}
GET https://ads-api.x.com/12/product_catalogs
```

**Exemplo de resposta**

```json title="Exemplo de resposta" lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null}
{
  "request": {
    "params": {}
  },
  "next_cursor": null,
  "data": [
    {
      "id": "1547080201384865792",
      "name": "Catalog Name"
    }
  ]
}
```

#### POST product\_catalogs

Cria um catálogo de produtos. Um usuário só pode criar um catálogo que armazena todos os produtos. Comerciantes do X precisam criar um catálogo antes de fazer upload de produtos.

**URL do recurso**

`https://ads-api.x.com/12/product_catalogs`

<ParamField query="name" type="string" required>
  Nome do seu catálogo de produtos.
</ParamField>

<ParamField query="user_id" type="long" optional>
  Uma referência ao usuário com o qual você está operando na requisição. Use GET users/lookup para recuperar um user ID a partir de um screen name.
</ParamField>

**Exemplo de requisição**

```json theme={null}
POST https://ads-api.x.com/12/product_catalogs?name=catalog_123_abc_def
```

**Exemplo de resposta**

```json theme={null}
{
  "request": {
    "params": {
      "name": "catalog_123_abc_def"
    }
  },
  "data": {
    "id": "1559934724822351872",
    "name": "catalog_123_abc_def"
  }
}
```

Esta referência técnica também cobre os endpoints PUT, DELETE para product\_catalogs, todos os endpoints de Products (GET, PUT, DELETE), Product Sets (GET, POST, PUT, DELETE) e Scheduled Feeds (GET, POST, PUT, DELETE). Para todos os detalhes técnicos, tabelas de parâmetros, atributos de request body em JSON e exemplos de respostas, consulte a versão em inglês em [/x-ads-api/catalog-management/reference](/x-ads-api/catalog-management/reference). Todos os nomes de parâmetros, endpoints, valores enum e estruturas JSON permanecem inalterados.