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

# Visualizar Catálogo

> GET /api/hub/catalogs/{catalogId}/preview — primeiros 10 produtos e estatísticas, sem necessidade de clonar.

## Endpoint

```
GET /api/hub/catalogs/{catalogId}/preview
```

Retorna uma amostra dos primeiros 10 produtos do catálogo mais estatísticas resumidas. Endpoint público — não é necessário clonar ou assinar para visualizar.

***

## Parâmetros de path

| Parâmetro   | Tipo   | Obrigatório | Descrição             |
| ----------- | ------ | :---------: | --------------------- |
| `catalogId` | string |     Sim     | ID do catálogo do Hub |

***

## Resposta

```json theme={null}
{
  "catalog": {
    "id": "hub_cat_9x8k2m",
    "name": "Coleção Primavera 2026",
    "productCount": 512,
    "avgScore": 78,
    "categories": ["vestuário masculino", "vestuário feminino"],
    "topBrands": ["BrandA", "BrandB", "BrandC"],
    "publisher": {
      "displayName": "EuroFashion Wholesale",
      "verified": true
    }
  },
  "sampleProducts": [
    {
      "id": "prod_abc",
      "title": "Camiseta de Algodão Orgânico",
      "sku": "CT-001",
      "price": 29.99,
      "currency": "BRL",
      "imageUrl": "https://cdn.example.com/img/ct-001.jpg",
      "score": 85,
      "categoryPath": "Vestuário > Camisetas"
    }
  ]
}
```

***

## Exemplos

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://app.alana.shopping/api/hub/catalogs/hub_cat_9x8k2m/preview"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    `https://app.alana.shopping/api/hub/catalogs/${catalogId}/preview`
  );
  const { catalog, sampleProducts } = await response.json();
  console.log(`${catalog.productCount} produtos — score médio: ${catalog.avgScore}`);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      f"https://app.alana.shopping/api/hub/catalogs/{catalog_id}/preview"
  )
  data = response.json()
  print(f"Catálogo: {data['catalog']['name']} — {data['catalog']['productCount']} produtos")
  ```
</CodeGroup>