Zurück zu den APIs
Öffentliche Rednote-Daten

Rednote Public Data APIs

Rufen Sie öffentliche Profile und Notes ab, suchen Sie nach Notes oder Nutzern, erfassen Sie Kommentare und verschachtelte Antworten und holen Sie eine Seite mit Empfehlungen der Startseite.

Verfügbare Rednote-APIs

Wählen Sie unter acht APIs für Abläufe rund um Profile, Notes, Kommentare, Antworten, Suche und Empfehlungen.

Welche Rednote-Daten können Sie abrufen?

Der Rednote-Katalog liefert normalisierte Konto-, Beitrags- und Kommentardatensätze aus öffentlichen Quelldaten.

Profile und Notes von Nutzern

Löst ein öffentliches Profil auf oder erfasst eine Quellseite mit Notes über eine unterstützte Konto-URL oder user_id.

Note-Details und Entdeckung

Ruft eine Note-URL mit Token ab, sucht Notes mit unterstützten Filtern oder erfasst eine Seite mit Empfehlungen der Startseite.

Nutzersuche

Durchsucht die feste erste Quellseite öffentlicher Konten mit einer nicht leeren Abfrage.

Kommentare und Antworten

Erfasst eine Seite öffentlicher Kommentare zu einer Note oder eine Seite mit Antworten zu einer bekannten Kommentar-ID.

Spezifikationen der Rednote-APIs im Überblick

Jeder Endpunkt hat eine begrenzte Quellanfrage und lehnt nicht deklarierte Parameter ab.

API-GruppeAusgangseingabeQuellgrenze
Profil und Notes von Nutzernurl oder user_idEin Profil oder eine Quellseite; kein results_limit
Note-DetailsUnterstützte URL mit Note-Pfad und xsec_tokenHöchstens ein Note-Datensatz
SucheNicht leere Abfrage und unterstützte optionale EnumsFeste erste Quellseite; kein results_limit
Kommentare und AntwortenUnterstützte Note-URL; Antworten erfordern zusätzlich comment_idEine Antwortseite der Quelle
Empfehlungen der StartseiteAlle Felder optionalEine Seite mit results_limit von 1–40, Standardwert 20

So funktionieren die Rednote-APIs

Alle acht Endpunkte nutzen denselben asynchronen Ablauf aus Senden, Abfragen und Lesen gespeicherter Ergebnisse.

  1. 1. Endpunkt wählen

    Wählen Sie für Ihre Aufgabe mit öffentlichen Daten den Endpunkt für Profil, Note, Suche, Kommentar, Antwort oder Empfehlung.

  2. 2. Gültige Eingabe senden

    Senden Sie per POST nur die deklarierten Felder und speichern Sie die zurückgegebene task_id.

  3. 3. Normalisierte Ergebnisse lesen

    Fragen Sie die Aufgabe bis zu einem Endzustand ab, lesen Sie dann data.results.items und verwenden Sie next_cursor nur für die Paginierung gespeicherter Ergebnisse.

Öffentliche Rednote-Notes suchen

Authentifizieren Sie sich mit einem SocQ-API-Schlüssel und senden Sie eine Abfrage mit unterstützten optionalen Filtern. Jede erfolgreiche Rednote-Aufgabe kostet pauschal 1 Credit.

curl -X POST "https://api.socq.ai/v1/rednote/search-notes" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"travel guide","sort_by":"general","media_type":"all"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after success

Typische Anwendungsfälle der Rednote API

Creator- und Inhaltsrecherche

Verbinden Sie die öffentliche Kontoidentität mit einer begrenzten Seite eigener Notes.

Themensuche

Vergleichen Sie Momentaufnahmen aus Note-Suche, Nutzersuche und Empfehlungen der Startseite anhand ihrer Erfassungszeitstempel.

Prüfung von Unterhaltungen

Prüfen Sie die Kommentare einer öffentlichen Note und die verschachtelten Antworten eines ausgewählten Kommentars als normalisierte Datensätze.

Grenzen und Richtlinie für öffentliche Daten

Diese Endpunkte lesen öffentliche Daten über begrenzte Quellanfragen und bieten weder Kontoaktionen noch privaten Zugriff.

  • Unterstützte URL-Hosts sind xiaohongshu.com, xhslink.com und ihre Subdomains; Note Detail erfordert zusätzlich einen Pfad /explore/{id} oder /discovery/item/{id} und ein nicht leeres xsec_token.
  • user_id und comment_id akzeptieren 1–256 ASCII-Buchstaben, Ziffern, Doppelpunkte, Unterstriche oder Bindestriche.
  • Search Notes akzeptiert sort_by, media_type und published_within nur mit den aufgeführten Enum-Werten; Search Users akzeptiert nur query.
  • Nur Home Recommendations akzeptiert results_limit, mit einem Bereich von 1–40 und dem Standardwert 20.
  • Jede erfolgreiche Rednote-Aufgabe kostet pauschal 1 Credit.

Häufige Fragen zur Rednote API

Was sind die Rednote-APIs?

Die Rednote-APIs rufen öffentliche Profile, Notes, Kommentare, verschachtelte Antworten, Suchergebnisse und Empfehlungen der Startseite als normalisierte Datensätze ab.

Welcher Endpunkt akzeptiert results_limit?

Nur Home Recommendations akzeptiert results_limit, als ganze Zahl von 1 bis 40. Die übrigen Rednote-Endpunkte lehnen es ab.

Akzeptiert Note Detail jede Rednote-URL?

Nein. Erforderlich sind ein akzeptierter Host, ein Pfad /explore/{id} oder /discovery/item/{id} und ein nicht leerer Abfragewert xsec_token.

Wie werden Rednote-Anfragen abgerechnet?

Jede erfolgreiche Aufgabe kostet pauschal 1 SocQ-Credit.

Führen Sie öffentliche Profile, Inhalte und Interaktionsdaten verschiedener Plattformen in einem Workflow zusammen, um Marken, Creator und Themen zu verfolgen und plattformübergreifend effizienter zu überwachen und zu analysieren.