> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # API de Pinterest > Opciones para publicar usando la API de Pinterest ## 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](/media-guidelines/pinterest) y la [autorización de Pinterest](/dashboard/connect-social-accounts/pinterest) para más información. ```json Pinterest Post theme={"system"} { "post": "The best Pinterest API ever!", // Maximum 500 characters or empty string "platforms": ["pinterest"], "mediaUrls": ["https://images.ayrshare.com/imgs/GhostBusters.jpg"] } ``` ## Opciones de Pinterest Puedes establecer opciones adicionales para una publicación mediante el parámetro `pinterestOptions`. ```json Pinterest Post theme={"system"} { "post": "The best Pinterest API ever!", // Maximum 500 characters or empty string "platforms": ["pinterest"], "mediaUrls": ["https://images.ayrshare.com/imgs/GhostBusters.jpg"], "pinterestOptions": { "altText": ["This is my best pic", "😃 here is the next one"], // maximum 500 characters "boardId": "93383204522", "carouselOptions": [ { "title": "Image 1", "link": "https://www.cnn.com", "description": "Super Image 1" }, { "title": "Image 2", "link": "https://www.google.com", "description": "Super Image 2" } ], "link": "https://www.ayrshare.com", // maximum 2048 characters "note": "Private note", // maximum 1000 characters "thumbNail": "https://images.ayrshare.com/imgs/GhostBusters.jpg", "title": "A Pinterest Board for You" // maximum 100 characters } } ``` Las opciones de Pinterest son campos opcionales que se pueden usar para controlar la publicación. El texto alternativo de las imágenes y videos para accesibilidad y lectores de pantalla. Máximo 500 caracteres. Consulta [texto alternativo de Pinterest](/apis/post/social-networks/pinterest#alternative-text) para más información. 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](/apis/post/social-networks/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](/apis/post/social-networks/pinterest#pinterest-image-carousel) 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](/apis/post/social-networks/pinterest#pin-link) para más información. 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](/apis/post/social-networks/pinterest#pin-note) para más información. 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)](/apis/post/social-networks/pinterest#video-pin-thumbnail) para más información. El título del pin que se mostrará en la sección "Add your title". Máximo 100 caracteres. Consulta [Pin Title](/apis/post/social-networks/pinterest#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](/media-guidelines/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`. ```json Pinterest Alt Text theme={"system"} { "pinterestOptions": { "altText": ["This is my best pic", "😃 here is the next one"] } } ``` 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](/apis/user/pinterest-board). En caso contrario, publica en el tablero vinculado por defecto. Usa `boardId` dentro del objeto `pinterestOptions`. ```json Pinterest Board ID theme={"system"} { "pinterestOptions": { "boardId": "93383204522" } } ``` ## Límites de caracteres Consulta los [límites de caracteres de Pinterest](/help-center/technical-support/character_limits#pinterest-character-limits) 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. Usa `link` dentro del objeto `pinterestOptions`. ```json Pin Link theme={"system"} { "pinterestOptions": { "link": "https://www.ayrshare.com" } } ``` ## 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`. ```json Pin Note theme={"system"} { "pinterestOptions": { "note": "Private note for collaborators" } } ``` ## 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. ```json Pinterest Carousel Post theme={"system"} { "post": "Carousel Time", "platforms": ["pinterest"], "mediaUrls": [ "https://img.ayrshare.com/random/photo-1.jpg", "https://img.ayrshare.com/random/photo-2.jpg" ], "pinterestOptions": { "carouselOptions": [ // optional { "title": "Image 1", "link": "https://www.cnn.com", "description": "Super Image 1" }, { "title": "Image 2", "link": "https://www.google.com", "description": "Super Image 2" } ] } } ``` 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`. ## 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`. ```json Pin Title theme={"system"} { "pinterestOptions": { "title": "A Pinterest Board for You" } } ``` ## Pin de video (miniatura) Se puede publicar un video como Pin mediante el campo estándar `mediaUrls` del [endpoint /post](/apis/post/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](/media-guidelines/pinterest). ```json Video Pin with Thumbnail theme={"system"} { "pinterestOptions": { // required "thumbNail": "https://images.unsplash.com/photo-1513093496871-0a81425386e5?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=MnwxNjQ1ODN8MHwxfHJhbmRvbXx8fHx8fHx8fDE2Mzg0ODAzNDA&ixlib=rb-1.2.1&q=80&w=400" } } ``` Más información sobre [cómo publicar pines usando la API](https://www.ayrshare.com/blog/pinterest-api-integration-on-ayrshare/). Si tu video no termina en una extensión de video conocida como mp4, usa el parámetro `isVideo`. Consulta el [endpoint /post](/apis/post/post) para más detalles.