Geeignete Reddit-API-Endpunkte zur Abfrage der am meisten upgevoteten Beiträge
- Grundlagen der Reddit-API
- Endpunkt zum Abrufen der "Top"-Beiträge
- Endpunkt für allgemeine beliebte Beiträge
- Allgemeine API-Route für alle Subreddits
- Authentifizierung und Einschränkungen
- Zusammenfassung
Grundlagen der Reddit-API
Reddit bietet eine RESTful API, über die man verschiedene Daten von der Plattform abrufen kann. Viele dieser API-Endpunkte sind öffentlich nutzbar, allerdings sind Zugriffsbeschränkungen oder Authentifizierungen bei bestimmten Endpunkten notwendig, besonders wenn man persönliche oder erweiterte Daten abfragen möchte. Die meisten Daten zur öffentlichen Beitragsanzeige können allerdings auch ohne tiefe Authentifizierung erhalten werden.
Endpunkt zum Abrufen der "Top"-Beiträge
Um die am meisten upgevoteten Posts auf Reddit zu erhalten, ist der wichtigste API-Endpunkt der, der die Beiträge nach ihrer Beliebtheit sortiert bereitstellt. Der offizielle Endpunkt lautet in der Form:
https://www.reddit.com/r/{subreddit}/top.jsonHierbei ersetzt man {subreddit} durch den gewünschten Subreddit, z. B. "all" für alle Communities oder "funny" für einen bestimmten. Mit diesem Endpunkt erhält man die Top-Beiträge nach ihrer Punktzahl (Upvotes minus Downvotes). Man kann zusätzlich durch URL-Parameter die Zeitspanne eingrenzen, z.B.:
?t=day (Top des Tages)?t=week (Top der Woche)?t=month (Top des Monats)?t=year (Top des Jahres)?t=all (Top aller Zeiten) https://www.reddit.com/r/all/top.json?t=month&limit=10Endpunkt für allgemeine beliebte Beiträge
Neben dem expliziten top-Endpunkt existiert auch die Möglichkeit, über den hot-Endpunkt Beiträge zu erhalten, die aktuell populär sind:
https://www.reddit.com/r/{subreddit}/hot.jsonDie hot-Beiträge sind nicht unbedingt die am meisten upgevoteten insgesamt, sondern eine Mischung aus Aktualität und Popularität. Für reine Upvote-Zahlen ist daher top die zuverlässigere Wahl.
Allgemeine API-Route für alle Subreddits
Möchte man globale Daten ohne Eingrenzung auf einen einzelnen Subreddit, kann man die Endpunkte auf /r/all/ verwenden, zum Beispiel:
https://www.reddit.com/r/all/top.json?t=yearDiese Anfrage gibt die beliebtesten Beiträge über alle Subreddits hinweg aus, sortiert nach der Gesamtpunktzahl des Jahres.
Authentifizierung und Einschränkungen
Diese Endpunkte sind semi-öffentlich und häufig ohne OAuth-Token nutzbar, allerdings kann Reddit Anfragen limitieren, besonders bei hoher Zugriffszahl oder ohne Authentifizierung. Für umfangreichere und stabilere Nutzung empfiehlt sich die Verwendung des offiziellen Reddit-APIs mit OAuth 2.0, dabei richtet man eine Entwickleranwendung ein. Die URL-Struktur bleibt jedoch dieselbe, nur dass der Zugriff authentifiziert erfolgt.
Zusammenfassung
Zur Abfrage der am meisten upgevoteten Beiträge eignet sich insbesondere der Endpunkt /r/{subreddit}/top.json, bei dem man durch den Parameter t den Zeitrahmen bestimmen kann. Für eine globale Übersicht empfiehlt sich /r/all/top.json. Diese Informationen lassen sich unkompliziert abrufen und ermöglichen die Aggregation der beliebtesten Beiträge auf Reddit.