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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliche 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_limit | Optional | Maximale 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.
- Bereiten Sie eine oder mehrere öffentliche Threads-Profil-URLs mit dem Pfad /@username auf threads.com oder threads.net vor.
- Senden Sie urls und optional results_limit per POST an /v1/threads/user-posts 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/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 trueAnwendungsfä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.
Verwandte APIs
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.