threads/
user-posts

Öffentliche Threads-Beiträge aus einer oder mehreren unterstützten Profil-URLs ermitteln – mit Beitragstext, Autorenkontext, Medien, Zeitstempeln und sichtbaren Interaktionen als normalisierte Datensätze.

Threads User Posts API

Eingabe per Profil-URL
Ergebnislimit pro Profil
Normalisierte öffentliche Beiträge
0,5 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 User Posts

Beiträge eines Threads-Profils sind öffentliche Veröffentlichungen, die auf ausgewählten Profilseiten ermittelt werden – mit Beitragstext, Autorenidentität, Medienverweisen, Veröffentlichungszeitpunkten und den sichtbaren Interaktionszahlen. Diese Datensätze und Erfassungszeitstempel eignen sich für die Archivierung von Kontoinhalten, die Formatrecherche und den Vergleich öffentlicher Interaktionen.

Funktionen der Threads User Posts API

  • Begrenzte profilbasierte ErmittlungNimmt eine oder mehrere öffentliche Threads-Profil-URLs entgegen und wendet results_limit separat auf jedes Profil an – mit dem Standardwert 100 und einem zulässigen Bereich von 1 bis 2.000.
  • Normalisierte Beitrags-, Autoren- und MediendatensätzeLiefert Beitragskennungen, Quell-URLs, Text, verfügbare Autorenidentität und öffentliche Medienverweise in einer einheitlichen Ergebnisstruktur.
  • Interaktions- und ErmittlungskontextHält die sichtbaren Zahlen zu Likes, Kommentaren, Reposts und Shares zusammen mit Veröffentlichungszeitpunkt, collected_at und dem übergebenen Profilkontext fest, sofern der Quelldatensatz sie bereitstellt.

Parameter der Threads User Posts API

ParameterErforderlichBeschreibung
urlsErforderlichErforderliche Liste öffentlicher Threads-Profil-URLs auf threads.com oder threads.net. Jeder Pfad muss /@username verwenden; reine Benutzernamen, Beitrags-URLs und fremde Pfade werden abgelehnt.
results_limitOptionalMaximale Anzahl angeforderter Beiträge pro Profil-URL; Standardwert 100, zulässig sind ganze Zahlen von 1 bis 2.000.

So verwenden Sie die Threads User Posts API

Senden Sie öffentliche Threads-Profil-URLs mit einem Ergebnislimit pro Profil, verfolgen Sie die asynchrone Aufgabe und lesen Sie die normalisierten Beiträge 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 urls und optional results_limit per POST an /v1/threads/user-posts 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/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

Anwendungsfälle der Threads User Posts API

  • Beitragsdatensätze ausgewählter Profile: Behalten Sie für eine festgelegte Gruppe öffentlicher Profile Beitrags-IDs, Quell-URLs, Text, Autorenfelder, Medienverweise, Zeitstempel und den übergebenen Profilkontext bei.
  • Inhalts- und Formatrecherche: Nutzen Sie Beitragstext, öffentliche Medienverweise, Autorenzuordnung und Veröffentlichungszeitpunkte, um wiederkehrende Themen und Inhaltsformate über ausgewählte Profile hinweg zu untersuchen.
  • Vergleich öffentlicher Interaktionen: Vergleichen Sie die sichtbaren Zahlen zu Likes, Kommentaren, Reposts und Shares über Profilsammlungen hinweg und verankern Sie jede Beobachtung mit collected_at.

Profi-Tipps zur Threads User Posts API

  • Prüfen Sie jede Eingabe vor dem Senden als threads.com- oder threads.net-Profil-URL der Form /@username, damit reine Benutzernamen, Beitragslinks und fremde Pfade die Anfrage nicht scheitern lassen.
  • Planen Sie die angeforderte Tiefe und die Credit-Schätzung vor der Anfrage als Anzahl der urls multipliziert mit results_limit, denn das Limit gilt separat für jedes Profil.
  • Speichern Sie discovery_input, input_url und collected_at mit jedem Ergebnis, damit nachgelagerte Datensätze das übergebene Profil und den Beobachtungszeitpunkt behalten.
  • Behandeln Sie Text, Autorenfelder, Medien, created_at und einzelne Kennzahlen als optional und schließen Sie nicht darauf, ob ein Datensatz ein Originalbeitrag, eine Antwort, ein Zitat oder ein Repost ist, weil kein Untertyp bereitgestellt wird.

Ergänzend zur Threads User Posts 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 Profiles API — Öffentliche Profilidentität, Bios, Bilder, Websites, sichtbare Kontozahlen und Erfassungskontext aus unterstützten Threads-Profil-URLs erfassen.
  • 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 User Posts API — FAQ

Threads User Posts API ermittelt öffentliche Beitragsdatensätze aus einer oder mehreren unterstützten Threads-Profil-URLs. Zurückgegeben werden normalisierter Beitragstext, Autorenkontext, Medien, Zeitstempel, sichtbare Interaktionen und der übergebene Profilkontext.

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 Datensätze können Beitrags-ID, URL, Text, öffentliche Autorenidentität, Medienverweise, die sichtbaren Zahlen zu Likes, Kommentaren, Reposts und Shares, created_at, collected_at sowie zusätzlichen Ermittlungs- oder Eingabekontext enthalten. Optionale Quellwerte können null oder leer sein.

results_limit hat den Standardwert 100 und akzeptiert ganze Zahlen von 1 bis 2.000. Es gilt für jede Profil-URL; zwei URLs mit results_limit 50 fordern also bis zu 100 Beiträge an.

Nein. Die normalisierte Antwort enthält keinen Beitragsuntertyp. Behandeln Sie jedes Element als öffentlichen Beitrag, der aus der übergebenen Profil-URL ermittelt wurde, und schließen Sie nicht darauf, ob es ein Originalbeitrag, eine Antwort, ein Zitat oder ein Repost ist.

Jeder zurückgegebene Beitragsdatensatz kostet 0,5 SocQ-Credits. Die Schätzung ergibt sich aus urls multipliziert mit results_limit; eine leere Ergebnismenge wird nicht berechnet.