Reddit User Profile
Ein Reddit-Profil ist die öffentliche Kontoseite hinter einem u/-Namen und zeigt das Gesamt-Karma getrennt nach Posts und Kommentaren, die Zahl der verfassten Posts und Kommentare, das Erstellungsdatum, Beschreibung, Avatar, Trophäen sowie Abzeichen für verifizierte Konten und Reddit-Mitarbeiter. Zusammen zeigen diese Signale, wie etabliert und wie aktiv ein Konto ist, und helfen dabei, Creator zu prüfen, neue Konten oder Konten mit wenig Karma auszusortieren und einflussreiche Mitglieder einer Nische über längere Zeit zu verfolgen.
Funktionen der Reddit User Profile API
- Bis zu 100 Benutzernamen pro Anfrageusernames nimmt bis zu 100 Reddit-Namen mit oder ohne Präfix u/ an, und jedes existierende Konto kommt als eigene Zeile zurück.
- Karma nach Herkunft aufgeschlüsseltmetrics.karma_count liefert das Gesamt-Karma, während post_karma_count und comment_karma_count zeigen, ob es durch eigene Posts oder durch Kommentare entstanden ist.
- Aktivitätszahlen und Kontoalterposts_count und comments_count messen, wie viel das Konto beigetragen hat, und published_at hält den Zeitpunkt fest, an dem es erstellt wurde.
- Profilabzeichen und Trophäenis_verified, is_employee und is_nsfw übernehmen die Kontomerkmale von Reddit, trophies_count gibt die Zahl der Trophäen an, dazu kommen Anzeigename, Beschreibung, Avatar und Banner.
Parameter der Reddit User Profile API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
usernames | Erforderlich | Bis zu 100 Reddit-Benutzernamen mit oder ohne Präfix u/; jeder Name besteht aus 3 bis 20 Buchstaben, Ziffern, Bindestrichen oder Unterstrichen. |
So verwenden Sie die Reddit User Profile API
Senden Sie eine Liste von Reddit-Benutzernamen und lesen Sie eine Profilzeile pro existierendem Konto.
- Senden Sie {"usernames": ["spez", "GovSchwarzenegger"]} per POST an /v1/reddit/user-profile.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
- Lesen Sie die Profile aus results.items und fragen Sie mit results.next_cursor weiter ab, solange has_more true ist.
curl -X POST "https://api.socq.ai/v1/reddit/user-profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["spez","GovSchwarzenegger"]}'Anwendungsfälle der Reddit User Profile API
- Creator vor der Kontaktaufnahme prüfen: Prüfen Sie karma_count, posts_count und published_at, um sicherzugehen, dass ein Redditor, den Sie ansprechen möchten, schon lange und aktiv dabei ist.
- Neue Konten und Konten mit wenig Karma erkennen: Markieren Sie Benutzernamen mit jungem published_at und niedrigem karma_count, wenn Sie die Autoren hinter einer Welle ähnlicher Posts oder Kommentare prüfen.
- Eine Beobachtungsliste von Nischenkonten verfolgen: Fragen Sie dieselben Benutzernamen regelmäßig erneut ab und vergleichen Sie karma_count, posts_count und followers_count, um zu sehen, welche Mitglieder wachsen.
- Listen von Reddit-Namen anreichern: Ergänzen Sie aus Threads gesammelte Benutzernamen um Anzeigename, Beschreibung, avatar_url und Profil-url, damit Tabelle oder CRM zeigen, wer hinter jedem Namen steht.
Profi-Tipps zur Reddit User Profile API
- Bereinigen Sie die Namen vor dem Senden: Nach dem Präfix u/ muss jeder aus 3 bis 20 Buchstaben, Ziffern, Bindestrichen oder Unterstrichen bestehen, und ein einziger fehlerhafter Eintrag lässt die ganze Anfrage scheitern.
- Ordnen Sie Zeilen Ihrer Eingabe über den kleingeschriebenen Benutzernamen zu, denn ein Name, der zweimal in unterschiedlicher Schreibweise übergeben wird, wird nur einmal abgefragt und liefert eine Zeile.
- Teilen Sie Listen mit mehr als 100 Namen in Pakete zu 100 auf und führen Sie die Ergebnisse über id zusammen, die dauerhafte Reddit-Kennung des Kontos.
Verwandte APIs
Ergänzend zur Reddit User Profile API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Reddit-Daten benötigen.
- Reddit Posts API — Öffentliche Beitragstexte, Autoren, Community-Kontext, Medien, Zeitstempel und sichtbare Interaktionen aus unterstützten Reddit-URLs erfassen.
- Reddit Subreddit Details API
- Reddit User Posts API — Den Post-Verlauf eines Reddit-Nutzers über einen Benutzernamen sammeln, sortiert nach new, top oder hot, mit Titel und Text, Score, Kommentaren und Medien.
- Reddit User Comments API — Den Kommentarverlauf eines Reddit-Nutzers über einen Benutzernamen sammeln – mit Auszügen aus 300 Zeichen, Scores, Kommentarlinks und Post-IDs.
- Reddit User Active Subreddits API — Die Subreddits, in denen ein Reddit-Nutzer aktiv ist, über einen Benutzernamen auflisten – mit Mitgliederzahlen und Beschreibungen.
- Reddit Subreddit Rules API — Die nummerierten Regeln von Subreddits über ihre URLs abrufen, mit Kurztitel und vollständigem Text jeder Regel.