> ## 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.
# Pinterest API
> Параметри для публікації за допомогою Pinterest API
## Публікація Image Pin у Pinterest
Pinterest API вимагає включення зображення в допис. Інші параметри є опціональними.
Для отримання додаткової інформації див. [Pinterest Media Guidelines](/media-guidelines/pinterest) та [Pinterest Authorization](/dashboard/connect-social-accounts/pinterest).
```json Pinterest Post theme={"system"}
{
"post": "The best Pinterest API ever!", // Максимум 500 символів або порожній рядок
"platforms": ["pinterest"],
"mediaUrls": ["https://images.ayrshare.com/imgs/GhostBusters.jpg"]
}
```
## Параметри Pinterest
Ви можете встановити додаткові параметри для допису, використовуючи параметр `pinterestOptions`.
```json Pinterest Post theme={"system"}
{
"post": "The best Pinterest API ever!", // Максимум 500 символів або порожній рядок
"platforms": ["pinterest"],
"mediaUrls": ["https://images.ayrshare.com/imgs/GhostBusters.jpg"],
"pinterestOptions": {
"altText": ["This is my best pic", "😃 here is the next one"], // максимум 500 символів
"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", // максимум 2048 символів
"note": "Private note", // максимум 1000 символів
"thumbNail": "https://images.ayrshare.com/imgs/GhostBusters.jpg",
"title": "A Pinterest Board for You" // максимум 100 символів
}
}
```
Параметри Pinterest — це опціональні поля, які можна використовувати для керування дописом.
Альтернативний текст для зображень і відео для доступності та програм зчитування з екрана. Максимум 500 символів.
Для отримання додаткової інформації див. [Pinterest Alternative Text](/apis/post/social-networks/pinterest#alternative-text).
Публікація на іншій дошці Pinterest користувача, вказавши ID з кінцевої точки /user/details.
Якщо не вказано, публікує на пов'язаній за замовчуванням дошці.
Для отримання додаткової інформації див. [Pinterest Board ID](/apis/post/social-networks/pinterest#board-id).
Додайте до 5 зображень як карусель Pinterest з опціональними заголовками, посиланнями та описами.
Кожен об'єкт може містити: `title`, `link` та `description`.
Для отримання додаткової інформації див. [Pinterest Image Carousel](/apis/post/social-networks/pinterest#pinterest-image-carousel).
URL призначення, куди перенаправляються користувачі, коли клацають зображення pin. Максимум 2048 символів.
Створює клікабельне посилання, прикріплене до Вашого pin.
Для отримання додаткової інформації див. [Pin Link](/apis/post/social-networks/pinterest#pin-link).
Додайте приватні нотатки до окремих Pins, які можуть бачити лише Ви та співавтори дошки. Максимум 1000 символів.
Для отримання додаткової інформації див. [Pin Note](/apis/post/social-networks/pinterest#pin-note).
Встановіть мініатюру для video pins. Має бути PNG або JPG, ті ж розміри, що й відео, менше 10 МБ.
Обов'язково для video pins.
Для отримання додаткової інформації див. [Video Pin (Thumbnail)](/apis/post/social-networks/pinterest#video-pin-thumbnail).
Заголовок pin для відображення в розділі "Add your title". Максимум 100 символів.
Для отримання додаткової інформації див. [Pin Title](/apis/post/social-networks/pinterest#pin-title).
\*Посилання в полі `post` не є клікабельними. Будь ласка, використовуйте поле `link`, щоб додати
клікабельне посилання до Pin.
Для отримання додаткової інформації див. [Pinterest Media Guidelines](/media-guidelines/pinterest).
## Alternative Text
Додайте альтернативний текст, також відомий як alt text, до зображення або відео Pinterest. Alt text Pinterest — це функція доступності, що використовується для додаткової інформації користувача та програм зчитування з екрана.
Використовуйте `altText` в об'єкті `pinterestOptions`.
```json Pinterest Alt Text theme={"system"}
{
"pinterestOptions": {
"altText": ["This is my best pic", "😃 here is the next one"]
}
}
```
Alt text обмежено 500 символами.
## Board ID
Публікація на іншій дошці Pinterest користувача, вказавши ID, отриманий з кінцевої точки [/user/details](/apis/user/pinterest-board). В іншому випадку публікація на пов'язаній за замовчуванням дошці.
Використовуйте `boardId` в об'єкті `pinterestOptions`.
```json Pinterest Board ID theme={"system"}
{
"pinterestOptions": {
"boardId": "93383204522"
}
}
```
## Обмеження символів
Для отримання додаткової інформації див. [Обмеження символів Pinterest](/help-center/technical-support/character_limits#pinterest-character-limits).
## Pin Link
URL призначення, куди перенаправляються користувачі, коли клацають на зображення pin. Це створює клікабельне посилання, прикріплене до Вашого pin. Максимальна довжина — 2048 символів.
Використовуйте `link` в об'єкті `pinterestOptions`.
```json Pin Link theme={"system"}
{
"pinterestOptions": {
"link": "https://www.ayrshare.com"
}
}
```
## Pin Note
Ви можете додати приватні нотатки до окремих Pins на своїх дошках. Тільки Ви та співавтори дошки зможете їх побачити.
Використовуйте `note` в об'єкті `pinterestOptions`.
```json Pin Note theme={"system"}
{
"pinterestOptions": {
"note": "Private note for collaborators"
}
}
```
## Pinterest Image Carousel
Опублікуйте до п'яти зображень як карусель Pinterest. Додаючи більше одного URL медіа, карусель створюється автоматично. Ви також можете додати опціональний параметр carousel. Див. нижче.
```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": [
// опціонально
{
"title": "Image 1",
"link": "https://www.cnn.com",
"description": "Super Image 1"
},
{
"title": "Image 2",
"link": "https://www.google.com",
"description": "Super Image 2"
}
]
}
}
```
Опціональне поле `carouselOptions` приймає масив об'єктів. Кожен об'єкт карусель відповідає еквівалентному рядку URL медіа, тобто перший об'єкт карусель відноситься до першого рядка `mediaUrl`.
- `title`: Заголовок зображення.
- `link`: Зовнішнє посилання призначення для зображення.
- `description`: Опис зображення.
## Згадування Pinterest
Хоча Ви можете додати @handle до допису Pinterest, Pinterest не підтримує розкриття згадувань у тексті допису.
@handle залишається як звичайний текст.
## Pin Title
Заголовок pin для відображення. З'являється в розділі "Add your title" нового pin. Максимум 100 символів.
Використовуйте `title` в об'єкті `pinterestOptions`.
```json Pin Title theme={"system"}
{
"pinterestOptions": {
"title": "A Pinterest Board for You"
}
}
```
## Video Pin (Thumbnail)
Відео можна опублікувати як Pin, використовуючи стандартне поле `mediaUrls` у [кінцевій точці /post](/apis/post/post). Крім того, URL мініатюри **має бути включено** з відео з дійсним медіа Content-Type, наприклад `image/jpeg`.
Див. [вимоги](/media-guidelines/pinterest).
```json Video Pin with Thumbnail theme={"system"}
{
"pinterestOptions": {
// обов'язково
"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"
}
}
```
Додаткова інформація про [публікацію Pins за допомогою API](https://www.ayrshare.com/blog/pinterest-api-integration-on-ayrshare/).
Якщо Ваше відео не закінчується відомим розширенням відео, як mp4, будь ласка, використовуйте параметр `isVideo`. Для деталей див. [кінцеву точку /post](/apis/post/post).