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

# Reddit API

> Параметри для публікації за допомогою Reddit API

export const HeaderAPI = ({noProfileKey, profileKeyRequired}) => <>
    <ParamField header="Authorization" type="string" required>
      <a href="/apis/overview#authorization">API Key</a> of the Primary Profile.
      <br />
      <br />
      Format: <code>Authorization: Bearer API_KEY</code>
    </ParamField>
    {!noProfileKey && (profileKeyRequired ? <ParamField header="Profile-Key" type="string" required>
          <a href="/apis/overview#profile-key-format">Profile Key</a> of a User Profile.
          <br />
          <br />
          Format: <code>Profile-Key: PROFILE_KEY</code>
        </ParamField> : <ParamField header="Profile-Key" type="string">
          <a href="/apis/overview#profile-key-format">Profile Key</a> of a User Profile.
          <br />
          <br />
          Format: <code>Profile-Key: PROFILE_KEY</code>
        </ParamField>)}
  </>;

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

Наступні параметри тіла є обов'язковими для публікації за допомогою Reddit API. Будь ласка, переконайтеся, що subreddit дозволяє автоматичну публікацію.
Для отримання додаткової інформації див. [Reddit Media Guidelines](/media-guidelines/reddit) та [Reddit Authorization](/dashboard/connect-social-accounts/reddit).

```json Reddit Post theme={"system"}
{
  "post": "Reddit post", // порожній рядок дозволено
  "platforms": ["reddit"], // обов'язково
  "redditOptions": {
    "title": "Reddit Post Title", // обов'язково
    "subreddit": "test", // обов'язково (без "/r/")
    "link": "https://www.website.com" // опціонально: опублікувати посилання
  }
}
```

<ul class="custom-bullets">
  <li>`title` (обов'язково): Заголовок допису в Reddit.</li>

  <li>
    `subreddit` (обов'язково): Subreddit, до якого буде надіслано допис. Обов'язково дотримуйтесь правил
    публікації subreddit. Хороший subreddit для тестування — */r/test/*, його можна переглянути за адресою:
    [https://www.reddit.com/r/test/](https://www.reddit.com/r/test/)
  </li>

  <li>
    `link` (опціонально): Якщо публікуєте в Reddit і хочете опублікувати посилання замість тексту в
    subreddit. Хоча текст параметра `post` все ще обов'язковий, він не включається в допис,
    оскільки посилання Reddit не можуть мати текстове тіло.
  </li>
</ul>

<Warning>
  Завжди перевіряйте правила subreddit перед публікацією. Деякі subreddits мають поріг карми,
  вимагають членства протягом певного періоду, обмежують частоту публікації, не дозволяють зображення або
  вимагають додавання flair. Крім того, більшість subreddits мають конкретні правила щодо спаму та самореклами.
  Недотримання цих правил може призвести до бану subreddit або Reddit.
</Warning>

## Публікація зображення в Reddit

Опублікуйте зображення в Reddit, включивши URL зображення в параметр `mediaUrl` або параметр `link` в `redditOptions`. Зображення, опубліковані як `link`, будуть розкриті у повне зображення.

Текст параметра `post` ігнорується, але все ще необхідний для успішного подання допису. Reddit обмежує публікацію зображень і тексту разом їхнім онлайн-редактором "fancy pants". Це означає, що можна публікувати або зображення, або текст, але не одночасно.

```json Reddit Post with Image theme={"system"}
{
  "post": "Reddit post", // обов'язково, але не додається до допису
  "platforms": ["reddit"], // обов'язково
  "mediaUrls": "https://my-media-url.com",
  "redditOptions": {
    "title": "Reddit Post Title", // обов'язково
    "subreddit": "test" // обов'язково (без "/r/")
  }
}
```

## Додавання Reddit Flair

Деякі subreddits вимагають flair. Модератори subreddit заздалегідь визначають flair, і кожен flair має унікальний ID. У дописі Reddit до Ayrshare додайте ID flair та опціональний flair-текст, якщо текст можна перевизначити.

```json Reddit Post with Flair theme={"system"}
{
  "redditOptions": {
    "flairId": "jM8nH92enjswas", // Id flair
    "flairText": "My New Flair text" // Перевизначити текст flair, якщо flair це дозволяє
  }
}
```

Ви можете знайти ID flair subreddit, викликавши кінцеву точку [/post/redditFlair](/apis/utils/reddit-get-flair).

## Перевірити, чи існує subreddit

Перевірте, чи існує subreddit за допомогою [кінцевої точки /validate](/apis/validate/check-subreddit).

## Додавання форматування rich text до дописів Reddit

Якщо Ви хочете додати жирний, курсивний або надрядковий текст до допису Reddit, використовуйте [Reddit-flavored Markdown](https://www.reddit.com/wiki/markdown#wiki_new_reddit-flavored_markdown).

```json Reddit Post with Rich Text theme={"system"}
{
  "post": "For example, this can be *italic* or **bold** or ^super ",
  "platforms": ["reddit"],
  "redditOptions": {
    "title": "Rich Text Post",
    "subreddit": "test"
  }
}
```

## Згадування Reddit

Згадайте іншого користувача Reddit або subreddit.

<ul class="custom-bullets">
  <li>Згадайте користувача Reddit, додавши `@subreddit` або `u/username` у текст допису.</li>
  <li>Згадайте subreddit, додавши `r/subreddit` у текст допису.</li>
</ul>

Наприклад:

```json Reddit Post with Mention theme={"system"}
{
  "post": "The best Reddit post ever for user @ayrshare and subreddit r/SiliconValleyHBO",
  "platforms": ["reddit"]
}
```

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

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

Для отримання додаткової інформації див. [Обмеження символів Reddit](/help-center/technical-support/character_limits#reddit-character-limits).

## Додаткові кінцеві точки

<Card title="Отримати Reddit Flair" icon="code" href="/apis/utils/reddit-get-flair" horizontal />