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

> Opciones para publicar usando la API de Threads

<Info>
  La publicación en Threads obtiene los medios desde tu URL mediante el crawler del lado del servidor de Meta.
  Si ves el código de error 379 de Ayrshare —especialmente junto con un error 440 o 138 de Instagram en la misma
  publicación—, consulta [Meta Media Crawler Blocked](/help-center/technical-support/meta_media_crawler_blocked).
</Info>

## Publicar en Threads

JSON para una publicación básica con un enlace e imagen usando la API de Threads:

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

La API de Threads tiene los siguientes requisitos y restricciones:

<ul class="custom-bullets">
  <li>
    Threads mostrará automáticamente una previsualización del enlace en la publicación salvo que se incluya una imagen o video.
    En el ejemplo anterior se mostrará la imagen. Si se elimina la imagen, se mostrará la previsualización
    del enlace.
  </li>

  <li>Los perfiles de Threads están limitados a 250 publicaciones publicadas por API en un periodo móvil de 24 horas.</li>
  <li>Threads solo permite 1 hashtag por publicación.</li>
  <li>Los usuarios de Threads mencionados con @mention recibirán una notificación.</li>
  <li>Máximo 500 caracteres por publicación.</li>

  <li>
    Se admiten publicaciones con múltiples imágenes/videos y se envían como carrusel. Puedes enviar hasta 20 videos e
    imágenes.
  </li>

  <li>
    Threads no admite eliminaciones a través de una API. Las eliminaciones deben hacerse manualmente desde la app de Threads.
  </li>

  <li>
    Si tu video no termina en una extensión de video conocida como mp4, usa el parámetro `isVideo`.
    Consulta el [endpoint /post](/apis/post/post) para más detalles.
  </li>

  <li>
    Threads también admite el envío de medios sin texto en la publicación. Si no quieres incluir texto,
    envía una cadena vacía `post: ""`.
  </li>

  <li>
    Consulta las [pautas de medios de Threads](/media-guidelines/threads) y la [autorización
    de Threads](/dashboard/connect-social-accounts/threads) para más información.
  </li>
</ul>

## Opciones de Threads

Puedes establecer opciones adicionales para una publicación mediante el parámetro `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
  }
}
```

Las opciones de Threads son campos opcionales que se pueden usar para controlar la publicación.

<ParamField body="allowCountries" type="array of strings">
  Restringe las publicaciones a países específicos usando códigos de país. Usa [códigos de país](/iso-codes/country).

  Solo disponible si Meta ha habilitado las restricciones geográficas para tu cuenta.

  Consulta [restricciones geográficas de Threads](/apis/post/social-networks/threads#geo-restrictions) para más información.
</ParamField>

<ParamField body="thread" type="boolean" default={false}>
  Divide publicaciones largas en una serie de threads conectados, con numeración y medios opcionales.

  Consulta [Thread](/apis/post/social-networks/threads#thread) para más información.
</ParamField>

<ParamField body="threadNumber" type="boolean" default={false}>
  Añade automáticamente números al final de cada thread en formato 1/n.

  Requiere `thread: true`.
</ParamField>

<ParamField body="mediaUrls" type="array of strings">
  Añade objetos multimedia a un thread de threads. Se añadirá un objeto multimedia a cada thread en orden.

  Usa `null` para omitir el medio en un thread concreto. Usa objetos con varias URLs para varios medios por thread.

  Consulta [Thread Media](/apis/post/social-networks/threads#thread-media) para más información.
</ParamField>

## Añadir saltos de línea o texto enriquecido a una publicación de Threads

En Threads se pueden añadir saltos de línea a una publicación con un [carácter especial de nueva línea](/apis/post/post#line-breaks).

Se puede añadir texto enriquecido, como negrita o cursiva, a una publicación de Threads con algunos [elementos HTML](/apis/post/overview#rich-text-posts).

## Carrusel de imágenes y videos

Puedes publicar varias imágenes o videos en Threads como un carrusel; se puede utilizar un total combinado de hasta 20 imágenes o videos en un carrusel. Basta con añadir tus imágenes o videos adicionales al array `mediaUrls` y el carrusel se creará automáticamente.

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

Las URLs de video deben terminar en una extensión conocida como mp4.

## Límites de caracteres

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

## Restricciones geográficas

Puedes restringir una publicación a un país o países específicos mediante el array `allowCountries`.

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

<ul class="custom-bullets">
  <li>
    `allowCountries`: un array de códigos de país permitidos. Consulta [códigos de país](/iso-codes/country).
  </li>
</ul>

<Warning>
  Las restricciones geográficas (geo-gating) en Threads solo están disponibles si Meta ha habilitado esta función para tu cuenta.

  Meta decide qué cuentas de Threads son elegibles para restricciones geográficas en función de factores como la verificación de la cuenta, el número de seguidores o el estatus de creador de contenido.
  Si tu cuenta es elegible, verás la configuración geográfica (icono de globo) en el compositor de publicaciones al crear una nueva publicación de Threads.

  Puedes comprobar si un perfil de usuario es elegible para restricciones geográficas de Threads consultando la propiedad `isEligibleForGeoRestrictions` en el endpoint [/user](/apis/user/profile-details).
</Warning>

## Menciones en Threads

Menciona otro handle de Threads añadiendo @handle en el texto de la publicación. Por ejemplo:

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

<Warning>
  El usuario mencionado con @ será notificado de la mención. Revisa las [reglas
  importantes](/testing/post-verification#mentions) sobre las menciones.
</Warning>

Si se ha alcanzado la cuota, se devolverá un mensaje de error.

## Thread

Un thread de Threads, también conocido como threadstorm, es una serie conectada de publicaciones en Threads que te permite compartir ideas más largas más allá del límite de caracteres de una sola publicación, mostrándose como una narrativa continua cuando se ven juntas.

### Publicar un thread

Un thread de Threads puede publicarse mediante la API. Un thread es una publicación dividida en un conjunto de publicaciones de respuesta asociadas en Threads. Puedes dividir el texto automáticamente o especificar los [puntos de corte del thread](/apis/post/social-networks/threads#thread-breaks) en el texto de la publicación.

```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` para dividir automáticamente el texto de la publicación en threads según los saltos de línea.
  </li>

  <li>
    `threadNumber: true` para añadir automáticamente números al final de los threads en formato 1/n.
    Por ejemplo, el 2º de 5 threads llevará añadido: 2/5
  </li>

  <li>
    `mediaUrls: [array of urls]` para añadir cada objeto multimedia, una imagen o video, a un thread en orden.
    Solo se añadirá un objeto multimedia por thread, en orden.
  </li>
</ul>

#### Thread Media

##### Omitir medios

Omite el medio de un thread usando `null` en el array. Por ejemplo:

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

Esto colocará image1 en la primera publicación, sin imagen en la segunda y image2 en la tercera.

##### Múltiples medios

Se pueden añadir varios objetos multimedia a una sola publicación dentro de un thread añadiendo un objeto `{}` con las URLs de medio en el array `mediaUrls`. Se pueden usar claves únicas cualquiera para el objeto. Por ejemplo:

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

En este ejemplo, la primera publicación contendrá photo-1.jpg, la segunda photo-2.jpg y photo-3.jpg, y la tercera photo-4.jpg.

#### Puntos de corte del thread

Ayrshare divide automáticamente el texto de la publicación en publicaciones de longitud adecuada (> 500 caracteres) para Threads. Al crear threads, priorizamos mantener las frases completas en una sola publicación cuando es posible. Si una frase no cabe, dividimos entre frases. En frases muy largas, dividimos entre palabras. En casos poco frecuentes en los que una palabra sea demasiado larga, dividimos la propia palabra.

También puedes añadir manualmente párrafos con `\n\n` al texto de la publicación para indicar que se debe crear un thread único. Si el texto de la publicación contiene `\n\n`, no dividiremos automáticamente la publicación en threads.

Por ejemplo:

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

producirá dos publicaciones en el thread.

Si quieres añadir párrafos pero sin dividir en publicaciones, usa `\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
  }
}
```

producirá una única publicación con dos párrafos, ya que la publicación tiene menos de 500 caracteres.

### Eliminar un thread

Threads no admite eliminaciones mediante API. Las eliminaciones deben hacerse manualmente desde la app de Threads.
