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

> Options de publication à l'aide de l'API Reddit

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>)}
  </>;

## Publier sur Reddit

Voici les paramètres de corps requis pour publier avec l'API Reddit. Assurez-vous que le subreddit autorise la publication automatisée.
Consultez [Reddit Media Guidelines](/media-guidelines/reddit) et [Reddit Authorization](/dashboard/connect-social-accounts/reddit) pour plus d'informations.

```json Reddit Post theme={"system"}
{
  "post": "Reddit post", // empty string is allowed
  "platforms": ["reddit"], // required
  "redditOptions": {
    "title": "Reddit Post Title", // required
    "subreddit": "test", // required (no "/r/" needed)
    "link": "https://www.website.com" // optional: post a link
  }
}
```

<ul class="custom-bullets">
  <li>`title` (obligatoire) : le titre de la publication sur Reddit.</li>

  <li>
    `subreddit` (obligatoire) : le subreddit auquel envoyer la publication. Veillez à respecter les
    règles de publication du subreddit. Un bon subreddit pour vos tests est */r/test/*, consultable ici :
    [https://www.reddit.com/r/test/](https://www.reddit.com/r/test/)
  </li>

  <li>
    `link` (facultatif) : si vous publiez sur Reddit et que vous souhaitez publier un lien plutôt qu'un texte dans le
    subreddit. Le texte du paramètre `post` reste requis, mais il n'est pas inclus dans la publication
    car les liens Reddit ne peuvent pas contenir de corps de texte.
  </li>
</ul>

<Warning>
  Vérifiez toujours les règles du subreddit avant de publier. Certains subreddits ont un seuil de karma,
  exigent une adhésion pendant une période donnée, limitent la fréquence de publication, n'autorisent pas les images ou
  exigent l'ajout d'un flair. De plus, la plupart des subreddits ont des règles spécifiques sur le spam et l'auto-promotion.
  Ne pas les respecter peut entraîner un bannissement par le subreddit ou par Reddit.
</Warning>

## Publier une image sur Reddit

Publiez une image sur Reddit en incluant l'URL de l'image dans le paramètre `mediaUrl` ou le paramètre `link` de `redditOptions`. Les images publiées en tant que `link` seront résolues comme l'image complète.

Le texte du paramètre `post` est ignoré, mais reste requis pour soumettre la publication avec succès. Reddit limite la publication simultanée d'images et de texte à son éditeur en ligne « fancy pants ». Cela signifie qu'il est possible de publier soit une image, soit du texte, mais pas les deux en même temps.

```json Reddit Post with Image theme={"system"}
{
  "post": "Reddit post", // required, but not added to the post
  "platforms": ["reddit"], // required
  "mediaUrls": "https://my-media-url.com",
  "redditOptions": {
    "title": "Reddit Post Title", // required
    "subreddit": "test" // required (no "/r/" needed)
  }
}
```

## Ajouter un flair Reddit

Certains subreddits nécessitent un flair. Les modérateurs du subreddit prédéfinissent le flair et chaque flair possède un ID unique. Dans la publication Reddit envoyée à Ayrshare, ajoutez l'ID du flair et, éventuellement, un texte de flair si le texte peut être remplacé.

```json Reddit Post with Flair theme={"system"}
{
  "redditOptions": {
    "flairId": "jM8nH92enjswas", // Id of the flair
    "flairText": "My New Flair text" // Override the flair text if allowed by flair
  }
}
```

Vous pouvez trouver l'ID de flair d'un subreddit en appelant le point de terminaison [/post/redditFlair](/apis/utils/reddit-get-flair).

## Vérifier si un subreddit existe

Vérifiez si un subreddit existe avec le [point de terminaison /validate](/apis/validate/check-subreddit).

## Ajouter du formatage de texte enrichi aux publications Reddit

Si vous souhaitez ajouter du texte en gras, en italique ou en exposant à une publication Reddit, utilisez le [Markdown propre à Reddit](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"
  }
}
```

## Mentions Reddit

Mentionnez un autre utilisateur Reddit ou un subreddit.

<ul class="custom-bullets">
  <li>Mentionnez un utilisateur Reddit en ajoutant `@subreddit` ou `u/username` dans le texte de la publication.</li>
  <li>Mentionnez un subreddit en ajoutant `r/subreddit` dans le texte de la publication.</li>
</ul>

Par exemple :

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

<Warning>
  Consultez les [règles importantes](/testing/post-verification#mentions) concernant les mentions.
</Warning>

## Limites de caractères

Consultez [Reddit Character Limits](/help-center/technical-support/character_limits#reddit-character-limits) pour plus d'informations.

## Points de terminaison supplémentaires

<Card title="Récupérer les flairs Reddit" icon="code" href="/apis/utils/reddit-get-flair" horizontal />