Publica pines, lista y gestiona tableros, y consulta las métricas de tus pines a través de la misma API unificada que ya usas para todas las demás plataformas. Conecta una cuenta una sola vez con OAuth, indica un tablero en el target y el resto de tu código de publicación no cambia. Pinterest no tiene comentarios, DMs ni menciones que leer: es una superficie de publicación, y esta página lo dice claramente en lugar de insinuar una bandeja de entrada que no existe.
Crea un pin en Pinterest
1# 1. Lista los tableros de la cuenta para elegir uno
2curl https://api.social-api.ai/v1/accounts/<id-de-cuenta-pinterest>/boards \
3 -H "Authorization: Bearer <tu-api-key>" | jq
4
5# 2. Crea el pin en uno de ellos
6curl -X POST https://api.social-api.ai/v1/posts \
7 -H "Authorization: Bearer <tu-api-key>" \
8 -H "Content-Type: application/json" \
9 -d '{
10 "title": "Pollo asado entre semana",
11 "text": "Una sola bandeja, cuarenta minutos, sin marinar.",
12 "targets": [{
13 "account_id": "<id-de-cuenta-pinterest>",
14 "board_id": "<id-de-tablero>",
15 "media": [{ "source_type": "url", "source": "https://example.com/pollo.jpg", "type": "image" }]
16 }]
17 }' | jq
El mismo endpoint POST /v1/posts que ya usas para todas las demás plataformas. Un target de Pinterest indica el tablero donde va el pin y lleva exactamente una imagen.
Crea pines con la misma llamada POST /v1/posts que en cualquier otra plataforma. Cada target indica un tablero y lleva una imagen.
Lista, crea, renombra y elimina tableros con /v1/accounts/:id/boards. Los tableros se consultan en vivo a Pinterest en cada lectura, nunca se almacenan en caché.
Un pin necesita un tablero y una imagen. No hay tablero por defecto ni pin solo de texto: cada target de Pinterest lleva un board_id y una imagen, y un borrador al que le falte cualquiera de los dos se rechaza antes de llegar a Pinterest.
Los pines publicados no se pueden editar. El endpoint de edición de Pinterest sigue en su propia beta y, en cualquier caso, el medio de un pin es inmutable, así que cambiar un pin significa eliminarlo y crear uno nuevo, lo que genera un id de pin nuevo.
Pinterest no tiene comentarios, DMs, menciones ni reseñas en su API pública, así que esos endpoints devuelven 501 para una cuenta de Pinterest en lugar de una lista vacía. La bandeja de entrada está genuinamente vacía para esta plataforma, y el 501 lo dice sin rodeos.
Pinterest no envía webhooks propios. Los resultados de publicación sí llegan a tu endpoint de webhook porque esos eventos son nuestros, pero no llega nada cuando alguien interactúa con un pin en Pinterest.
Eliminar un tablero elimina todos sus pines, y Pinterest no lo deshace. La API expone la llamada; las consecuencias son de Pinterest.
Los límites de la plataforma aparecen como un 429 y no consumen tu cuota de SocialAPI.ai. Reintenta con backoff en lugar de tratarlo como una escritura fallida.
Un pin de Pinterest sale por la misma petición POST /v1/posts que Instagram, LinkedIn o Threads. El target indica un tablero y lleva una imagen, el título del post se convierte en el título del pin y el texto en su descripción. La programación, los reintentos y el webhook de publicación funcionan exactamente igual que en el resto, porque son nuestros y no de Pinterest.
Lista, crea, renombra y elimina tableros con /v1/accounts/:id/boards sin escribir una línea de HTTP específico de Pinterest. Cada lectura va en vivo a Pinterest y no a una caché nuestra, así que la lista de tableros que recibes es la que la cuenta tiene de verdad, incluido un tablero que alguien creó en la app de Pinterest hace un segundo.
Los Términos para Desarrolladores de Pinterest prohíben almacenar la información obtenida a través de su API, así que no lo hacemos: los tableros se consultan en cada llamada y se conservan solo mientras dura la petición. No hay caché que quede obsoleta, ni proceso de sincronización que se retrase, ni nada tuyo en nuestra base de datos esperando a estar equivocado.
Los pines regresan en el mismo esquema unificado de posts que cualquier otra plataforma y fallan con los mismos códigos HTTP: 401 para una credencial muerta, 429 cuando Pinterest te limita, 501 para algo que Pinterest no admite. Pinterest es un destino nuevo para código que ya escribiste, no una segunda integración que mantener.
Los access tokens de Pinterest caducan a los treinta días y los refresh tokens a los sesenta. Los renovamos en segundo plano antes de que expiren y mantenemos la cuenta activa, así que una conexión hecha una vez sigue funcionando sin que aparezca un aviso de reconexión delante de tu usuario.
Leer comentarios, DMs y menciones es gratis e ilimitado en todos los planes. Los planes de pago comienzan en $29/mes con posts e interacciones ilimitados. El nivel gratuito no requiere tarjeta de crédito.
FAQ
Sí. La API v5 de Pinterest cubre pines y tableros, y SocialAPI.ai la expone a través de la misma API REST que todas las demás plataformas, así que creas un pin con la misma petición que usas para publicar en Instagram o LinkedIn.
Sí. Envía una petición POST /v1/posts con una cuenta de Pinterest en el array targets, un board_id en ese target y una imagen. El título del post se convierte en el título del pin y el texto en su descripción.
No. La API pública de Pinterest no expone endpoints de comentarios, así que no hay nada que podamos leer. Esas llamadas devuelven 501 para una cuenta de Pinterest en lugar de fingir que la bandeja está vacía. Si hoy necesitas moderación de comentarios, Instagram, Facebook, YouTube, TikTok, Threads, X, Bluesky y LinkedIn la admiten con los mismos endpoints.
Con /v1/accounts/:id/boards: listar, crear, renombrar y eliminar. Cada lectura va en vivo a Pinterest y no a una caché, porque los Términos para Desarrolladores de Pinterest prohíben almacenar lo que obtienes de su API.
Con OAuth, una vez por cuenta, el mismo flujo que en todas las demás plataformas. No necesitas tu propia app de desarrollador de Pinterest: la conexión pasa por la de SocialAPI.ai, y renovamos el token en segundo plano antes de que expire.
No. El endpoint de edición de Pinterest sigue en su propia beta y el medio del pin es inmutable de todos modos, así que cambiar un pin publicado significa eliminarlo y crear uno nuevo. El pin nuevo recibe un id nuevo.
Sí. El servidor MCP integrado expone la publicación y la gestión de tableros como herramientas, así que Claude y otros agentes compatibles con MCP pueden preparar pines y elegir tableros dentro de tu flujo de aprobación actual.
Empieza hoy
Nivel gratuito disponible · Sin tarjeta de crédito · Incluye servidor MCP
We use essential cookies for security, and analytics cookies with your consent. Privacy Policy.