API de Pinterest

Qué cubre la API de Pinterest

Todo lo que aparece abajo forma parte de la API publicada y funciona hoy con Pinterest.

Tipos de publicación que puedes enviar a Pinterest

Elige el tipo con postTypeOverrides. Un tipo que Pinterest no ofrece se rechaza antes de poner nada en cola.

Programa una publicación de Pinterest con curl

Tres solicitudes: busca tu canal, sube el archivo si la publicación lo lleva y crea la publicación. Sustituye la clave por una de Ajustes, luego Claves de API, y 12 por el id de tu propio canal.

1. Lista tus canales y anota el id de tu cuenta de Pinterest.

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

2. Sube el archivo. La respuesta te da el id del archivo, que se usa como mediaFiles más abajo.

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

3. Crea la publicación.

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"
    }
  }
}'

La respuesta es la publicación creada, con su id y su estado. Consúltala más tarde con GET /api/posts/{id} para ver cómo fue.

Opciones de Pinterest

Envía estas opciones dentro de platformSpecific, bajo la clave de Pinterest.

En Pinterest las opciones se indican por el id de tu canal, por ejemplo "12", o se envían sin anidar para aplicarlas a todos los canales de Pinterest de la publicación.

Para ver los tableros válidos de un canal, llama a GET /api/channels/{id}/options.

Analíticas de Pinterest con la API

Estas métricas se devuelven para cada publicación de Pinterest en GET /api/posts/{id}/metrics, con instantáneas a lo largo del tiempo.

• Impresiones
• Clics
• Guardados
• Reproducciones
• Me gusta
• Comentarios
• Tasa de interacción

Comentarios y mensajes

BulkPublish no lee comentarios ni mensajes de Pinterest, así que aquí no hay nada que listar ni responder.

Acceso a la API en todos los planes

Todos los planes incluyen claves de API, también el plan Free. Esto es lo que permite cada uno.

Integra Pinterest directamente o usa BulkPublish

Ir directo es una opción razonable, sobre todo si necesitas algo que BulkPublish no ofrece. Esto es lo que te pide Pinterest API v5, según su documentación consultada en octubre de 2026.

• Antes de publicar tienes que registrar una app de desarrollador en Pinterest.
• Los tokens de acceso duran unos 30 días, así que necesitas tu propia forma de renovarlos o reconectar antes de que caduquen.

BulkPublish mantiene la conexión por ti: renueva los tokens, comprueba cada publicación con las reglas de Pinterest antes de ponerla en cola e informa de un destino fallido en la propia publicación, así que tu código hace una sola solicitud.

Lee la documentación oficial

¿Prefieres pedírselo a un asistente?

Claude, ChatGPT y Cursor pueden hacer lo mismo con el servidor MCP de Pinterest, con instrucciones en lugar de código.

Ver el servidor MCP de Pinterest

¿Prefieres un calendario a código?

La misma cuenta de Pinterest se puede programar desde la app, con un calendario de contenido y subida en masa.

Ver el programador de Pinterest

Preguntas frecuentes

Dudas habituales sobre la API de Pinterest.

Otras redes

La misma clave y el mismo formato de solicitud sirven para 15 redes.

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

Ver la API de cada red

Empieza a publicar en Pinterest desde código

Crea una cuenta gratis, conecta Pinterest y genera una clave. Sin tarjeta.

Consigue una clave de API gratis Ver precios