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

> Opciones para publicar usando la API de 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>)}
  </>;

## Publicar en Reddit

Los siguientes son los parámetros del cuerpo obligatorios para publicar usando la API de Reddit. Asegúrate de que el subreddit permita la publicación automatizada.
Consulta las [pautas de medios de Reddit](/media-guidelines/reddit) y la [autorización de Reddit](/dashboard/connect-social-accounts/reddit) para más información.

```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` (obligatorio): el título de la publicación en Reddit.</li>

  <li>
    `subreddit` (obligatorio): el subreddit al que se enviará la publicación. Asegúrate de seguir las pautas de
    publicación del subreddit. Un buen subreddit para hacer pruebas es */r/test/* y se puede consultar en:
    [https://www.reddit.com/r/test/](https://www.reddit.com/r/test/)
  </li>

  <li>
    `link` (opcional): si publicas en Reddit y quieres publicar un enlace en lugar de texto en el
    subreddit. Aunque el texto del parámetro `post` sigue siendo obligatorio, no se incluye en la publicación
    porque los enlaces de Reddit no pueden llevar cuerpo de texto.
  </li>
</ul>

<Warning>
  Consulta siempre las reglas del subreddit antes de publicar. Algunos subreddits tienen un umbral de karma,
  requieren membresía durante cierto tiempo, limitan la frecuencia de publicación, no permiten imágenes o
  requieren añadir flair. Además, la mayoría de subreddits tienen reglas específicas sobre spam y autopromoción.
  No seguirlas puede provocar tu baneo por parte del subreddit o de Reddit.
</Warning>

## Publicar una imagen en Reddit

Publica una imagen en Reddit incluyendo la URL de la imagen en el parámetro `mediaUrl` o en el parámetro `link` de `redditOptions`. Las imágenes publicadas como `link` se abrirán mostrando la imagen completa.

El texto del parámetro `post` se ignora, pero sigue siendo obligatorio para enviar la publicación correctamente. Reddit restringe publicar imágenes y texto juntos a su editor "fancy pants" online. Esto significa que se puede publicar una imagen o texto, pero no ambos a la vez.

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

## Añadir flair de Reddit

Algunos subreddits requieren flair. Los moderadores del subreddit predefinen el flair y cada uno tiene un ID único. En la publicación de Reddit a Ayrshare, añade el ID del flair y, opcionalmente, un texto de flair si se puede sobrescribir.

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

Puedes obtener el ID del flair de un subreddit llamando al endpoint [/post/redditFlair](/apis/utils/reddit-get-flair).

## Comprobar si existe un subreddit

Comprueba si un subreddit existe con el [endpoint /validate](/apis/validate/check-subreddit).

## Añadir formato de texto enriquecido a publicaciones de Reddit

Si quieres añadir texto en negrita, cursiva o superíndice a una publicación de Reddit, usa [Markdown estilo 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"
  }
}
```

## Menciones en Reddit

Menciona a otro usuario de Reddit o a un subreddit.

<ul class="custom-bullets">
  <li>Menciona a un usuario de Reddit añadiendo `@subreddit` o `u/username` en el texto de la publicación.</li>
  <li>Menciona un subreddit añadiendo `r/subreddit` en el texto de la publicación.</li>
</ul>

Por ejemplo:

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

<Warning>
  Revisa las [reglas importantes](/testing/post-verification#mentions) sobre las menciones.
</Warning>

## Límites de caracteres

Consulta los [límites de caracteres de Reddit](/help-center/technical-support/character_limits#reddit-character-limits) para más información.

## Endpoints adicionales

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