Übersicht

Mit der Threads API kannst du es Personen ermöglichen, Inhalte im Namen anderer Personen auf Threads zu erstellen und zu veröffentlichen. Außerdem kannst du diese Inhalte in deiner App ausschließlich für die Person anzeigen, die sie erstellt hat.

Durchsatzratenbegrenzung

Beiträge

Threads-Profile können innerhalb von 24 Stunden maximal 250 Beiträge über die API veröffentlichen. Carousels zählen als ein Beitrag. Diese Begrenzung wird im POST /{threads-user-id}/threads_publish-Endpunkt umgesetzt, wenn du versuchst, einen Mediencontainer zu veröffentlichen. Deine App sollte ebenfalls die Ratenbegrenzung für Veröffentlichungen durchsetzen. Das gilt vor allem, wenn deine App es Nutzer*innen erlaubt, die Veröffentlichung von Beiträgen für einen bestimmten Zeitpunkt zu planen.

Mit dem GET /{threads-user-id}/threads_publishing_limit-Endpunkt kannst du die aktuelle Nutzung der Durchsatzratenbegrenzung eines Profils für die Threads API abrufen.

Hinweis: Für diesen Endpunkt sind die Berechtigungen threads_basic und threads_content_publish erforderlich.

Felder

Beispielanfrage

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

Beispielantwort

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

Antworten

Threads-Profile können innerhalb von 24 Stunden maximal 1.000 Antworten veröffentlichen.

Mit dem GET /{threads-user-id}/threads_publishing_limit-Endpunkt kannst du die aktuelle Nutzung der Durchsatzratenbegrenzung eines Profils für Threads-Antworten abrufen. Weitere Informationen findest du unter Reply Management.

Hinweis: Für diesen Endpunkt sind die Berechtigungen threads_basic, threads_content_publish und threads_manage_replies erforderlich.

Felder

Beispielanfrage

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

Beispielantwort

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

Löschung

Threads-Profile können innerhalb von 24 Stunden maximal 100 Löschungen vornehmen.

Mit dem GET /{threads-user-id}/threads_publishing_limit-Endpunkt kannst du die aktuelle Nutzung der Durchsatzratenbegrenzung eines Profils für Löschungen bei Threads abrufen. Weitere Informationen findest du in der Dokumentation zum Löschen von Beiträgen.

Hinweis: Für diesen Endpunkt sind die Berechtigungen threads_basic und threads_delete erforderlich.

Felder

Beispielanfrage

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

Beispielantwort

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

Standort-Suchanfragen

Threads-Profile können innerhalb von 24 Stunden maximal 500 Standort-Suchanfragen durchführen.

Mit dem GET /{threads-user-id}/threads_publishing_limit-Endpunkt kannst du die aktuelle Nutzung der Durchsatzratenbegrenzung eines Profils für Threads-Standort-Suchanfragen abrufen. Weitere Informationen findest du in der Dokumentation zu Standort-Suchanfragen.

Hinweis: Für diesen Endpunkt sind die Berechtigungen threads_basic und threads_location_tagging erforderlich.

Felder

Beispielanfrage

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

Beispielantwort

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

Einschränkungen und Spezifikation

Sonstige Einschränkungen

• Textbeiträge dürfen maximal 500 Zeichen enthalten.
• Carousel-Beiträge müssen mindestens 2 und maximal 20 untergeordnete Elemente enthalten.
• Weitere Einschränkungen findest du in der Referenz der einzelnen Endpunkte.

Nächste Schritte

• Erste Schritte mit der Threads API