> ## Documentation Index
> Fetch the complete documentation index at: https://developers.datafyapi.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão geral

> Como publicar no feed a partir da API.

Publicar é um processo de **duas etapas**. Não existe um endpoint único que receba o arquivo e publique.

**1. Criar o contêiner**

`POST /ig/me/media` recebe a URL do arquivo e a legenda, e devolve um `creation_id`. A Meta baixa o arquivo nesse momento.

**2. Publicar o contêiner**

`POST /ig/me/media_publish` recebe o `creation_id` e devolve o ID da publicação.

Entre as duas etapas, conteúdo de vídeo precisa ser processado. Veja [Consultar status](https://developers.datafyapi.com.br/api-reference/instagram/publicacoes/status.md).

## Origem do arquivo

Quem baixa o arquivo é a Meta, a partir da URL informada. Não há upload direto.

> [!WARNING]
>
> A URL precisa ser **pública e direta**. Endereços que respondem com redirecionamento, exigem autenticação ou bloqueiam o download falham.

## Tipos de publicação

| Tipo | `media_type` | Campo do arquivo |
| - | - | - |
| Imagem | omitido ou `IMAGE` | `image_url` |
| Reel | `REELS` | `video_url` |
| Story | `STORIES` | `image_url` ou `video_url` |
| Carrossel | `CAROUSEL` | `children` |

O carrossel tem um passo a mais: cada item é um contêiner próprio criado com `is_carousel_item: true`, e os IDs deles entram em `children`. São aceitos de 2 a 10 itens.

## Cota

A conta tem uma cota de publicações por período, consultável em [Consultar cota](https://developers.datafyapi.com.br/api-reference/instagram/publicacoes/cota.md):

```json theme={null}
{ "config": { "quota_total": 100, "quota_duration": 86400 }, "quota_usage": 1 }
```

O `quota_duration` vem em segundos, então 86400 corresponde a 24 horas. Contêiner criado e não publicado **não** consome a cota.

## Limitações

A API não permite editar nem excluir publicações. As duas operações existem apenas no aplicativo do Instagram.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.