truth-social/
user-posts

Geben Sie einen öffentlichen Benutzernamen oder eine numerische user_id ein, um verfügbare Beiträge eines Kontos mit normalisiertem Text, Autor, Medien, Zeitstempeln und Interaktionsdaten abzurufen.

Truth Social User Posts API

Benutzername oder user_id
Öffentliche Beiträge eines Kontos
0,19 Credits/Aufgabe
0,19 Credits pro Anfrage
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

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

ParameterErforderlichBeschreibung
usernameErforderlich (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_idErforderlich (mindestens eines)Konto-ID aus reinen Ziffern. Sie kann username ersetzen oder zusammen mit dem passenden username übergeben werden.
trimOptionalOptionaler 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.

  1. Geben Sie einen öffentlichen Benutzernamen oder eine user_id aus reinen Ziffern ein. In den meisten Fällen genügt eine einzige Kennung.
  2. Senden Sie die Eingabe per POST an /v1/truth-social/user-posts und speichern Sie data.task_id aus der Antwort.
  3. Fragen Sie GET /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder fehlschlägt.
  4. 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 success

Anwendungsfä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.

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.

Weitere Plattformen entdecken

Kombinieren Sie Truth Social-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Truth Social User Posts API — FAQ

Truth Social User Posts API ruft öffentliche Beiträge eines Kontos per Benutzername oder numerischer user_id ab und liefert normalisierten Text, Autor, Medien, Zeitstempel und sichtbare Interaktionsdaten.

Mindestens eines von beiden ist erforderlich. Verwenden Sie in den meisten Fällen username oder user_id, wenn Sie die numerische ID des Kontos bereits haben.

Ja, aber beide Werte werden an die Erfassung weitergereicht, sie sollten also dasselbe Konto bezeichnen.

trim ist ein optionaler boolescher Wert. Setzen Sie ihn nur, wenn Sie ausdrücklich true oder false wählen möchten; andernfalls kann er weggelassen werden.

Nein. Jede Aufgabe führt eine einzelne Erfassung bei der Quelle aus. next_cursor paginiert nur durch Datensätze, die für diese Aufgabe bereits gespeichert sind.

Jede erfolgreiche Aufgabe kostet pauschal 0,19 Credits, unabhängig von der Anzahl der zurückgegebenen Beiträge.