Présentation

Vous pouvez utiliser l’API Threads pour permettre aux utilisateurs et utilisatrices de créer et de publier du contenu pour le compte d’une personne sur Threads, et de n’afficher ces publications dans votre application que pour les personnes qui en sont à l’origine.

Plafond

Publications

Les profils Threads sont limités à 250 publications via l’API par période glissante de 24 heures. Les carrousels comptent pour une seule publication. Cette limite s’applique au point de terminaison POST /{threads-user-id}/threads_publish lors des tentatives de publication d’un conteneur de contenu multimédia. Il est conseillé d’appliquer aussi le plafond de publication à votre application, surtout si elle autorise les utilisateurs et utilisatrices à planifier des publications ultérieures.

Pour vérifier le niveau actuel du plafond d’API Threads d’un profil, interrogez le point de terminaison GET /{threads-user-id}/threads_publishing_limit.

Remarque : ce point de terminaison nécessite les autorisations threads_basic et threads_content_publish.

Champs

Exemple de requête

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

Exemple de réponse

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

Réponses

Les profils Threads sont limités à 1 000 réponses par période glissante de 24 heures.

Pour vérifier le niveau actuel du plafond de réponses Threads d’un profil, interrogez le point de terminaison GET /{threads-user-id}/threads_publishing_limit. Pour en savoir plus, consultez la documentation Gestion des réponses.

Remarque : ce point de terminaison nécessite les autorisations threads_basic, threads_content_publish et threads_manage_replies.

Champs

Exemple de requête

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

Exemple de réponse

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

Suppression

Les profils Threads sont limités à 100 suppressions par période glissante de 24 heures.

Pour vérifier le niveau actuel du plafond de suppressions Threads d’un profil, interrogez le point de terminaison GET /{threads-user-id}/threads_publishing_limit. Consultez la documentation Supprimer des publications pour en savoir plus.

Remarque : ce point de terminaison nécessite les autorisations threads_basic et threads_delete.

Champs

Exemple de requête

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

Exemple de réponse

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

Recherche de lieu

Les profils Threads sont limités à 500 recherches de lieu par période glissante de 24 heures.

Pour vérifier le niveau actuel du plafond de recherches de lieu Threads d’un profil, interrogez le point de terminaison GET /{threads-user-id}/threads_publishing_limit. Consultez la documentation sur la Recherche de lieu pour en savoir plus.

Remarque : ce point de terminaison nécessite les autorisations threads_basic et threads_location_tagging.

Champs

Exemple de requête

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

Exemple de réponse

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

Limites et spécifications

Autres limites

• Les publications texte sont limitées à 500 caractères.
• Les publications carrousels doivent comporter entre 2 et 20 enfants.
• Pour en savoir plus sur les limites supplémentaires, consultez la référence de chaque point de terminaison.

Étapes suivantes

• Démarrer avec l’API Threads