Visão geral

Você pode usar a API do Threads para permitir que as pessoas criem e publiquem conteúdo em nome de alguém no Threads e para exibir esses posts no seu app exclusivamente para a pessoa que os criou.

A API do Threads pode ser acessada por graph.threads.com ou graph.threads.net.

Limitação de volume

As chamadas para a API do Threads são contabilizadas em relação à contagem de chamadas de um determinado app. A contagem de chamadas de um app, única para cada par de app e usuário do app, é o número de chamadas feitas durante uma janela de 24 horas. O cálculo é feito da seguinte forma:
Calls within 24 hours = 4800 * Number of Impressions
Number of Impressions é o número de vezes que um conteúdo da conta do Threads do usuário entrou na tela de uma pessoa nas últimas 24 horas. A limitação de volume também pode estar sujeita ao tempo total de CPU por dia:
720000 * number_of_impressions for total_cputime
2880000 * Number of Impressions for total_time
Observação: o valor mínimo é 10 impressões (por isso, se houver menos de 10 impressões, nós predefiniremos para 10).

Posts

Os perfis do Threads podem publicar até 250 posts usando a API em um período de 24 horas. Os carrosséis contam como um único post. Esse limite é aplicado no ponto de extremidade POST /{threads-user-id}/threads_publish quando você tenta publicar um contêiner de mídia. Também recomendamos que seu app imponha o limite de publicação, principalmente se ele permitir que os usuários agendem posts futuros.

Para verificar o uso atual do limite de volume da API do Threads referente a um perfil, consulte o ponto de extremidade GET /{threads-user-id}/threads_publishing_limit.

Observação: esse ponto de extremidade exige as permissões threads_basic e threads_content_publish.

Campos

NomeDescrição

quota_usage

É a contagem de publicações do Threads nas últimas 24 horas.

config

É o objeto de configuração de limite de volume para publicações do Threads, que contém os campos quota_total e quota_duration.

Exemplo de solicitação

curl -s -X GET \
  "https:graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=quota_usage,config&access_token=<ACCESS_TOKEN>"

Exemplo de resposta

{
  "data": [
    {
      "quota_usage": 4,
      "config": {
        "quota_total": 250,
        "quota_duration": 86400
      }
    }
  ]
}

Respostas

Os perfis do Threads podem gerar até 1.000 respostas em um período de 24 horas.

Para verificar o uso atual do limite de volume para respostas do Threads referente a um perfil, consulte o ponto de extremidade GET /{threads-user-id}/threads_publishing_limit. Consulte a documentação Gerenciamento de respostas para saber mais.

Observação: esse ponto de extremidade exige as permissões threads_basic, threads_content_publish e threads_manage_replies.

Campos

NomeDescrição

reply_quota_usage

É a contagem de publicações de respostas do Threads nas últimas 24 horas.

reply_config

É o objeto de configuração do limite de volume para publicação de respostas do Threads, que contém os campos quota_total e quota_duration.

Exemplo de solicitação

curl -s -X GET \
  "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=reply_quota_usage,reply_config&access_token=<ACCESS_TOKEN>"

Exemplo de resposta

{
  "data": [
    {
      "reply_quota_usage": 1,
      "reply_config": {
        "quota_total": 1000,
        "quota_duration": 86400
      }
    }
  ]
}

Exclusão

Os perfis do Threads são limitados a 100 exclusões em um período contínuo de 24 horas.

Para verificar o uso atual do limite de volume de exclusões do Threads referente a um perfil, consulte o ponto de extremidade GET /{threads-user-id}/threads_publishing_limit. Consulte a documentação Excluir posts para saber mais.

Observação: esse ponto de extremidade requer as permissões threads_basic e threads_delete.

Campos

NomeDescrição

delete_quota_usage

É a contagem de exclusões do Threads nas últimas 24 horas.

delete_config

É o objeto de configuração do limite de volume relacionado a exclusões do Threads, que contém os campos quota_total e quota_duration.

Exemplo de solicitação

curl -s -X GET \
  "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=delete_quota_usage,delete_config&access_token=<ACCESS_TOKEN>"

Exemplo de resposta

{
  "data": [
    {
      "delete_quota_usage": 1,
      "delete_config": {
        "quota_total": 100,
        "quota_duration": 86400
      }
    }
  ]
}

Pesquisa por localização

Os perfis do Threads são limitados a 500 pesquisas por localização em um período contínuo de 24 horas.

Para verificar o uso atual do limite de volume relacionado a pesquisas por localização, consulte o ponto de extremidade GET /{threads-user-id}/threads_publishing_limit. Consulte a documentação Marcação de localização para saber mais.

Observação: esse ponto de extremidade exige as permissões threads_basic e threads_location_tagging.

Campos

NomeDescrição

location_search_quota_usage

É a contagem de pesquisas por localização do Threads nas últimas 24 horas.

location_search_config

É o objeto de configuração do limite de volume relacionado a pesquisas por localização do Threads, que contém os campos quota_total e quota_duration.

Exemplo de solicitação

curl -s -X GET \
  "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=location_search_quota_usage,location_search_config&access_token=<ACCESS_TOKEN>"

Exemplo de resposta

{
  "data": [
    {
      "location_search_quota_usage": 1,
      "location_search_config": {
        "quota_total": 500,
        "quota_duration": 86400
      }
    }
  ]
}

Limitações e especificações

Especificações de imagem

  • Formato: os tipos de imagem JPEG e PNG são os formatos oficialmente compatíveis para posts de imagem.
  • Tamanho do arquivo: máximo de 8 MB.
  • Limite de taxa de proporção: 10:1
  • Largura mínima: 320 (se necessário, a foto será redimensionada para atender ao tamanho mínimo)
  • Largura máxima: 1.440 (se necessário, a foto será redimensionada para atender ao tamanho máximo)
  • Altura: pode variar dependendo da largura e da taxa de proporção
  • Espaço de cores: sRGB. As imagens que usarem outros espaços de cores serão convertidas para o sistema sRGB.

Especificações de vídeo

  • Contêiner: MOV ou MP4 (MPEG-4 Parte 14), sem listas de edição com o moov atom na frente do arquivo.
  • Codec de áudio: AAC, taxa de amostragem máxima de 48 kHz, 1 ou 2 canais (mono ou estéreo).
  • Codec de vídeo: HEVC ou H.264, verificação progressiva, GOP fechado, chroma subsampling de 4:2:0.
  • Taxa de quadros: 23 a 60 FPS
  • Tamanho da imagem:
    • Máximo de colunas (pixels horizontais): 1.920
    • A taxa de proporção exigida é entre 0,01:1 e 10:1. No entanto, recomendamos a taxa de 9:16 para evitar cortes ou espaços em branco.
  • Taxa de bits do vídeo: VBR, máximo de 100 Mbps.
  • Taxa de bits do áudio: 128 kbps.
  • Duração: máximo de 300 segundos (5 minutos), mínimo mais que 0 segundo.
  • Tamanho do arquivo: máximo de 1 GB.

Outras limitações

  • Os posts de texto podem ter até 500 caracteres.
  • Os posts em carrossel devem ter no máximo 20 e no mínimo 2 elementos.
  • Para ver outras limitações, consulte a referência de cada ponto de extremidade.