La API de Pinterest para pines y tableros
Crea pines y gestiona tableros de Pinterest desde una sola API.
- Nivel gratuito, sin tarjeta
- API key al instante
- Servidor MCP incluido

Llegaron las nuevas bajas blancas. En tienda el sábado, todas las tallas.
Ledge Skate & Shoe
Guardado en Novedades
/v1/posts201 CreatedCapacidades: Lo que puedes construir en Pinterest
Cada capacidad es un endpoint, el mismo que llamas en todas las demás plataformas.Las pantallas muestran dónde llega cada llamada.
Publicación
Crea pines con la misma llamada POST /v1/posts que en cualquier otra plataforma. Cada target indica un tablero y lleva una imagen.
- POST
/v1/posts - GET
/v1/posts/validate
- pin en un tablero
- una imagen
- POST
Tableros
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é.
- GET
/v1/accounts/{id}/boards - POST
/v1/accounts/{id}/boards
- listar
- crear
- renombrar
- eliminar
- GET
En todas las plataformas
Listo para agentes
Cada capacidad de Pinterest es una herramienta tipada del servidor MCP de SocialAPI.ai.
- social_api_validate_post
- social_api_create_post
Una sola API key
La key que llama a Pinterest llama a las 13 plataformas.
Authorization: Bearer sapi_key_…Errores predecibles
Los mismos códigos de estado en todas partes, sin importar la plataforma detrás.
- 401token expirado
- 429límite de tasa
- 501no disponible en esta plataforma
Llama a la API de Pinterest
Crea un pin en Pinterest
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.
# 1. Lista los tableros de la cuenta para elegir uno
curl https://api.social-api.ai/v1/accounts/<id-de-cuenta-pinterest>/boards \
-H "Authorization: Bearer <tu-api-key>" | jq
# 2. Crea el pin en uno de ellos
curl -X POST https://api.social-api.ai/v1/posts \
-H "Authorization: Bearer <tu-api-key>" \
-H "Content-Type: application/json" \
-d '{
"title": "Pollo asado entre semana",
"text": "Una sola bandeja, cuarenta minutos, sin marinar.",
"targets": [{
"account_id": "<id-de-cuenta-pinterest>",
"board_id": "<id-de-tablero>",
"media": [{ "source_type": "url", "source": "https://example.com/pollo.jpg", "type": "image" }]
}]
}' | jqimport requests
AUTH = {"Authorization": "Bearer <tu-api-key>"}
# Los tableros se consultan en vivo a Pinterest, así que pídelos cuando los necesites.
boards = requests.get(
"https://api.social-api.ai/v1/accounts/<id-de-cuenta-pinterest>/boards",
headers=AUTH,
).json()["data"]
resp = requests.post(
"https://api.social-api.ai/v1/posts",
headers=AUTH,
json={
"title": "Pollo asado entre semana",
"text": "Una sola bandeja, cuarenta minutos, sin marinar.",
"targets": [{
"account_id": "<id-de-cuenta-pinterest>",
"board_id": boards[0]["id"],
"media": [{
"source_type": "url",
"source": "https://example.com/pollo.jpg",
"type": "image",
}],
}],
},
)
print(resp.json()) # { "id": "...", "status": "published", ... }const auth = { Authorization: "Bearer <tu-api-key>" };
const boardsRes = await fetch(
"https://api.social-api.ai/v1/accounts/<id-de-cuenta-pinterest>/boards",
{ headers: auth },
);
const { data: boards } = await boardsRes.json();
const res = await fetch("https://api.social-api.ai/v1/posts", {
method: "POST",
headers: { ...auth, "Content-Type": "application/json" },
body: JSON.stringify({
title: "Pollo asado entre semana",
text: "Una sola bandeja, cuarenta minutos, sin marinar.",
targets: [{
account_id: "<id-de-cuenta-pinterest>",
board_id: boards[0].id,
media: [{ source_type: "url", source: "https://example.com/pollo.jpg", type: "image" }],
}],
}),
});
console.log(await res.json());En detalle: Cómo funciona la API de Pinterest en SocialAPI.ai
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.
Pines con el endpoint que ya llamas
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.
Los tableros como recurso de primera clase
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.
Nunca almacenamos tus datos de Pinterest
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.
Un esquema, un conjunto de códigos de error
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.
La renovación del token la hacemos nosotros
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.
Precios simples y honestos.
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.
Preguntas frecuentes
Lo que preguntan los desarrolladores antes de lanzar con Pinterest.
¿Pinterest tiene API?
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.
¿Puedo publicar pines a través de la API?
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.
¿Puedo leer o responder comentarios en mis pines?
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.
¿Cómo gestiono los tableros de Pinterest?
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.
¿Cómo conecto una cuenta de Pinterest?
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.
¿Puedo editar un pin después de publicarlo?
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.
¿Pueden los agentes de IA crear pines?
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.
Todas las demás plataformas, una sola API: Todas las demás plataformas, una sola API
La misma key, las mismas estructuras, el mismo webhook.
¿Listo para unificar tus interacciones sociales?
Nivel gratuito disponible. Sin tarjeta de crédito. Incluye el servidor MCP.