Zurück zu den APIs
Öffentliche Threads-Daten

Threads Public Data API

Rufen Sie öffentliche Threads-Profile ab, lösen Sie bekannte Beiträge auf oder erfassen Sie Beiträge ausgewählter Profile – mit normalisierten Feldern zu Identität, Inhalt, Medien, Engagement und Zeitstempeln.

Verfügbare Threads-APIs

Verwenden Sie Profiles für Kontodaten, Posts für einen bekannten öffentlichen Beitrag oder User Posts für eine begrenzte Sammlung aus ausgewählten Profilen.

Welche Threads-Daten können Sie abrufen?

SocQ liefert normalisierte öffentliche Konto- und Beitragsdatensätze mit Kontext zu Identität, Inhalt, Medien, sichtbarem Engagement, Quelle und Erfassungszeitpunkt.

Öffentliche Profildetails

Ruft Profil-IDs, URLs, Benutzernamen, Anzeigenamen, Biografien, Bilder, verknüpfte Websites, sichtbare Kontozahlen und die Erfassungszeit ab.

Inhalte bekannter Beiträge

Wandelt eine öffentliche Beitrags-URL in Beitragsidentität, Text, Angaben zum Autor, Quell-URL und verfügbare Medien um.

Sichtbares Engagement bei Beiträgen

Behält Veröffentlichungs- und Erfassungszeit zusammen mit den verfügbaren Zahlen zu Likes, Kommentaren, Reposts und Shares bei.

Beiträge ausgewählter Profile

Durchsucht eine begrenzte Menge öffentlicher Beiträge je Profil-URL und hält das gesendete Profil mit den Ergebnissen verbunden.

SocQ vs Threads API

SocQ konzentriert sich auf die unterstützte Erfassung öffentlicher Threads-Daten. Die Threads API von Meta ist für autorisierte Abläufe zu Veröffentlichung, Antworten, Insights und unterstützter Suche ausgelegt.

FunktionSocQThreads API
HauptzweckÖffentliche Profile, Beiträge und die letzten Beiträge eines Nutzers erfassenAutorisierte Integrationen für Veröffentlichung, Antworten, Insights und Suche entwickeln
OAuth beim KundenSocQ-API-Schlüssel; kein Threads-OAuth des KundenMeta-App, Autorisierung durch den Threads-Nutzer und Zugriffstoken
AusgangseingabeÖffentliche Threads-Profil- oder Beitrags-URLAutorisierter Kontokontext, Threads-IDs und unterstützte Suchparameter
Antworten veröffentlichen oder verwaltenNicht unterstütztUnterstützt mit den erforderlichen Threads-Berechtigungen
AntwortformatNormalisierte SocQ-DatensätzeNative Threads-Graph-API-Objekte

So funktioniert die Threads API

Profiles, Posts und User Posts nutzen denselben asynchronen Aufgabenablauf mit paginierten Ergebnissen.

  1. 1. Öffentliche URLs senden

    Senden Sie Profil- oder Beitrags-URLs an die passende API und speichern Sie die zurückgegebene task_id.

  2. 2. Aufgabe verfolgen

    Fragen Sie /v1/tasks/{task_id} ab, bis die Verarbeitung abgeschlossen ist.

  3. 3. Ergebnisse abrufen

    Lesen Sie data.results.items und verwenden Sie next_cursor, solange has_more den Wert true hat.

Beiträge eines Threads-Profils erfassen

Authentifizieren Sie sich mit Ihrem SocQ-API-Schlüssel und senden Sie eine öffentliche Profil-URL an User Posts. Profiles und Posts folgen demselben Aufgabenablauf.

curl -X POST "https://api.socq.ai/v1/threads/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.threads.com/@example"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Typische Anwendungsfälle der Threads API

Creator- und Profilrecherche

Reichern Sie bekannte Profil-URLs mit öffentlicher Identität, Biografie, Website, sichtbaren Kontokennzahlen und Erfassungszeit an.

Analyse bekannter Beiträge

Wandeln Sie ausgewählte Beitrags-URLs in Inhalt, Autor, Medien, Veröffentlichungszeit, sichtbares Engagement und Quellfelder um.

Beobachtung von Creator-Inhalten

Erfassen Sie eine begrenzte Menge von Beiträgen ausgewählter Profile und vergleichen Sie die Inhalte über wiederholte Erfassungen hinweg.

Engagement-Reporting

Nutzen Sie sichtbare Zahlen und collected_at, um öffentliche Beitragsmomentaufnahmen zu vergleichen, ohne sie als Echtzeit-Kennzahlen zu behandeln.

Grenzen und Richtlinie für öffentliche Daten

Threads-Ergebnisse sind öffentliche Datensätze zu einem bestimmten Zeitpunkt. Diese APIs greifen nicht auf private Inhalte zu und veröffentlichen, bearbeiten, löschen oder verwalten keine Threads-Konten und -Beiträge.

  • Profiles akzeptiert URLs im Format threads.com und threads.net /@username. Reine Benutzernamen und Beitrags-URLs werden abgelehnt.
  • Posts akzeptiert URLs im Format /@username/post/{post_id}. Es unterstützt weder results_limit noch die Suche nach Profilbeiträgen.
  • User Posts akzeptiert Profil-URLs im Format /@username. results_limit hat den Standardwert 100, akzeptiert 1 bis 2.000 und gilt für jedes Profil separat.
  • User Posts gibt nicht an, ob ein Ergebnis ein Originalbeitrag, eine Antwort, ein Zitat oder ein Repost ist.
  • Ein Beitrag kann comments_count enthalten, einzelne Antworten und Antwortbäume werden jedoch nicht zurückgegeben.
  • Optionale Felder zu Identität, Inhalt, Medien, Zeitstempel und Engagement können leer sein, wenn der öffentliche Datensatz sie nicht bereitstellt.

Häufige Fragen zur Threads API

Was ist die Threads API?

Die Threads API ist eine Gruppe von SocQ-Endpunkten, mit denen Sie öffentliche Profildaten abrufen, bekannte Beiträge auflösen und eine begrenzte Menge von Beiträgen ausgewählter Profile erfassen.

Welche Threads-API sollte ich verwenden?

Verwenden Sie Profiles für Kontodatensätze im Format /@username, Posts für genaue Links im Format /@username/post/{post_id} und User Posts für eine begrenzte Sammlung aus jeder Profil-URL im Format /@username.

Wie funktioniert das Ergebnislimit bei User Posts?

results_limit hat den Standardwert 100, akzeptiert ganze Zahlen von 1 bis 2.000 und gilt für jede gesendete Profil-URL separat.

Kennzeichnen die Ergebnisse von User Posts Antworten oder Reposts?

Im normalisierten Ergebnis wird kein Beitragsuntertyp bereitgestellt. Behandeln Sie jedes Element als öffentlichen Beitrag, der aus dem gesendeten Profil gefunden wurde, ohne daraus abzuleiten, ob es ein Original, eine Antwort, ein Zitat oder ein Repost ist.

Sind Threads-Beiträge und Engagement-Kennzahlen vollständig oder in Echtzeit?

Nein. Die Ergebnisse spiegeln die öffentlichen Felder wider, die zum Zeitpunkt der Erfassung verfügbar sind, enthalten keine vollständigen Antwortbäume und sind als Momentaufnahmen zu behandeln und nicht als Echtzeit-Feeds.

Wie wird die Erfassung bei Threads abgerechnet?

Jedes zurückgegebene Profil kostet 0,6 Credits, jeder zurückgegebene Beitrag aus Posts oder User Posts 0,5 Credits. Für leere Ergebnismengen fällt keine Ergebnisgebühr an.

Führen Sie öffentliche Profile, Inhalte und Interaktionsdaten verschiedener Plattformen in einem Workflow zusammen, um Marken, Creator und Themen zu verfolgen und plattformübergreifend effizienter zu überwachen und zu analysieren.