Erwähnungen

Gibt eine Liste von öffentlichen Threads-Medienobjekten zurück, in denen ein Threads-Profil von einem anderen Threads-Profil markiert wurde.

Berechtigungen

Für die Threads Mentions API brauchst du ein passendes Zugriffstoken sowie Berechtigungen für den Node, den du als Ziel verwendest. Während der Testphase kannst du problemlos Token generieren und deiner App Berechtigungen erteilen. Verwende hierzu den Graph API Explorer.

• threads_basic – Wird für Aufrufe an alle Threads API-Endpunkte benötigt.
• threads_manage_mentions – Wird für Aufrufe an den Endpunkt für Erwähnungen benötigt.

Wenn deine App keinen Advanced Access für die threads_manage_mentions-Berechtigung hat, kannst du nur Erwähnungen abrufen, die von Threads-Testnutzer*innen in der App erstellt wurden. Nachdem die Berechtigung erteilt wurde, werden auch die öffentlichen Beiträge anderer Nutzer*innen zurückgegeben.

Einschränkungen

• Threads-Medienobjekte, die von privaten Nutzer*innen erstellt wurden, werden nicht zurückgegeben.
• Der Zeitstempel im Parameter since muss größer oder gleich 1688540400 und kleiner als der Parameter until sein, der wiederum kleiner oder gleich dem aktuellen Zeitstempel und größer als der Parameter since sein muss.

Threads-Erwähnungen abrufen

Felder

Verwende den Parameter fields, um Felder anzugeben, die für alle zurückgegebenen Threads-Medienobjekte eingeschlossen werden sollen.

Beispielanfrage

curl -s -X GET \
  https://graph.threads.net/<THREADS_USER_ID>/mentions?fields=<LIST_OF_FIELDS>&access_token=<ACCESS_TOKEN>

Beispielantwort

Für einen erfolgreichen API-Aufruf wird ein JSON-formatiertes Objekt zurückgegeben, das Threads-Medienobjekte enthält.

{
  "<FIELD>":"<VALUE>",
  ...
}