A API v5 do Pinterest cria pins para você, incluindo pins de vídeo, mas só depois que seu app passa por uma revisão. Até lá, seu app fica em acesso de teste, onde cada pin e quadro criado é uma entidade de sandbox visível apenas para quem a criou. Esse único fato decide se a API é útil para você, então ele fica no topo em vez de escondido numa seção sobre escopos.
O que a API do Pinterest consegue publicar de verdade?
Ela cria pins em quadros pertencentes à conta autenticada: pins de imagem e pins de vídeo, com título, descrição e link de destino. É uma API de publicação, não de navegação, e é restrita a contas que autorizaram seu app.
As lacunas que importam para uma avaliação:
| Restrição | O que isso significa para você |
|---|---|
| O acesso de teste é o nível padrão | Os pins e quadros que seu app cria são entidades de sandbox, visíveis apenas para quem os criou |
| O acesso padrão exige revisão | Você envia uma gravação de vídeo do seu app usando a API, incluindo o fluxo OAuth |
| Pins de vídeo precisam de uma etapa separada de upload | Os bytes do vídeo passam por um registro de mídia e um fluxo de upload antes da chamada de criação do pin |
| Os limites de taxa diferem por nível | O teste é medido por dia por app, o padrão por minuto por usuário por app |
Então uma ferramenta interna que você usa na sua própria conta pode viver indefinidamente no acesso de teste. Um produto que publica em nome de clientes não pode, porque pins de teste nunca ficam visíveis.
Nota: os dados aqui foram verificados no developers.pinterest.com em setembro de 2026. As plataformas mudam isso sem aviso.
O que a revisão de app do Pinterest exige, e quanto tempo leva?
Você registra um app, é aprovado para acesso de teste, depois solicita o upgrade para o padrão. A documentação do Pinterest declara que o upgrade exige que seu app já tenha aprovação de teste, esteja em conformidade com as Diretrizes para Desenvolvedores, e que você envie uma gravação de vídeo do seu app completando uma ação por meio da API do Pinterest, com o fluxo de autenticação do usuário visível na gravação. Gravações de tela de chamadas via terminal ou Postman são formatos aceitos.
O motivo de rejeição mais comum citado pelo Pinterest é uma demonstração que não mostra o fluxo OAuth, ou que não mostra a integração ao vivo com o Pinterest dentro da aplicação.
Quanto à duração: o Pinterest diz que os pedidos de upgrade para o padrão são “revisados regularmente” e que você é notificado por e-mail quando uma decisão é tomada. Sugere que se conte alguns dias. Nenhum prazo específico é publicado, então trate qualquer número preciso que você ler em outro lugar como um chute. Planeje sua data de lançamento em torno de uma incerteza, não de um SLA prometido.
O modelo de autenticação em si é o OAuth 2.0 comum: redirecione o usuário para o Pinterest, troque o código por um token de acesso e um token de atualização, armazene os dois por conta, atualize antes do vencimento. Nada exótico. A parte exótica é a barreira de revisão na frente disso.
Qual é a sequência real para criar um pin?
Para um pin de imagem vindo de uma URL pública, é uma única chamada. Para um pin de vídeo são quatro etapas, porque os bytes precisam ser registrados, enviados e processados antes que um pin possa referenciá-los.
- Registre o upload de mídia.
POST /v5/mediacom o tipo de mídia. A resposta traz um identificador de mídia, uma URL de upload e um conjunto de parâmetros de formulário. - Envie os bytes. Faça um
POSTde um formulário multipart para essa URL de upload, enviando os parâmetros retornados como campos de formulário primeiro e o arquivo por último. É um post de formulário pré-assinado no estilo S3, não um endpoint do Pinterest, então as respostas de erro são XML em vez de JSON. - Consulte o status da mídia. Leia o registro de mídia de volta até o processamento ser bem-sucedido. Um upload retornando 2xx não significa que o vídeo esteja utilizável.
- Crie o pin.
POST /v5/pinsreferenciando a mídia processada, além do quadro, título, descrição e link.
# 1. register
curl -X POST https://api.pinterest.com/v5/media \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"media_type":"video"}'
# 2. upload the bytes to the returned upload_url,
# sending every returned upload parameter as a form field first
curl -X POST "$UPLOAD_URL" \
-F key="$KEY" -F policy="$POLICY" -F "x-amz-signature=$SIG" \
-F file=@clip.mp4
# 3. poll until the media reports a succeeded status
# 4. create the pin referencing that media idNota: não conseguimos verificar os nomes exatos dos campos de requisição e resposta de
POST /v5/mediaouPOST /v5/pinsna referência oficial da API do Pinterest: essas páginas renderizam o conteúdo no lado do cliente e não retornaram texto de documentação ao serem buscadas. Leia a referência de API ao vivo no developers.pinterest.com antes de codificar contra elas, e trate os nomes de campos acima como o formato do fluxo, não como um esquema copiável.
A etapa que as pessoas pulam é a terceira. Um pin de vídeo também precisa de uma imagem de capa, que é um segundo recurso a produzir e validar. Não conseguimos confirmar o requisito exato da capa em uma página de referência v5 acessível, então verifique isso na documentação atual antes de construir em torno dela. Se você está dimensionando imagens para qualquer um dos dois tipos de pin, nosso guia de tamanhos de pin do Pinterest tem as dimensões atuais.
Quais são os limites de taxa da API do Pinterest?
Os limites publicados diferem bastante por nível, mais um motivo pelo qual o acesso de teste não é uma prévia do comportamento em produção.
| Nível | Limite documentado |
|---|---|
| Teste | 1.000 requisições por dia para todas as requisições de API, aplicadas por app |
| Padrão | 100 requisições por segundo por usuário por app para todas as requisições de API |
Categorias individuais de endpoint carregam seus próprios limites mais estreitos, além do limite universal: leitura, escrita, análises e conversões têm cada uma seu próprio orçamento, e a própria documentação do Pinterest observa que todos os limites de taxa estão sujeitos a mudança sem aviso. Verifique a categoria atribuída a cada endpoint que você chama em vez de assumir que o número universal se aplica.
Nota: os dados aqui foram verificados no developers.pinterest.com em setembro de 2026. As plataformas mudam isso sem aviso.
O que realmente vai custar três semanas
Não é a chamada do pin. A chamada do pin é coisa de uma tarde. As três semanas estão aqui:
- A revisão. Você não pode lançar para clientes em acesso de teste, e não há prazo publicado. Envie cedo, e envie uma gravação que mostre claramente o fluxo OAuth, porque esse é o modo de falha citado.
- Atualização de token. Tokens de atualização expiram e revogações acontecem silenciosamente. Você precisa de um token de atualização armazenado por conta conectada, um processo que renova antes do vencimento, e um estado de “reconectar esta conta” na sua interface. Construir isso depois que o token do primeiro cliente morre é a ordem cara de fazer as coisas.
- Transcodificação de mídia. Pins de vídeo significam aceitar o que quer que um usuário envie, normalizar codec e contêiner, gerar uma imagem de capa, e armazenar o resultado em algum lugar de onde a etapa de upload possa transmitir. Isso é um pipeline de mídia, não uma integração de API.
- Tratamento de falhas assíncronas. Um 2xx do upload pré-assinado significa que os bytes chegaram. Não significa que o vídeo foi processado, e não significa que um pin existe. Você precisa de um verificador de status, uma política de repetição que diferencie falhas transitórias de permanentes, e um estado de publicação que possa ser
processing, não apenas publicado ou falho. Escrevemos sobre esse modelo de estado no guia da API de agendamento de redes sociais.
Multiplique tudo isso por cada plataforma que você adicionar. Essa é a forma real da construção. A comparação entre construir e comprar coloca números nisso.
A versão resumida
- O acesso de teste é o padrão e produz pins de sandbox visíveis apenas para quem os criou. O acesso padrão exige uma revisão com uma demonstração em vídeo do fluxo OAuth. Nenhum prazo é publicado.
- Pins de imagem a partir de uma URL pública são uma única chamada. Pins de vídeo são registrar, enviar, consultar, criar, mais uma imagem de capa.
- O teste é limitado a 1.000 requisições por dia por app. O padrão é 100 requisições por segundo por usuário por app, com limites mais estreitos por categoria por baixo disso.
- O custo de engenharia é revisão, atualização de token, transcodificação e tratamento de falhas assíncronas, não a chamada de publicação.
Fazendo isso uma vez em vez de uma vez por plataforma
Se o Pinterest é uma das várias redes que você precisa, o trabalho por plataforma acima se repete com formatos diferentes a cada vez: barreiras de revisão diferentes, fluxos de mídia diferentes, modelos de cota diferentes. É isso que nossa API existe para absorver. O BulkPublish publica em 15 plataformas por meio de um único endpoint REST e um único modelo de post, com o OAuth, a atualização de token, o tratamento de mídia e o rastreamento de status assíncrono do nosso lado.
A documentação para desenvolvedores e a página de integração da API REST cobrem os endpoints e o ciclo de vida do post. Se você preferir agendar pins por uma interface em vez de codificar contra qualquer uma das duas APIs, como agendar pins no Pinterest cobre esse caminho, e o contador de caracteres do Pinterest gratuito mantém seus títulos e descrições dentro dos limites.