API do Threads - Ayrshare API Documentation

A publicação no Threads busca a mídia da sua URL por meio do crawler no servidor da Meta. Se você vir o código de erro 379 do Ayrshare — especialmente junto com um erro 440 ou 138 do Instagram no mesmo envio — consulte Meta Media Crawler Blocked.

Publicando no Threads

JSON para uma publicação básica com link e imagem usando a API do 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"]
}

A API do Threads tem os seguintes requisitos e restrições:

O Threads irá automaticamente gerar a prévia do link na publicação, a menos que haja uma imagem ou vídeo incluído. No exemplo acima, a imagem será exibida. Remover a imagem fará com que a prévia do link seja mostrada.
Os perfis do Threads são limitados a 250 publicações via API dentro de um período móvel de 24 horas.
O Threads permite apenas 1 hashtag por publicação.
Menções (@mention) a usuários do Threads receberão uma notificação.
Máximo de 500 caracteres na publicação.
Publicações com múltiplas imagens/vídeos são suportadas e enviadas como carrossel. Você pode enviar até 20 vídeos e imagens.
O Threads não suporta exclusões via API. As exclusões devem ocorrer manualmente usando o aplicativo do Threads.
Se seu vídeo não terminar em uma extensão de vídeo conhecida, como mp4, use o parâmetro isVideo. Consulte o endpoint /post para detalhes.
O Threads também suporta enviar mídia sem texto de publicação. Se você não quiser incluir texto na publicação, envie uma String vazia post: "".
Consulte as Diretrizes de mídia do Threads e a Autorização do Threads para mais informações.

Opções do Threads

Você pode definir opções adicionais para uma publicação usando o 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
  }
}

As opções do Threads são campos opcionais que podem ser usados para controlar a publicação.

allowCountries

array of strings

Restrinja publicações a países específicos usando códigos de país. Use códigos de país.Disponível apenas se a Meta tiver ativado restrições geográficas para sua conta.Consulte Restrições geográficas do Threads para mais informações.

thread

boolean

padrão:false

Divida publicações longas em uma série conectada de threads com numeração e mídia opcionais.Consulte Thread para mais informações.

threadNumber

boolean

padrão:false

Adiciona automaticamente números ao final de cada thread no formato 1/n.Requer thread: true.

mediaUrls

array of strings

Adicione objetos de mídia a uma thread de threads. Um objeto de mídia será adicionado a cada thread na ordem.Use null para pular mídia em uma thread específica. Use objetos com múltiplas URLs para múltiplas mídias por thread.Consulte Mídia da Thread para mais informações.

Adicionando quebras de linha ou rich text a uma publicação do Threads

Quebras de linha do Threads podem ser adicionadas a uma publicação com um caractere de nova linha especial. Rich text, como negrito ou itálico, pode ser adicionado a uma publicação do Threads com alguns elementos HTML.

Carrossel de imagens e vídeos

Você pode postar várias imagens ou vídeos no Threads como um carrossel; até um total combinado de 20 imagens ou vídeos pode ser usado em um carrossel. Basta adicionar suas imagens ou vídeos adicionais ao array mediaUrls e o carrossel será criado automaticamente.

"mediaUrls": ["https://url.com/image.jpg", "https://url.com/video.mp4" ...];  // Max 20 images or videos

URLs de vídeo devem terminar em uma extensão conhecida, como mp4.

Limites de caracteres

Consulte Limites de caracteres do Threads para mais informações.

Restrições geográficas

Você pode restringir uma publicação a um país ou países específicos usando o array allowCountries.

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

allowCountries: Um array de códigos de país permitidos. Veja códigos de país.

Restrições geográficas (geo-gating) no Threads só estão disponíveis se a Meta tiver ativado este recurso para sua conta.A Meta decide quais contas do Threads são elegíveis para restrições geográficas com base em fatores como verificação de conta, contagem de seguidores ou status de criador de conteúdo. Se sua conta for elegível, você verá as configurações geográficas (ícone de globo) no compositor de publicações ao criar uma nova publicação no Threads.Você pode verificar se um User Profile é elegível para restrições geográficas do Threads verificando a propriedade isEligibleForGeoRestrictions no endpoint /user.

Menções no Threads

Mencione outro usuário do Threads adicionando @handle no texto da publicação. Por exemplo:

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

O usuário @mencionado será notificado da menção. Revise as regras importantes sobre menções.

Se a cota tiver sido atingida, uma mensagem de erro será retornada.

Thread

Uma thread do Threads, também conhecida como threadstorm, é uma série conectada de publicações no Threads que permite compartilhar ideias mais longas além do limite de caracteres de uma única publicação, aparecendo como uma narrativa contínua quando visualizada em conjunto.

Publicando uma Thread

Uma thread do Threads pode ser publicada via API. Uma thread é uma publicação dividida em um conjunto de publicações de resposta associadas entre si no Threads. Você pode dividir a publicação automaticamente ou especificar as quebras da thread no texto da publicação.

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 automaticamente o texto da publicação em threads com base em quebras de linha.
threadNumber: true para adicionar automaticamente números ao final das threads no formato 1/n. Por exemplo, a 2ª de 5 threads terá o número anexado: 2/5.
mediaUrls: [array de urls] para adicionar cada objeto de mídia, uma imagem ou vídeo, a uma thread em ordem. Apenas um objeto de mídia será adicionado por thread, em ordem.

Mídia da Thread

Pular mídia

Pule a mídia de uma thread usando null no array. Por exemplo: ["https://site.com/image1.png", null, "https://site.com/image2.png"] Isso colocará image1 na primeira publicação, nenhuma imagem na segunda publicação e image2 na terceira publicação.

Múltiplas mídias

Múltiplos objetos de mídia podem ser adicionados a uma única publicação dentro de uma thread, adicionando um objeto {} com as URLs de mídia no array mediaUrls. Quaisquer chaves de objeto únicas podem ser usadas. Por exemplo:

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

Neste exemplo, a primeira publicação conterá photo-1.jpg, a segunda publicação photo-2.jpg e photo-3.jpg, e a terceira publicação photo-4.jpg.

Quebras de thread

O Ayrshare divide automaticamente o texto da publicação em posts de tamanho apropriado (> 500 caracteres) para o Threads. Ao criar threads, priorizamos manter frases completas em uma única publicação, quando possível. Se uma frase não couber, dividimos entre frases. Para frases muito longas, dividimos entre palavras. Em casos raros em que uma palavra é muito longa, dividimos a própria palavra. Você também pode adicionar manualmente parágrafos com \n\n no texto da publicação para indicar que uma nova thread deve ser criada. Se você tiver \n\n no texto da publicação, não dividiremos automaticamente a publicação em threads. Por exemplo:

Example Threads Thread

{
  "post": "This is post 1\n\nThis is post 2.",
  "platforms": ["threads"],
  "threadsOptions": {
    "thread": true
  }
}

resultará em duas publicações na thread. Se você quiser adicionar parágrafos, mas sem dividir em publicações, use \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
  }
}

resultará em uma publicação com dois parágrafos, já que a publicação tem menos de 500 caracteres.

Excluir uma Thread

O Threads não suporta exclusões via API. As exclusões devem ocorrer manualmente usando o aplicativo do Threads.

​Publicando no Threads

​Opções do Threads

​Adicionando quebras de linha ou rich text a uma publicação do Threads

​Carrossel de imagens e vídeos

​Limites de caracteres

​Restrições geográficas

​Menções no Threads

​Thread

​Publicando uma Thread

​Mídia da Thread

Pular mídia

Múltiplas mídias

​Quebras de thread

​Excluir uma Thread

Publicando no Threads

Opções do Threads

Adicionando quebras de linha ou rich text a uma publicação do Threads

Carrossel de imagens e vídeos

Limites de caracteres

Restrições geográficas

Menções no Threads

Thread

Publicando uma Thread

Mídia da Thread

Quebras de thread

Excluir uma Thread