Threads Profiles
Threads-Profile sind öffentliche Kontoseiten mit Benutzernamen, Anzeigenamen, Biografien, Profilbildern, Websites und den sichtbaren Zahlen zu Followern, Gefolgten und Beiträgen. Diese Identitätsangaben und Kontosignale eignen sich für die Anreicherung von Profilen, den Vergleich öffentlicher Konten und die Beobachtung im Zeitverlauf.
Funktionen der Threads Profiles API
- Stapel unterstützter Profil-URLsVerarbeitet eine oder mehrere threads.com- oder threads.net-Profil-URLs mit dem Pfad /@username und weist Beitragslinks sowie fremde Pfade ab.
- Normalisierte ProfilidentitätLiefert Profil-ID, URL, Benutzername, Anzeigename, Biografie, Profilbild und verlinkte Website in einem einheitlichen Profildatensatz.
- Momentaufnahmen sichtbarer KontenHält die verfügbaren Zahlen zu Followern, Gefolgten und Beiträgen zusammen mit collected_at fest, sodass jeder Satz öffentlicher Kennzahlen einen Beobachtungszeitpunkt hat.
Parameter der Threads Profiles API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliche Liste öffentlicher Threads-Profil-URLs auf threads.com oder threads.net. Jeder Pfad muss das Format /@username haben; reine Benutzernamen, Beitrags-URLs und fremde Pfade werden abgelehnt. |
So verwenden Sie die Threads Profiles API
Senden Sie bekannte öffentliche Profil-URLs, verfolgen Sie die asynchrone Aufgabe und lesen Sie die normalisierten Profildatensätze per Cursor-Paginierung aus.
- Bereiten Sie eine oder mehrere öffentliche Threads-Profil-URLs mit dem Pfad /@username auf threads.com oder threads.net vor.
- Senden Sie die Links als urls an /v1/threads/profiles 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/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.threads.com/@example"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der Threads Profiles API
- Anreicherung öffentlicher Profile: Ergänzen Sie Datensätze zu bekannten Threads-Profilen um Benutzername, Anzeigename, Biografie, Profilbild, Website und Quell-URL.
- Vergleich der Kontoreichweite: Vergleichen Sie die sichtbaren Zahlen zu Followern, Gefolgten und Beiträgen über eine ausgewählte Gruppe öffentlicher Profile hinweg.
- Beobachtung öffentlicher Profile: Speichern Sie Identitätsfelder und sichtbare Kennzahlen mit collected_at, um Profildarstellung und Kontosignale über verschiedene Erfassungszeitpunkte hinweg zu vergleichen.
Profi-Tipps zur Threads Profiles API
- Prüfen Sie jede URL vor dem Senden gegen den Pfad /@username auf threads.com oder threads.net, damit Beitragslinks und fremde Pfade die Anfrage nicht scheitern lassen.
- Normalisieren Sie die gesendeten URLs und entfernen Sie Duplikate bei den zurückgegebenen Profilen anhand von id, sofern vorhanden; als Ersatz dient url als stabiler Schlüssel.
- Behandeln Sie Biografie, Profilbild, Website und einzelne Kontokennzahlen als optionale Felder, damit auch unvollständige öffentliche Datensätze nutzbar bleiben.
- Speichern Sie collected_at neben den Zahlen zu Followern, Gefolgten und Beiträgen, damit sich spätere Durchläufe als eigene öffentliche Momentaufnahmen unterscheiden lassen.
Verwandte APIs
Ergänzend zur Threads Profiles API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Threads-Daten benötigen.
- Threads Posts API — Öffentliche Beitragstexte, Autorenkontext, Medien, Zeitstempel und sichtbare Interaktionen aus unterstützten Threads-Beitrags-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.