API de Threads - Ayrshare API Documentation

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.

Publicar en Threads

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

Threads Post

{
  "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:

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.
Los perfiles de Threads están limitados a 250 publicaciones publicadas por API en un periodo móvil de 24 horas.
Threads solo permite 1 hashtag por publicación.
Los usuarios de Threads mencionados con @mention recibirán una notificación.
Máximo 500 caracteres por publicación.
Se admiten publicaciones con múltiples imágenes/videos y se envían como carrusel. Puedes enviar hasta 20 videos e imágenes.
Threads no admite eliminaciones a través de una API. Las eliminaciones deben hacerse manualmente desde la app de Threads.
Si tu video no termina en una extensión de video conocida como mp4, usa el parámetro isVideo. Consulta el endpoint /post para más detalles.
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: "".
Consulta las pautas de medios de Threads y la autorización de Threads para más información.

Opciones de Threads

Puedes establecer opciones adicionales para una publicación mediante el parámetro threadsOptions.

Threads Options

{
  "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.

allowCountries

array of strings

Restringe las publicaciones a países específicos usando códigos de país. Usa códigos de país.Solo disponible si Meta ha habilitado las restricciones geográficas para tu cuenta.Consulta restricciones geográficas de Threads para más información.

thread

boolean

predeterminado:false

Divide publicaciones largas en una serie de threads conectados, con numeración y medios opcionales.Consulta Thread para más información.

threadNumber

boolean

predeterminado:false

Añade automáticamente números al final de cada thread en formato 1/n.Requiere thread: true.

mediaUrls

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 para más información.

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. Se puede añadir texto enriquecido, como negrita o cursiva, a una publicación de Threads con algunos elementos HTML.

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.

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

{
  "threadsOptions": {
    "allowCountries": ["US", "CA"]
  }
}

allowCountries: un array de códigos de país permitidos. Consulta códigos de país.

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.

Menciones en Threads

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

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

El usuario mencionado con @ será notificado de la mención. Revisa las reglas importantes sobre las menciones.

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 en el texto de la publicación.

Threads Thread

{
  "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
  }
}

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

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:

Threads Thread with Multiple Media URLs

{
  "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:

Example Threads Thread

{
  "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.

Threads Thread with Paragraphs

{
  "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.

​Publicar en Threads

​Opciones de Threads

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

​Carrusel de imágenes y videos

​Límites de caracteres

​Restricciones geográficas

​Menciones en Threads

​Thread

​Publicar un thread

​Thread Media

Omitir medios

Múltiples medios

​Puntos de corte del thread

​Eliminar un thread

Publicar en Threads

Opciones de Threads

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

Carrusel de imágenes y videos

Límites de caracteres

Restricciones geográficas

Menciones en Threads

Thread

Publicar un thread

Thread Media

Puntos de corte del thread

Eliminar un thread