SocialAPI.ai

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
En Pinterest

Llegaron las nuevas bajas blancas. En tienda el sábado, todas las tallas.

Ledge Skate & Shoe

Guardado en Novedades

POST/v1/posts201 Created

Capacidades: 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
  • 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

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

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.