Rednote Home Recommendations
Eine Anfrage nach Empfehlungen der Startseite ruft eine öffentliche Rednote-Feedseite ab, ohne ein Profil, eine Note-URL oder einen Suchbegriff zu verlangen. Jeder verfügbare Eintrag wird in einen Standard-Datensatz mit Quellidentität, Text, Autor, Medien, sichtbarer Interaktion, Veröffentlichungszeit und Erfassungszeit überführt.
Funktionen der Rednote Home Recommendations API
- Anfrage an den Startseiten-Feed ohne AusgangsdatenSenden Sie einen leeren Body oder die geprüfte Kategorie homefeed_recommend, um eine aktuelle Empfehlungsseite anzufordern, ohne einen Nutzer oder eine Abfrage vorgeben zu müssen.
- Begrenzte SeitengrößeFordern Sie eine ganze Zahl von 1 bis 40 an; ohne Angabe gilt 20, wobei die zurückgegebene Seite weniger öffentliche Einträge enthalten kann.
- Anbieterunabhängige Struktur der NotesLesen Sie verfügbare Angaben zu Note-Identität, Text, Autor, Medien, Zeitstempeln und sichtbaren Kennzahlen über das gemeinsame Beitragsschema statt über Feldnamen des Anbieters.
- Dauerhafte asynchrone ErgebnisseSenden Sie einmal, verfolgen Sie den Aufgabenstatus und blättern Sie durch die Datensätze, die SocQ gespeichert hat, nachdem die einzelne Antwort des Anbieters normalisiert wurde.
Parameter der Rednote Home Recommendations API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
category | Optional | Optionale, nicht leere Zeichenfolge. Fehlt sie, setzt die Zuordnung zum Anbieter homefeed_recommend ein. Das ist die einzige vom Backend definierte Kategorie, die hier dokumentiert ist; andere Zeichenfolgen werden nicht als geprüfte Kategorien dargestellt. |
media_type | Optional | Optionales Enum: all, image oder video. Die aktuelle Zuordnung setzt das Bildkennzeichen des Anbieters nur für image; all und video werden beide auf false abgebildet, sodass video keine Antwort garantiert, die ausschließlich Videos enthält. |
results_limit | Optional | Optionale positive ganze Zahl von 1 bis 40. Der Standardwert ist 20; sie legt die angeforderte Seitengröße beim Anbieter fest und begrenzt bei ausdrücklicher Angabe die gespeicherten Zeilen. |
So verwenden Sie die Rednote Home Recommendations API
Wählen Sie nur geprüfte optionale Werte, senden Sie die asynchrone Anfrage und lesen Sie die gespeicherten Standardergebnisse.
- Beginnen Sie mit den Standardwerten des Backends oder legen Sie category, media_type und results_limit ausdrücklich fest.
- Senden Sie den JSON-Body per POST an /v1/rednote/home-recommendations und speichern Sie data.task_id aus der Antwort auf das Senden.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler meldet.
- Lesen Sie data.results.items; folgen Sie next_cursor nur, wenn has_more auf weitere von SocQ gespeicherte Datensätze verweist.
curl -X POST "https://api.socq.ai/v1/rednote/home-recommendations" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"category":"homefeed_recommend","media_type":"all","results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; next_cursor paginates stored results onlyAnwendungsfälle der Rednote Home Recommendations API
- Momentaufnahmen der Empfehlungsseite: Erfassen Sie eine begrenzte öffentliche Seite des Startseiten-Feeds mit collected_at, damit jeder Eintrag an eine Beobachtung gebunden bleibt.
- Redaktionelle Entdeckungswarteschlangen: Leiten Sie normalisierte Note-Texte, Autoren und Medienverweise in einen Workflow für manuelle Prüfung oder Klassifizierung weiter.
- Audits sichtbarer Inhalte: Vergleichen Sie die verfügbare Mischung der Medien und die öffentlichen Interaktionsfelder über getrennt gesendete Empfehlungsaufgaben hinweg.
Profi-Tipps zur Rednote Home Recommendations API
- Verwenden Sie {}, wenn Sie alle Standardwerte des Anbieters nutzen möchten; der öffentliche Validator der Anfrage verlangt kein einziges Feld.
- Belassen Sie category bei homefeed_recommend, solange Sie keine andere Kategorie des Anbieters unabhängig geprüft haben; die Laufzeit akzeptiert eine nicht leere Zeichenfolge, veröffentlicht aber kein Enum für Kategorien.
- Gehen Sie mit media_type=video vorsichtig um, denn es wird derzeit auf dasselbe Kennzeichen des Anbieters abgebildet wie all; nur image ändert dieses Kennzeichen.
- Wählen Sie results_limit zwischen 1 und 40 und gehen Sie nicht davon aus, dass der Anbieter genau die angeforderte Zahl öffentlicher Einträge zurückgibt.
- Senden Sie keinen Cursor des Anbieters: Der vorgelagerte Ausführer stellt eine einzige Anfrage und liest items, notes oder feeds aus dieser einen Antwort.
- Verwenden Sie next_cursor nur, um nach einem Erfolg durch von SocQ gespeicherte Ergebnisse zu blättern; er ruft keine weitere Rednote-Seite ab.
- Planen Sie pro Aufgabe pauschal 1,00 SocQ-Credit ein; die Gebühr wächst weder mit dem gewählten Limit noch mit der Zahl der zurückgegebenen Einträge.
Verwandte APIs
Ergänzend zur Rednote Home Recommendations API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Rednote-Daten benötigen.