API do Pinterest

O que a API do Pinterest cobre

Tudo abaixo faz parte da API publicada e já funciona com o Pinterest.

Tipos de post que você pode publicar no Pinterest

Escolha o tipo com postTypeOverrides. Um tipo que o Pinterest não oferece é recusado antes de qualquer coisa entrar na fila.

Agende um post do Pinterest com curl

Três requisições: encontre seu canal, envie o arquivo se o post tiver um e crie o post. Troque a chave por uma de Configurações, depois Chaves de API, e o 12 pelo id do seu próprio canal.

1. Liste seus canais e anote o id da sua conta do Pinterest.

curl https://app.bulkpublish.com/api/channels \
  -H "Authorization: Bearer bp_your_key_here"

2. Envie o arquivo. A resposta traz o id da mídia, usado como mediaFiles abaixo.

curl -X POST https://app.bulkpublish.com/api/media \
  -H "Authorization: Bearer bp_your_key_here" \
  -F "file=@photo.jpg"

3. Crie o post.

curl -X POST https://app.bulkpublish.com/api/posts \
  -H "Authorization: Bearer bp_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "A 20 minute pasta for busy evenings",
  "channels": [{ "channelId": 12 }],
  "status": "scheduled",
  "scheduledAt": "2026-12-01T09:00:00Z",
  "mediaFiles": [101],
  "platformSpecific": {
    "pinterest": {
      "12": {
        "boardId": "BOARD_ID"
      },
      "title": "Weeknight pasta",
      "link": "https://example.com/pasta"
    }
  }
}'

A resposta é o post criado, com seu id e status. Busque-o depois com GET /api/posts/{id} para ver como foi.

Opções do Pinterest

Envie estas opções dentro de platformSpecific, na chave do Pinterest.

No Pinterest, as opções são indexadas pelo id do seu canal, por exemplo "12", ou enviadas soltas para valer para todos os canais do Pinterest no post.

Para descobrir quadros válidos de um canal, chame GET /api/channels/{id}/options.

Análises do Pinterest pela API

Estas métricas voltam para cada post do Pinterest em GET /api/posts/{id}/metrics, com registros ao longo do tempo.

• Impressões
• Cliques
• Salvamentos
• Visualizações de vídeo
• Curtidas
• Comentários
• Taxa de engajamento

Comentários e mensagens

O BulkPublish não lê comentários nem mensagens do Pinterest, então não há nada para listar ou responder aqui.

Acesso à API em todos os planos

Todos os planos incluem chaves de API, inclusive o Free. Veja o que cada um permite.

Construir direto no Pinterest ou usar o BulkPublish

Ir direto é uma escolha válida, principalmente se você precisa de algo que o BulkPublish não oferece. Isto é o que Pinterest API v5 exige de você, conferido com a documentação em outubro de 2026.

• Você precisa registrar um app de desenvolvedor no Pinterest antes de poder publicar.
• Os tokens de acesso duram cerca de 30 dias, então você precisa de um jeito próprio de renová-los ou reconectar antes que expirem.

O BulkPublish cuida da conexão por você: renova os tokens, confere cada post com as regras do Pinterest antes de entrar na fila e informa no post qual destino falhou, então seu código faz uma única requisição.

Ler a documentação oficial

Prefere pedir a um assistente?

Claude, ChatGPT e Cursor fazem o mesmo pelo servidor MCP do Pinterest, com comandos em vez de código.

Ver o servidor MCP do Pinterest

Prefere um calendário a código?

A mesma conta do Pinterest pode ser agendada pelo app, com calendário de conteúdo e envio em massa.

Ver o agendador do Pinterest

Perguntas frequentes

Dúvidas comuns sobre a API do Pinterest.

Outras redes

A mesma chave e o mesmo formato de requisição funcionam em 15 redes.

• Facebook
• Instagram
• X / Twitter
• TikTok
• YouTube
• Threads
• Bluesky
• Google Business
• LinkedIn
• Mastodon
• Discord
• Telegram
• Tumblr
• Snapchat

Ver as APIs de todas as redes

Comece a publicar no Pinterest pelo código

Crie uma conta grátis, conecte o Pinterest e gere uma chave. Sem cartão.

Obter uma chave de API grátis Ver preços