> For the complete documentation index, see [llms.txt](https://help.maisfy.com.br/maisfy-help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.maisfy.com.br/maisfy-help/ferramentas/api-publica.md).

# API Pública

Menu lateral → **Ferramentas** → **API Pública**.

Serve para **listar os seus produtos em outro lugar** — no seu site, numa landing page, numa loja própria — puxando os dados direto da Maisfy em vez de manter uma cópia à mão.

![Tela da API Pública](https://3344509428-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD0KchSWN381W9S4GFEfY%2Fuploads%2FYjdNJdKca8Rp0ekII2w3%2Fft-api.jpg?alt=media)

## Os dois conjuntos

| Conjunto               | Devolve                                    |
| ---------------------- | ------------------------------------------ |
| **Produtos**           | Os produtos que são seus                   |
| **Produtos Afiliados** | Os produtos que você promove como afiliado |

Há também a consulta de **um produto pelo ID**.

## Como usar

A própria tela **monta a URL para você**: escolha os parâmetros e o formato, e copie o endereço pronto.

| Parâmetro           | Para que                    |
| ------------------- | --------------------------- |
| `page`              | Número da página            |
| `perPage`           | Quantos itens por página    |
| `format`            | Filtrar por tipo de produto |
| `search`            | Buscar pelo nome            |
| `disablePagination` | Trazer tudo de uma vez      |

{% hint style="warning" %}
**É pública de verdade.** A URL leva o seu código e **não pede token** — quem tiver o endereço consegue listar os seus produtos. Isso é proposital, porque ela existe para alimentar site e vitrine. Mas não é lugar de dado sensível: ela devolve **catálogo**, não venda, cliente nem financeiro.
{% endhint %}

## Se você quer dados de venda

Aí não é aqui. Use o [Webhook](/maisfy-help/integracoes/webhooks.md), que avisa o seu sistema a cada pedido, ou o **MCP (IA)** para perguntar em linguagem natural.