threads/
profiles

Öffentliche Threads-Profile anhand unterstützter Profil-URLs erfassen – mit normalisierter Identität, Biografien, Profilbildern, Websites und sichtbaren Kontokennzahlen.

Threads Profiles API

Eingabe per Profil-URL
Identitäts- und Website-Felder
Sichtbare Kontokennzahlen
0,6 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

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

ParameterErforderlichBeschreibung
urlsErforderlichErforderliche 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.

  1. Bereiten Sie eine oder mehrere öffentliche Threads-Profil-URLs mit dem Pfad /@username auf threads.com oder threads.net vor.
  2. Senden Sie die Links als urls an /v1/threads/profiles und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler meldet.
  4. 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 true

Anwendungsfä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.

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.

Weitere Plattformen entdecken

Kombinieren Sie Threads-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Threads Profiles API — FAQ

Threads Profiles API ruft öffentliche Profildatensätze zu einer oder mehreren unterstützten Threads-Profil-URLs ab. Zurückgegeben werden normalisierte Identität, Biografie, Profilbild, Website, die sichtbaren Zahlen zu Followern, Gefolgten und Beiträgen sowie der Erfassungszeitpunkt.

Senden Sie eine HTTP- oder HTTPS-URL auf threads.com, www.threads.com, threads.net oder www.threads.net, deren Pfad dem Muster /@username folgt. Reine Benutzernamen, Beitrags-URLs und andere Pfadformen werden abgelehnt.

Die Ergebnisse können Profil-ID, URL, Benutzername, Anzeigename, Biografie, Profilbild, Website, die Zahlen zu Followern, Gefolgten und Beiträgen sowie den Erfassungszeitpunkt enthalten.

Ein öffentlicher Profildatensatz liefert unter Umständen keine Biografie, kein Profilbild, keine Website oder nicht jede sichtbare Zahl. Clients sollten null oder leere optionale Werte akzeptieren.

Jeder zurückgegebene Profildatensatz kostet 0,6 SocQ-Credits. Eine leere Ergebnismenge wird nicht berechnet.