> ## 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.

# Threads API

> Опції публікації через Threads API

<Info>
  Публікація в Threads завантажує медіа з вашого URL через серверний краулер Meta.
  Якщо ви бачите код помилки Ayrshare 379 — особливо разом із помилкою Instagram 440 або 138 у тій самій
  публікації — див. [Meta Media Crawler Blocked](/help-center/technical-support/meta_media_crawler_blocked).
</Info>

## Публікація в Threads

JSON для базового посту з посиланням та зображенням через Threads API:

```json Threads Post theme={"system"}
{
  "post": "The best Threads post ever #best #awesome https://www.threads.net", // empty string is allowed
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["threads"]
}
```

Threads API має такі вимоги та обмеження:

<ul class="custom-bullets">
  <li>
    Threads автоматично покаже прев'ю посилання у пості, якщо не додано зображення чи відео. У прикладі вище
    буде показано зображення. Видалення зображення призведе до появи прев'ю посилання.
  </li>

  <li>Профілі Threads обмежені 250 постами, опублікованими через API, у межах рухомого 24-годинного періоду.</li>
  <li>Threads дозволяє лише 1 хештег на пост.</li>
  <li>Користувач, згаданий через @mention, отримає сповіщення.</li>
  <li>Максимум 500 символів у пості.</li>

  <li>
    Підтримуються пости з кількома зображеннями/відео — вони надсилаються як карусель. Можна надіслати до 20 відео та
    зображень.
  </li>

  <li>
    Threads не підтримує видалення через API. Видаляти потрібно вручну через застосунок Threads.
  </li>

  <li>
    Якщо ваше відео не закінчується відомим розширенням, як-от mp4, використайте параметр `isVideo`.
    Деталі див. в [ендпоінті /post](/apis/post/post).
  </li>

  <li>
    Threads також підтримує надсилання медіа без тексту посту. Якщо не потрібно включати текст,
    надішліть порожній рядок `post: ""`.
  </li>

  <li>
    Докладніше див. [Threads Media Guidelines](/media-guidelines/threads) та [Threads
    Authorization](/dashboard/connect-social-accounts/threads).
  </li>
</ul>

## Threads Options

Ви можете задати додаткові опції посту за допомогою параметра `threadsOptions`.

```json Threads Options theme={"system"}
{
  "threadsOptions": {
    "allowCountries": ["US", "CA"],
    "thread": true,
    "threadNumber": true,
    "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"] // used when sending as a thread of threads
  }
}
```

Threads options — це опціональні поля для керування постом.

<ParamField body="allowCountries" type="array of strings">
  Обмежити публікацію певними країнами за кодами країн. Використовуйте [коди країн](/iso-codes/country).

  Доступно лише, якщо Meta увімкнула гео-обмеження для вашого акаунта.

  Докладніше див. [Threads Geo Restrictions](/apis/post/social-networks/threads#geo-restrictions).
</ParamField>

<ParamField body="thread" type="boolean" default={false}>
  Розбити довгий пост на пов'язаний ланцюг постів (thread) з опціональною нумерацією та медіа.

  Докладніше див. [Thread](/apis/post/social-networks/threads#thread).
</ParamField>

<ParamField body="threadNumber" type="boolean" default={false}>
  Автоматично додати номери в кінці кожного треда у форматі 1/n.

  Потребує `thread: true`.
</ParamField>

<ParamField body="mediaUrls" type="array of strings">
  Додати медіа-об'єкти до треда з тредів. По одному медіа-об'єкту буде додано до кожного треда по порядку.

  Використайте `null`, щоб пропустити медіа для конкретного треда. Використовуйте об'єкти з кількома URL для кількох медіа у треді.

  Докладніше див. [Thread Media](/apis/post/social-networks/threads#thread-media).
</ParamField>

## Додавання переносів рядків або форматованого тексту в пост Threads

Переноси рядків у Threads додаються до посту за допомогою спеціального [символу нового рядка](/apis/post/post#line-breaks).

Форматований текст (жирний або курсив) можна додати в пост Threads за допомогою кількох [html-елементів](/apis/post/overview#rich-text-posts).

## Карусель зображень та відео

Ви можете опублікувати в Threads кілька зображень або відео як карусель; сукупно до 20 елементів. Просто додайте додаткові зображення чи відео до масиву `mediaUrls`, і карусель буде створено автоматично.

```json theme={"system"}
"mediaUrls": ["https://url.com/image.jpg", "https://url.com/video.mp4" ...];  // Max 20 images or videos
```

URL відео мають закінчуватися відомим розширенням, як-от mp4.

## Обмеження на символи

Докладніше див. [Threads Character Limits](/help-center/technical-support/character_limits#threads-character-limits).

## Гео-обмеження

Ви можете обмежити публікацію певною країною або країнами за допомогою масиву `allowCountries`.

```json theme={"system"}
{
  "threadsOptions": {
    "allowCountries": ["US", "CA"]
  }
}
```

<ul class="custom-bullets">
  <li>
    `allowCountries`: масив кодів країн для дозволу. Див. [коди країн](/iso-codes/country).
  </li>
</ul>

<Warning>
  Гео-обмеження (geo-gating) у Threads доступні, лише якщо Meta увімкнула цю можливість для вашого акаунта.

  Meta вирішує, які Threads-акаунти мають право на гео-обмеження, на основі таких факторів, як верифікація акаунта, кількість підписників або статус контент-творця.
  Якщо ваш акаунт має право, ви побачите географічні налаштування (значок глобуса) у композері під час створення нового посту Threads.

  Ви можете перевірити, чи має user profile право на гео-обмеження Threads, перевіривши властивість `isEligibleForGeoRestrictions` в ендпоінті [/user](/apis/user/profile-details).
</Warning>

## Згадки у Threads

Згадайте іншого користувача Threads, додавши @handle до тексту посту. Наприклад:

```json theme={"system"}
{
  "post": "The best social media API @Ayrshare ever!",
  "mediaUrls": ["https://images.com"],
  "platforms": ["threads"]
}
```

<Warning>
  Згаданий через @ користувач отримає сповіщення. Ознайомтесь із [важливими
  правилами](/testing/post-verification#mentions) щодо згадок.
</Warning>

Якщо квоту вичерпано, буде повернуто повідомлення про помилку.

## Thread

Thread у Threads (також відомий як threadstorm) — це пов'язана серія постів у Threads, яка дозволяє ділитися довшими ідеями поза лімітом одного посту, відображаючись як один суцільний наратив при перегляді разом.

### Публікація треда

Thread можна опублікувати через API. Thread — це пост, розбитий на набір пов'язаних відповідей у Threads. Ви можете розбити пост автоматично або вказати [розриви треда](/apis/post/social-networks/threads#thread-breaks) у тексті.

```json Threads Thread theme={"system"}
{
  "threadsOptions": {
    "thread": true,        // required for threadstorm
    "threadNumber": true,  // optional to add numbers to each thread
    "mediaUrls": ["https://site.com/image1.png", "https://site.com/image2.png", ...]  // optional one media object is added to a thread in order
  }
}
```

<ul class="custom-bullets">
  <li>
    `thread: true` — автоматично розбивати текст посту на треди за переносами рядків.
  </li>

  <li>
    `threadNumber: true` — автоматично додавати номери в кінці тредів у форматі 1/n.
    Наприклад, 2-й з 5 тредів матиме в кінці: 2/5
  </li>

  <li>
    `mediaUrls: [array of urls]` — додати кожен медіа-об'єкт (зображення чи відео) до треда по порядку.
    До треда додається лише один медіа-об'єкт по порядку.
  </li>
</ul>

#### Медіа треда

##### Пропуск медіа

Пропустіть медіа для треда, використовуючи `null` у масиві. Наприклад:

`["https://site.com/image1.png", null, "https://site.com/image2.png"]`

Це розмістить image1 у першому пості, без зображення в другому, і image2 в третьому.

##### Кілька медіа

Кілька медіа-об'єктів можна додати в один пост треда, додавши об'єкт `{}` з URL у масиві `mediaUrls`. Можна використовувати будь-які унікальні ключі об'єкта. Наприклад:

```json Threads Thread with Multiple Media URLs theme={"system"}
{
  "threadsOptions": {
    "thread": true,
    "threadNumber": true,
    "mediaUrls": [
      "https://img.ayrshare.com/random/photo-1.jpg",
      {
        "1": "https://img.ayrshare.com/random/photo-2.jpg",
        "2": "https://img.ayrshare.com/random/photo-3.jpg"
      },
      "https://img.ayrshare.com/random/photo-4.jpg"
    ]
  }
}
```

У цьому прикладі перший пост міститиме photo-1.jpg, другий — photo-2.jpg та photo-3.jpg, а третій — photo-4.jpg.

#### Розриви треда

Ayrshare автоматично розбиває текст посту на пости відповідної довжини (> 500 символів) для Threads. Під час створення тредів ми прагнемо зберігати повні речення в одному пості, коли це можливо. Якщо речення не поміщається, ми ділимо між реченнями. Для дуже довгих речень ділимо між словами. У рідкісних випадках, коли слово занадто довге, ділимо саме слово.

Ви також можете вручну додати абзаци у тексті посту через `\n\n`, щоб позначити створення окремого треда. Якщо в тексті посту є `\n\n`, ми не будемо автоматично розбивати пост на треди.

Наприклад:

```json Example Threads Thread theme={"system"}
{
  "post": "This is post 1\n\nThis is post 2.",
  "platforms": ["threads"],
  "threadsOptions": {
    "thread": true
  }
}
```

створить два пости у треді.

Якщо ви хочете додати абзаци, але не розбивати на пости, використовуйте `\u2063\n\u2063\n`.

```json Threads Thread with Paragraphs theme={"system"}
{
  "post": "This is paragraph 1\u2063\n\u2063\nThis is paragraph 2.",
  "platforms": ["threads"],
  "threadsOptions": {
    "thread": true
  }
}
```

створить один пост із двома абзацами, оскільки пост менший за 500 символів.

### Видалення треда

Threads не підтримує видалення через API. Видалення потрібно виконувати вручну через застосунок Threads.