Truth Social Profile
Truth Social Profile fragt ein bekanntes öffentliches Konto ab. Übergeben Sie einen Benutzernamen, um einen normalisierten Kontodatensatz zu erhalten, den Sie direkt für Anreicherung, Prüfung und geplante Profil-Momentaufnahmen verwenden können.
Funktionen der Truth Social Profile API
- Exakte Abfrage per BenutzernameFragen Sie pro Aufgabe einen bekannten öffentlichen Benutzernamen ab, ohne unscharfe Kontosuche und ohne Profil-URLs.
- Einheitliche KontoidentitätErhalten Sie Konto-ID, Benutzername, Anzeigename, öffentliche Profil-URL, Biografie und Erfassungszeitpunkt in festen Feldern.
- ProfildetailsRuft Avatar, Titelbild, Website, Standort, Verifizierungsstatus und Datenschutzstatus ab, sofern sie öffentlich verfügbar sind.
- Momentaufnahme der sichtbaren KennzahlenHält die zum Erfassungszeitpunkt beobachteten Zahlen zu Followern, Gefolgten und Beiträgen für spätere Vergleiche fest.
Parameter der Truth Social Profile API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
username | Erforderlich | Erforderlicher öffentlicher Benutzername aus 1–64 ASCII-Buchstaben, Ziffern, Punkten, Unterstrichen oder Bindestrichen. Die Validierung erlaubt ein führendes @, empfohlen wird jedoch der kanonische Benutzername ohne @. Profil-URLs werden nicht akzeptiert. |
So verwenden Sie die Truth Social Profile API
Übergeben Sie einen öffentlichen Benutzernamen, speichern Sie die Aufgaben-ID und lesen Sie nach Abschluss das Kontoergebnis.
- Geben Sie einen bekannten Truth-Social-Benutzernamen wie realDonaldTrump ein. Für eine zuverlässige Auflösung verwenden Sie den Benutzernamen ohne führendes @.
- Senden Sie username per POST an /v1/truth-social/profile und speichern Sie data.task_id aus der Antwort.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis data.status den Wert succeeded oder failed hat.
- Lesen Sie nach einem Erfolg den normalisierten Kontodatensatz aus data.results.items.
curl -X POST "https://api.socq.ai/v1/truth-social/profile" \
-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 Profile API
- Kontoanreicherung: Ergänzen Sie öffentliche Identität, Biografie, Profilbilder, Website und sichtbare Kennzahlen bei einem Datensatz, der bereits einen Benutzernamen enthält.
- Kontoprüfung: Wandeln Sie öffentliche Profile in einheitliche Felder für interne Prüfung, Klassifizierung und manuelle Kontrolle um.
- Verfolgung von Profiländerungen: Speichern Sie geplante Momentaufnahmen und vergleichen Sie Biografie, Bildmaterial, Status und Kennzahlen anhand von collected_at.
Profi-Tipps zur Truth Social Profile API
- Speichern Sie den kanonischen Benutzernamen ohne @, um mehrere Schreibweisen desselben Kontos zu vermeiden.
- Eine gültige Syntax garantiert nicht, dass ein Konto existiert, öffentlich ist oder aktuell zugänglich ist.
- Behandeln Sie Profilbilder, Website, Standort, Status und Kennzahlen als nullable Felder der Quelle.
- Dieser Endpunkt liefert nur Kontodetails. Für öffentliche Beiträge nutzen Sie Truth Social User Posts API.
- Senden Sie weder results_limit noch einen Quell-Cursor; jede Aufgabe führt eine einzelne Kontoabfrage aus.
Verwandte APIs
Ergänzend zur Truth Social Profile 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 User Posts API — Eine Quellseite öffentlicher Truth-Social-Beiträge per Benutzername oder numerischer Konto-ID erfassen – mit normalisierten Inhalten, Autoren, Medien, Zeitstempeln und sichtbaren Interaktionen.