Saltar al contenido principal

Publicar un pin de imagen en Pinterest

La API de Pinterest requiere que se incluya una imagen en la publicación. Los demás parámetros son opcionales. Consulta las pautas de medios de Pinterest y la autorización de Pinterest para más información.
Pinterest Post

Opciones de Pinterest

Puedes establecer opciones adicionales para una publicación mediante el parámetro pinterestOptions.
Pinterest Post
Las opciones de Pinterest son campos opcionales que se pueden usar para controlar la publicación.
altText
array of strings
El texto alternativo de las imágenes y videos para accesibilidad y lectores de pantalla. Máximo 500 caracteres.Consulta texto alternativo de Pinterest para más información.
boardId
string
Publica en otro tablero de Pinterest del usuario especificando el ID obtenido del endpoint /user/details.Si no se especifica, publica en el tablero vinculado por defecto.Consulta Pinterest Board ID para más información.
Añade hasta 5 imágenes como un carrusel de Pinterest con títulos, enlaces y descripciones opcionales.Cada objeto puede contener: title, link y description.Consulta carrusel de imágenes de Pinterest para más información.
La URL de destino a la que se dirigirá al usuario al hacer clic en la imagen del pin. Máximo 2048 caracteres.Crea un enlace clicable asociado a tu pin.Consulta Pin Link para más información.
note
string
Añade notas privadas a pines individuales que solo tú y los colaboradores del tablero podéis ver. Máximo 1000 caracteres.Consulta Pin Note para más información.
thumbNail
string
Establece una miniatura para los pines de video. Debe ser PNG o JPG, con las mismas dimensiones que el video y menos de 10MB.Obligatorio para los pines de video.Consulta Video Pin (Thumbnail) para más información.
title
string
El título del pin que se mostrará en la sección “Add your title”. Máximo 100 caracteres.Consulta Pin Title para más información.
*Los enlaces del campo post no son clicables. Usa el campo link para añadir un enlace clicable al Pin. Consulta las pautas de medios de Pinterest para más información.

Texto alternativo

Añade texto alternativo (alt text) a una imagen o video de Pinterest. El alt text de Pinterest es una función de accesibilidad utilizada para información adicional del usuario y para lectores de pantalla. Usa altText dentro del objeto pinterestOptions.
Pinterest Alt Text
El alt text está limitado a 500 caracteres.

Board ID

Publica en otro tablero de Pinterest del usuario especificando el ID obtenido del endpoint /user/details. En caso contrario, publica en el tablero vinculado por defecto. Usa boardId dentro del objeto pinterestOptions.
Pinterest Board ID

Límites de caracteres

Consulta los límites de caracteres de Pinterest para más información. La URL de destino a la que se dirigirá a los usuarios al hacer clic en la imagen del pin. Crea un enlace clicable asociado al pin. La longitud máxima es de 2048 caracteres. Usa link dentro del objeto pinterestOptions.
Pin Link

Pin Note

Puedes añadir notas privadas a pines individuales de tus tableros. Solo tú y los colaboradores del tablero podréis verlas. Usa note dentro del objeto pinterestOptions.
Pin Note

Carrusel de imágenes de Pinterest

Publica hasta cinco imágenes como un carrusel de Pinterest. Al añadir más de una URL de medio, se crea automáticamente un carrusel. También puedes añadir parámetros opcionales del carrusel. Consulta más abajo.
Pinterest Carousel Post
El campo opcional carouselOptions recibe un array de objetos. Cada objeto del carrusel corresponde a la URL de medio equivalente; por ejemplo, el primer objeto del carrusel se refiere a la primera cadena de mediaUrl.
  • title: el título de la imagen.
  • link: el enlace de destino externo de la imagen.
  • description: la descripción de la imagen.

Menciones en Pinterest

Aunque puedes añadir un @handle a una publicación de Pinterest, Pinterest no admite la resolución de menciones en el texto de la publicación. El @handle permanecerá como texto plano.

Pin Title

El título del pin que se mostrará. Aparece en la sección “Add your title” de un pin nuevo. Máximo 100 caracteres. Usa title dentro del objeto pinterestOptions.
Pin Title

Pin de video (miniatura)

Se puede publicar un video como Pin mediante el campo estándar mediaUrls del endpoint /post. Además, debe incluirse una URL de imagen de miniatura junto con el video con un Content-Type de medio válido, como image/jpeg. Consulta los requisitos.
Video Pin with Thumbnail
Más información sobre cómo publicar pines usando la API. Si tu video no termina en una extensión de video conocida como mp4, usa el parámetro isVideo. Consulta el endpoint /post para más detalles.