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ámetropinterestOptions.
Pinterest Post
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.
array of strings
Declara las divulgaciones de IA para todo el Pin. Los valores aceptados son
AI_MODIFIED y SYNTHETIC_PERFORMER.Consulta Divulgaciones de IA de Pinterest para más información.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.
array of objects
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.string
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.
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.
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.
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.
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. UsaaltText dentro del objeto pinterestOptions.
Pinterest Alt Text
Divulgaciones de IA de Pinterest
UsapinterestOptions.aiDisclosures para enviar las declaraciones de divulgación de IA de Pinterest al crear un Pin. Las divulgaciones se aplican a todo el Pin, incluidos los carruseles de imágenes, y se admiten en Pins de imagen, Pins de carrusel y Pins de video.
Pinterest AI Disclosure
Pinterest AI Disclosure
AI_MODIFIED: el Pin contiene contenido modificado con IA.SYNTHETIC_PERFORMER: el Pin contiene un intérprete sintético.
aiDisclosures se omite o es un array vacío, Ayrshare no envía a Pinterest ningún campo de divulgación de IA. Los valores duplicados se envían una sola vez. Los valores distinguen entre mayúsculas y minúsculas y no se convierten.
Si la opción no es válida, por ejemplo un valor desconocido, mayúsculas y minúsculas incorrectas, un valor que no es un array o un array que contiene una entrada que no es una cadena, el Pin aún puede publicarse correctamente, pero Ayrshare omite la opción de divulgación completa y devuelve una advertencia no fatal en el resultado de Pinterest. Corrige la solicitud y envía uno o ambos valores aceptados si el Pin necesita una divulgación de IA explícita. Pinterest puede seguir aplicando sus propias etiquetas de forma independiente.
El servidor MCP y la API GraphQL comprueban primero los tipos de los valores. En esas interfaces, un valor mal formado, como una lista que contiene un número, se rechaza antes de publicar, en lugar de publicarse con una advertencia. Las cadenas desconocidas o con mayúsculas y minúsculas incorrectas se siguen publicando con la advertencia.
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. UsaboardId dentro del objeto pinterestOptions.
Pinterest Board ID
Límites de caracteres
Consulta los límites de caracteres de Pinterest para más información.Pin Link
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. Usalink 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. Usanote 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
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. Usatitle dentro del objeto pinterestOptions.
Pin Title
Pin de video (miniatura)
Se puede publicar un video como Pin mediante el campo estándarmediaUrls 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
isVideo. Consulta el endpoint /post para más detalles.