La API v5 de Pinterest crea pines por ti, incluidos pines de video, pero solo después de que tu app pase una revisión. Hasta entonces tu app permanece en acceso de prueba, donde cada pin y tablero que crea es una entidad de sandbox visible únicamente para quien la creó. Ese único hecho decide si la API te resulta útil, así que va al principio en lugar de quedar enterrado en una sección sobre alcances.
¿Qué puede publicar realmente la API de Pinterest?
Crea pines en tableros propiedad de la cuenta autenticada: pines de imagen y pines de video, con título, descripción y enlace de destino. Es una API de publicación, no de navegación, y está limitada a las cuentas que hayan autorizado tu app.
Las limitaciones que importan para una evaluación:
| Limitación | Qué significa para ti |
|---|---|
| El acceso de prueba es el nivel predeterminado | Los pines y tableros que crea tu app son entidades de sandbox, visibles solo para quien los creó |
| El acceso estándar requiere revisión | Envías una grabación de video de tu app usando la API, incluido el flujo de OAuth |
| Los pines de video necesitan un paso de subida aparte | Los bytes del video pasan por un registro y una subida de contenido multimedia antes de la llamada de creación del pin |
| Los límites de velocidad varían por nivel | El de prueba se mide por día por app, el estándar por minuto por usuario por app |
Así que una herramienta interna que uses en tu propia cuenta puede quedarse en acceso de prueba indefinidamente. Un producto que publica en nombre de clientes no puede, porque los pines de prueba nunca se vuelven visibles.
Nota: las cifras aquí se verificaron contra developers.pinterest.com en septiembre de 2026. Las plataformas cambian esto sin aviso.
¿Qué exige la revisión de apps de Pinterest y cuánto tarda?
Registras una app, obtienes la aprobación de acceso de prueba y luego solicitas la actualización a estándar. La documentación de Pinterest indica que la actualización requiere que tu app ya tenga la aprobación de prueba, que cumpla las Directrices para Desarrolladores, y que aportes una grabación de video de tu app completando una acción a través de la API de Pinterest, con el flujo de autenticación del usuario visible en la grabación. Se aceptan grabaciones de pantalla de llamadas por terminal o Postman.
El motivo de rechazo más común que menciona Pinterest es una demo que no muestra el flujo de OAuth, o que no muestra una integración real con Pinterest dentro de la aplicación.
Sobre la duración: Pinterest dice que las solicitudes de actualización a estándar se “revisan con regularidad” y que se te notifica por correo cuando hay una decisión. Sugiere contar con unos días. No se publica un tiempo de respuesta específico, así que trata cualquier cifra precisa que leas en otro lugar como una suposición. Planifica tu fecha de lanzamiento en torno a algo desconocido, no a un SLA prometido.
El propio modelo de autenticación es OAuth 2.0 ordinario: rediriges al usuario a Pinterest, intercambias el código por un token de acceso y un token de actualización, guardas ambos por cuenta y renuevas antes de que expiren. Nada exótico. Lo exótico es la barrera de revisión que hay delante.
¿Cuál es la secuencia real para crear un pin?
Para un pin de imagen a partir de una URL pública, es una sola llamada. Para un pin de video son cuatro pasos, porque los bytes deben registrarse, subirse y procesarse antes de que un pin pueda referenciarlos.
- Registrar la subida de contenido multimedia.
POST /v5/mediacon el tipo de contenido. La respuesta trae un identificador de contenido multimedia, una URL de subida y un conjunto de parámetros de formulario. - Subir los bytes. Envía un formulario multipart mediante
POSTa esa URL de subida, enviando primero los parámetros devueltos como campos del formulario y el archivo al final. Es un envío de formulario prefirmado estilo S3, no un endpoint de Pinterest, así que sus respuestas de error son XML en lugar de JSON. - Sondear el estado del contenido multimedia. Vuelve a leer el registro del contenido multimedia hasta que el procesamiento haya finalizado con éxito. Que la subida devuelva un 2xx no significa que el video sea utilizable.
- Crear el pin.
POST /v5/pinsreferenciando el contenido multimedia procesado, más el tablero, el título, la descripción y el enlace.
# 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: no pudimos verificar los nombres exactos de los campos de solicitud y respuesta de
POST /v5/mediaoPOST /v5/pinscontra la referencia oficial de la API de Pinterest: esas páginas renderizan su contenido del lado del cliente y no devolvieron texto de documentación al consultarlas. Lee la referencia de la API en vivo en developers.pinterest.com antes de programar contra ella, y trata los nombres de campo de arriba como la forma del flujo, no como un esquema para copiar.
El paso que la gente se salta es el tercero. Un pin de video también necesita una imagen de portada, que es un segundo recurso que hay que producir y validar. No pudimos confirmar el requisito exacto de la portada en una página de referencia v5 consultable, así que verifícalo contra la documentación actual antes de construir en torno a ello. Si estás dimensionando imágenes para cualquiera de los dos tipos de pin, nuestra guía de tamaños de pines de Pinterest tiene las dimensiones vigentes.
¿Cuáles son los límites de velocidad de la API de Pinterest?
Los límites publicados difieren notablemente según el nivel, otra razón por la que el acceso de prueba no anticipa el comportamiento en producción.
| Nivel | Límite documentado |
|---|---|
| Prueba | 1.000 solicitudes por día para todas las solicitudes de la API, aplicado por app |
| Estándar | 100 solicitudes por segundo por usuario por app para todas las solicitudes de la API |
Las categorías de endpoints individuales tienen sus propios límites más estrechos por encima del universal: lectura, escritura, analíticas y conversiones tienen cada una su propio presupuesto, y la propia documentación de Pinterest señala que todos los límites de velocidad pueden cambiar sin aviso. Comprueba la categoría asignada a cada endpoint que uses en lugar de asumir que aplica el número universal.
Nota: las cifras aquí se verificaron contra developers.pinterest.com en septiembre de 2026. Las plataformas cambian esto sin aviso.
Lo que realmente te va a costar tres semanas
No la llamada del pin. La llamada del pin es cosa de una tarde. Las tres semanas están aquí:
- La revisión. No puedes lanzar a clientes con acceso de prueba, y no hay un tiempo de respuesta publicado. Envía la solicitud con antelación, y envía una grabación que muestre con claridad el flujo de OAuth, porque ese es el motivo de fallo señalado.
- La renovación de tokens. Los tokens de actualización expiran y las revocaciones ocurren en silencio. Necesitas un token de actualización guardado por cuenta conectada, un proceso que lo renueve antes de que expire y un estado de “reconectar esta cuenta” en tu interfaz. Construir esto después de que muera el token del primer cliente es el orden más caro.
- La transcodificación de contenido multimedia. Los pines de video implican aceptar lo que sea que suba un usuario, normalizar el códec y el contenedor, generar una imagen de portada y almacenar el resultado en algún lugar desde el que el paso de subida pueda transmitirlo. Eso es un flujo de procesamiento de medios, no una integración de API.
- Manejo de fallos asíncronos. Un 2xx de la subida prefirmada significa que los bytes llegaron. No significa que el video se haya procesado, ni que exista un pin. Necesitas un sondeador de estado, una política de reintentos que distinga fallos transitorios de permanentes y un estado de publicación que pueda ser
processingen lugar de solo publicado o fallido. Escribimos sobre ese modelo de estados en la guía de la API de programación de redes sociales.
Multiplica los cuatro puntos por cada plataforma que agregues. Esa es la forma real del proyecto. La comparación de construir vs comprar le pone números a esto.
La versión corta
- El acceso de prueba es el predeterminado y produce pines de sandbox visibles solo para quien los creó. El acceso estándar requiere una revisión con una demo en video del flujo de OAuth. No se publica un tiempo de respuesta.
- Los pines de imagen desde una URL pública son una sola llamada. Los pines de video son registrar, subir, sondear, crear, más una imagen de portada.
- El nivel de prueba se limita a 1.000 solicitudes por día por app. El estándar es 100 solicitudes por segundo por usuario por app, con límites más estrechos por categoría debajo.
- El costo de ingeniería está en la revisión, la renovación de tokens, la transcodificación y el manejo de fallos asíncronos, no en la llamada de publicación.
Hacer esto una vez en lugar de una vez por plataforma
Si Pinterest es una de varias redes que necesitas, el trabajo por plataforma de arriba se repite con formas distintas cada vez: distintas barreras de revisión, distintos flujos de contenido multimedia, distintos modelos de cuota. Eso es lo que nuestra API existe para absorber. BulkPublish publica en 15 plataformas a través de un único endpoint REST y un único modelo de publicación, con el OAuth, la renovación de tokens, el manejo de contenido multimedia y el seguimiento de estado asíncrono de nuestro lado.
La documentación para desarrolladores y la página de integración de la API REST cubren los endpoints y el ciclo de vida de la publicación. Si prefieres programar pines mediante una interfaz en lugar de programar contra cualquiera de las dos API, cómo programar pines de Pinterest cubre ese camino, y el contador de caracteres de Pinterest gratuito mantendrá tus títulos y descripciones dentro de los límites.