Truth Social User Posts
Truth Social User Posts ruft Beiträge eines bekannten öffentlichen Kontos ab. Jede Aufgabe identifiziert das Konto per Benutzername oder numerischer user_id, führt eine einzelne Erfassungsanfrage aus und liefert einheitliche Beitragsdatensätze.
Funktionen der Truth Social User Posts API
- Zwei Konto-KennungenVerwenden Sie einen öffentlichen Benutzernamen oder eine user_id, die nur aus Ziffern besteht. Mindestens eine Kennung ist erforderlich.
- Ein Stapel pro AufgabeJede Aufgabe führt eine Erfassung der Beiträge eines Kontos aus und liefert die in dieser Antwort verfügbaren öffentlichen Beiträge, ohne weitere Seiten der Quelle abzurufen.
- Normalisierter BeitragsinhaltErhalten Sie Beitrags-ID, URL, Text, Autor, Veröffentlichungs- und Erfassungszeitpunkt, Medien, Hashtags und Erwähnungen in festen Feldern.
- Sichtbare InteraktionBewahrt die verfügbaren Zahlen zu Likes, Kommentaren, Shares und Aufrufen und lässt nicht verfügbare Werte als null.
Parameter der Truth Social User Posts API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
username | Erforderlich (mindestens eines) | Öffentlicher Benutzername mit optionalem führendem @, gefolgt von 1–64 ASCII-Buchstaben, Ziffern, Punkten, Unterstrichen oder Bindestrichen. Führende oder nachgestellte Leerzeichen und Profil-URLs werden nicht akzeptiert. |
user_id | Erforderlich (mindestens eines) | Konto-ID aus reinen Ziffern. Sie kann username ersetzen oder zusammen mit dem passenden username übergeben werden. |
trim | Optional | Optionaler boolescher Wert. Übergeben Sie true oder false, wenn Sie die Option ausdrücklich setzen möchten; lassen Sie das Feld weg, wenn Sie es nicht senden möchten. |
So verwenden Sie die Truth Social User Posts API
Geben Sie einen Benutzernamen oder eine user_id an, speichern Sie die Aufgaben-ID und lesen Sie nach dem Erfolg der Aufgabe die Beitragsliste.
- Geben Sie einen öffentlichen Benutzernamen oder eine user_id aus reinen Ziffern ein. In den meisten Fällen genügt eine einzige Kennung.
- Senden Sie die Eingabe per POST an /v1/truth-social/user-posts und speichern Sie data.task_id aus der Antwort.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder fehlschlägt.
- Lesen Sie nach einem Erfolg data.results.items. Folgen Sie next_cursor nur, wenn has_more für die gespeicherten Ergebnisse true ist.
curl -X POST "https://api.socq.ai/v1/truth-social/user-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"realDonaldTrump"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after successAnwendungsfälle der Truth Social User Posts API
- Momentaufnahmen der Inhalte eines Kontos: Speichern Sie die aktuell verfügbaren öffentlichen Beiträge für Archivierung, Prüfung oder geplante Vergleiche.
- Inhaltsanalyse: Klassifizieren, durchsuchen und verarbeiten Sie Beiträge anhand einheitlicher Felder für Text, Autor, Medien und Zeitstempel.
- Beobachtung der Interaktion: Vergleichen Sie die sichtbaren Likes, Kommentare, Shares und Aufrufe zusammen mit collected_at als Beobachtungszeitpunkt.
Profi-Tipps zur Truth Social User Posts API
- Bevorzugen Sie einen geprüften Benutzernamen. Wenn das Ergebnis eines anderen Kontos eine numerische author.id liefert, können Sie sie als user_id wiederverwenden.
- Tragen Sie keine Profil-URL in username oder user_id ein.
- Wenn Sie beide Kennungen übergeben, stellen Sie sicher, dass sie auf dasselbe Konto verweisen, denn beide Werte werden weitergereicht.
- Dieser Endpunkt akzeptiert weder results_limit noch einen Quell-Cursor; jede Aufgabe erfasst genau einmal.
- next_cursor blättert nur durch gespeicherte Aufgabenergebnisse und erfasst keine weiteren Beiträge der Quelle.
Verwandte APIs
Ergänzend zur Truth Social User Posts API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Truth Social-Daten benötigen.
- Truth Social Post API — Eine bekannte Truth-Social-Beitrags-URL in normalisierte Inhalte, Autorenkontext, Medien, Zeitstempel und verfügbare sichtbare Interaktionen auflösen.
- Truth Social Profile API — Ein öffentliches Truth-Social-Profil per Benutzername abrufen – mit normalisierter Identität, Bio, Profilmedien, Kontomerkmalen, Ort, sichtbaren Zahlen und Erfassungskontext.