Threads Posts
Threads-Beiträge sind öffentliche, textbasierte Veröffentlichungen mit Autorenidentität, Medienverweisen, Veröffentlichungszeitpunkt und den sichtbaren Zahlen zu Likes, Kommentaren, Reposts und Shares. Diese Datensätze eignen sich für die Recherche zu ausgewählten Beiträgen, die Quellenprüfung, den Inhaltsvergleich und die Auswertung von Interaktionen mit Zeitstempel.
Funktionen der Threads Posts API
- Direkte Auflösung von Beitrags-URLsLöst öffentliche URLs der Form threads.com oder threads.net /@username/post/{post_id} in Datensätze für genau die übergebenen Beiträge auf, nicht in einen Profil-Feed.
- Beitragsinhalt und AutorenzuordnungLiefert Beitragskennungen, Quell-URLs, Text sowie verfügbare Autoren-IDs, Benutzernamen, Anzeigenamen und Profil-URLs für nachvollziehbare Datensätze.
- Medien und Momentaufnahme der sichtbaren InteraktionenHält normalisierte Medienverweise, Veröffentlichungs- und Erfassungszeitpunkt sowie die sichtbaren Zahlen zu Likes, Kommentaren, Reposts und Shares pro Beitrag zusammen.
Parameter der Threads Posts API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliche Liste öffentlicher Threads-Beitrags-URLs auf threads.com oder threads.net mit dem Pfad /@username/post/{post_id}. |
So verwenden Sie die Threads Posts API
Senden Sie die öffentlichen Threads-Beiträge, die Sie bereits kennen, verfolgen Sie die asynchrone Aufgabe und lesen Sie die normalisierten Ergebnisse per Cursor-Paginierung aus.
- Bereiten Sie eine oder mehrere öffentliche Threads-Beitrags-URLs mit dem Pfad /@username/post/{post_id} auf threads.com oder threads.net vor.
- Senden Sie die Links als urls an /v1/threads/posts und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler meldet.
- Lesen Sie data.results.items und fordern Sie dann die zurückgegebene next_cursor an, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/threads/posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.threads.com/@example/post/POST_ID"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der Threads Posts API
- Ausgewählte Beitragslisten anreichern: Wandeln Sie bekannte Beitrags-URLs in Datensätze mit IDs, Text, Autorenfeldern, Medien, Zeitstempeln und Quellenlinks für einen festgelegten Datensatz um.
- Öffentliche Inhalte und Zuordnung prüfen: Nutzen Sie Text, Medienverweise, Autorenidentität und die ursprüngliche URL, um ausgewählte Veröffentlichungen zu untersuchen und ihre öffentliche Quelle beizubehalten.
- Momentaufnahmen der Interaktionen vergleichen: Kombinieren Sie likes_count, comments_count, reposts_count und shares_count mit collected_at, um Beobachtungen zu verschiedenen Zeitpunkten zu vergleichen.
Profi-Tipps zur Threads Posts API
- Prüfen Sie jede URL vor dem Senden gegen den Pfad /@username/post/{post_id}, damit Profilseiten und fremde Threads-Pfade die Anfrage nicht scheitern lassen.
- Entfernen Sie Duplikate anhand des Beitragspfads, bevor Sie Stapel bilden, damit alternative unterstützte Hostnamen für denselben Beitrag keine doppelte Arbeit verursachen.
- Nutzen Sie diesen Endpunkt nur für bekannte Beitrags-URLs und lassen Sie results_limit weg, denn er entdeckt weder einen Profil-Feed noch erweitert er einen Beitrag um Antworten.
- Behandeln Sie Text, Autorenfelder, Medien, Veröffentlichungszeitpunkt und einzelne Kennzahlen als optional, damit ein nur teilweise sichtbarer öffentlicher Beitrag die Verarbeitung der Ergebnisse nicht unterbricht.
- Speichern Sie collected_at zusammen mit den sichtbaren Interaktionsfeldern, damit festgehalten bleibt, wann jede Momentaufnahme beobachtet wurde.
Verwandte APIs
Ergänzend zur Threads Posts API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Threads-Daten benötigen.
- Threads Profiles API — Öffentliche Profilidentität, Bios, Bilder, Websites, sichtbare Kontozahlen und Erfassungskontext aus unterstützten Threads-Profil-URLs erfassen.
- Threads User Posts API — Öffentliche Beiträge aus Threads-Profil-URLs ermitteln – mit Limit pro Profil, normalisierten Inhalten, Autoren, Medien, Zeitstempeln, sichtbaren Interaktionen und Quellkontext.
- Threads Post Replies API — Die Antworten unter Threads-Beiträgen über Beitrags-URLs erfassen – mit Antworttext, Autoren, Likes und Antwortzahl, Medien und der ID des beantworteten Beitrags.
- Threads Search API — Threads per Keyword oder Hashtag nach den Top-Beiträgen durchsuchen – mit Text, Autoren, Likes, Antworten, Reposts, Medien und Veröffentlichungszeit.
- Threads User Replies API — Die neuesten öffentlichen Antworten eines Kontos über Threads-Profil-URLs erfassen – mit Antworttext, Interaktionen, Medien und Links.
- Threads User Reposts API — Die zuletzt reposteten Beiträge eines Kontos über Threads-Profil-URLs erfassen, jeweils als Originalbeitrag mit Autor, Text, Interaktionen und Medien.