Adicionar conteúdo a uma lista automática usando a API

Atualizado há 2 meses

Você pode adicionar conteúdo a uma lista automática existente pela API com duas chamadas: primeiro, crie um espaço vazio na lista e, depois, preencha esse espaço com o texto e a mídia da sua publicação. Isso funciona com qualquer cliente HTTP, incluindo Postman, Make, n8n ou Zapier.

Pré-requisitos

As duas chamadas precisam do seu userToken, userId, blogId e do ID interno da lista automática.

Valor	Onde encontrar
`userToken`	Configurações da conta > seção API > Token de acesso à API REST. Envie-o no cabeçalho da solicitação `X-Mc-Auth`.
`userId`	Seu identificador de usuário do Metricool. Veja Como encontrar seu ID de usuário do Metricool.
`blogId`	O identificador da marca/perfil, visível na URL do navegador ao usar essa marca no Metricool.
`listid`	O ID interno da lista automática. Ele nem sempre corresponde ao ID exibido na URL do planejador (`/planner/autolist/{X}`) — confirme-o na resposta da chamada da etapa 1 em vez de presumir qual é.

Adicionar conteúdo à lista automática

Criar um espaço vazio

Criar um espaço reserva uma posição na lista automática. A resposta é o array completo da lista automática, incluindo o id do novo item — use esse valor como postid na próxima etapa.

GET https://app.metricool.com/api/lists/posts/create?listid={listId}&position={position}&userId={userId}&blogId={blogId}

Campo	Descrição
`listid`	O ID interno da lista automática.
`position`	Onde inserir a nova publicação. `0` insere a publicação no topo da lista.

Cada chamada para este endpoint adiciona uma nova linha vazia à lista automática, mesmo que você não conclua a próxima etapa. Chamadas repetidas acumulam linhas vazias — remova-as da lista automática usando Excluir tudo no planejador do Metricool.

Preencher o espaço com conteúdo

Envie esta chamada como form-data, não como JSON.

POST https://app.metricool.com/api/lists/posts/updatepostlist?userId={userId}&blogId={blogId}

Campo	Valor
`listid`	O ID interno da lista automática.
`text`	O conteúdo de texto da publicação.
`postid`	O `id` retornado na etapa anterior.
`pictures`	Arquivo de imagem ou vídeo da publicação. Quando não houver imagem, envie `[]` — um valor em branco/vazio salva o texto, mas faz o restante da solicitação falhar silenciosamente.

Solução de problemas

500 InternalError: "Request method 'POST' is not supported"

Você chamou /api/lists/posts/create com POST. Este endpoint aceita apenas GET — altere o método da solicitação para GET e mantenha os mesmos parâmetros de consulta.

A solicitação funciona, mas a publicação não fica como esperado

Se pictures foi enviado em branco/vazio em vez de [], a chamada retorna sucesso e salva o text, mas o restante da atualização falha silenciosamente. Reenvie com pictures definido como [] quando não houver imagem.

Conteúdo relacionado: Como obter um endpoint no Metricool para fazer chamadas à API e Perguntas e erros comuns ao usar a API.

Isso foi útil?