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

> Opções para publicar usando a API do 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>)}
  </>;

## Publicando no Reddit

A seguir estão os parâmetros do corpo obrigatórios para publicar usando a API do Reddit. Certifique-se de que o subreddit permite publicação automatizada.
Consulte as [Diretrizes de mídia do Reddit](/media-guidelines/reddit) e a [Autorização do Reddit](/dashboard/connect-social-accounts/reddit) para mais informações.

```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` (obrigatório): O título da publicação no Reddit.</li>

  <li>
    `subreddit` (obrigatório): O subreddit para enviar a publicação. Certifique-se de seguir as
    diretrizes de publicação do subreddit. Um bom subreddit para testes é */r/test/* e pode ser visto em:
    [https://www.reddit.com/r/test/](https://www.reddit.com/r/test/)
  </li>

  <li>
    `link` (opcional): Se estiver publicando no Reddit e quiser postar um link em vez de texto no
    subreddit. Embora o texto do parâmetro `post` ainda seja obrigatório, ele não é incluído na publicação,
    já que links do Reddit não podem ter um corpo de texto.
  </li>
</ul>

<Warning>
  Sempre verifique as regras do subreddit antes de publicar. Alguns subreddits têm um limite mínimo de karma,
  exigem tempo mínimo de associação, limitam a frequência de publicação, não permitem imagens ou
  exigem flair. Além disso, a maioria dos subreddits tem regras específicas sobre spam e autopromoção.
  Não seguir essas regras pode resultar em banimento pelo subreddit ou pelo Reddit.
</Warning>

## Publicando uma imagem no Reddit

Publique uma imagem no Reddit incluindo a URL da imagem no parâmetro `mediaUrl` ou no parâmetro `link` de `redditOptions`. Imagens publicadas como `link` serão resolvidas para a imagem completa.

O texto do parâmetro `post` é ignorado, mas ainda é obrigatório para enviar a publicação com sucesso. O Reddit restringe a publicação simultânea de imagem e texto ao seu editor online "fancy pants". Isso significa que uma imagem ou texto pode ser publicado, mas não ambos ao mesmo tempo.

```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)
  }
}
```

## Adicionar flair do Reddit

Alguns subreddits exigem flair. Os moderadores do subreddit predefinem o flair, e cada flair tem um ID único. Na publicação no Reddit enviada ao Ayrshare, adicione o ID do flair e um texto opcional de flair se o texto puder ser substituído.

```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
  }
}
```

Você pode encontrar o ID do flair de um subreddit chamando o endpoint [/post/redditFlair](/apis/utils/reddit-get-flair).

## Verificar se um subreddit existe

Verifique se um subreddit existe com o [endpoint /validate](/apis/validate/check-subreddit).

## Adicionar formatação de rich text em publicações do Reddit

Se quiser adicionar texto em negrito, itálico ou sobrescrito a uma publicação do Reddit, use o [Markdown do 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"
  }
}
```

## Menções no Reddit

Mencione outro usuário do Reddit ou subreddit.

<ul class="custom-bullets">
  <li>Mencione um usuário do Reddit adicionando `@subreddit` ou `u/username` no texto da publicação.</li>
  <li>Mencione um subreddit adicionando `r/subreddit` no texto da publicação.</li>
</ul>

Por exemplo:

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

<Warning>
  Revise as [regras importantes](/testing/post-verification#mentions) sobre menções.
</Warning>

## Limites de caracteres

Consulte [Limites de caracteres do Reddit](/help-center/technical-support/character_limits#reddit-character-limits) para mais informações.

## Endpoints adicionais

<Card title="Obter flair do Reddit" icon="code" href="/apis/utils/reddit-get-flair" horizontal />