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.

threads/posts
Beiträge0,5 Credits pro Ergebnis

threads/profiles
Profile0,6 Credits pro Ergebnis

threads/user-posts
Beiträge0,5 Credits pro Ergebnis

threads/post-replies
Kommentare0,3 Credits pro Ergebnis

threads/search
Suche0,6 Credits pro Ergebnis

threads/search-users
Suche0,6 Credits pro Ergebnis

threads/user-replies
Beiträge0,5 Credits pro Ergebnis

threads/user-reposts
Beiträge0,5 Credits pro Ergebnis
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.
| Funktion | SocQ | Threads API |
|---|---|---|
| Hauptzweck | Öffentliche Profile, Beiträge und die letzten Beiträge eines Nutzers erfassen | Autorisierte Integrationen für Veröffentlichung, Antworten, Insights und Suche entwickeln |
| OAuth beim Kunden | SocQ-API-Schlüssel; kein Threads-OAuth des Kunden | Meta-App, Autorisierung durch den Threads-Nutzer und Zugriffstoken |
| Ausgangseingabe | Öffentliche Threads-Profil- oder Beitrags-URL | Autorisierter Kontokontext, Threads-IDs und unterstützte Suchparameter |
| Antworten veröffentlichen oder verwalten | Nicht unterstützt | Unterstützt mit den erforderlichen Threads-Berechtigungen |
| Antwortformat | Normalisierte SocQ-Datensätze | Native Threads-Graph-API-Objekte |
So funktioniert die Threads API
Profiles, Posts und User Posts nutzen denselben asynchronen Aufgabenablauf mit paginierten Ergebnissen.
1. Öffentliche URLs senden
Senden Sie Profil- oder Beitrags-URLs an die passende API und speichern Sie die zurückgegebene task_id.
2. Aufgabe verfolgen
Fragen Sie /v1/tasks/{task_id} ab, bis die Verarbeitung abgeschlossen ist.
3. Ergebnisse abrufen
Lesen Sie data.results.items und verwenden Sie next_cursor, solange has_more den Wert true hat.
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 trueTypische 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.
Daten verschiedener Plattformen kombinieren und umfassendere Geschäftseinblicke gewinnen
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.
Bluesky API
Rufen Sie öffentliche Bluesky-Profile ab, lösen Sie URLs bekannter Beiträge auf oder erfassen Sie eine Seite mit Kontobeiträgen – mit normalisierter Identität, Inhalt, Medien, Zeitstempeln und sichtbaren Interaktionsfeldern.
Snapchat API
Ein bekanntes öffentliches Snapchat-Spotlight als normalisierten Datensatz abrufen – mit verfügbaren Feldern zu Creator, Bildunterschrift, Medien, Audio, Zeitstempel, Dauer und Engagement.
Twitch API
Wandeln Sie einen bekannten öffentlichen Twitch-Benutzernamen in ein normalisiertes Profil um, erfassen Sie dessen öffentlichen Videobestand oder laden Sie einen einzelnen Clip samt herunterladbarem Video für Creator-Recherche, Kataloganreicherung, Vergleiche und die Beobachtung per Momentaufnahme.
Rednote API
Rufen Sie öffentliche Profile und Notes ab, suchen Sie nach Notes oder Nutzern, erfassen Sie Kommentare und verschachtelte Antworten und holen Sie eine Seite mit Empfehlungen der Startseite.
Kwai API
Rufen Sie öffentliche Kwai-Profile, eine Seite mit Kontobeiträgen oder einen bekannten Beitrag ab – mit normalisierten Angaben zu Identität, Inhalt, Medien, Zeitstempeln und sichtbarem Engagement.
Truth Social API
Rufen Sie öffentliche Kontodetails ab, erfassen Sie eine Quellseite mit Kontobeiträgen oder wandeln Sie die URL eines bekannten Beitrags in normalisierte Datensätze um.