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.

rednote/comment-replies
Kommentare1 Credit pro Anfrage

rednote/home-recommendations
Beiträge1 Credit pro Anfrage

rednote/note-comments
Kommentare1 Credit pro Anfrage

rednote/note-detail
Beiträge1 Credit pro Anfrage

rednote/search-notes
Suche1 Credit pro Anfrage

rednote/search-users
Suche1 Credit pro Anfrage

rednote/user-notes
Beiträge1 Credit pro Anfrage

rednote/user-profile
Profile1 Credit pro Anfrage
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-Gruppe | Ausgangseingabe | Quellgrenze |
|---|---|---|
| Profil und Notes von Nutzern | url oder user_id | Ein Profil oder eine Quellseite; kein results_limit |
| Note-Details | Unterstützte URL mit Note-Pfad und xsec_token | Höchstens ein Note-Datensatz |
| Suche | Nicht leere Abfrage und unterstützte optionale Enums | Feste erste Quellseite; kein results_limit |
| Kommentare und Antworten | Unterstützte Note-URL; Antworten erfordern zusätzlich comment_id | Eine Antwortseite der Quelle |
| Empfehlungen der Startseite | Alle Felder optional | Eine 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. 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. Gültige Eingabe senden
Senden Sie per POST nur die deklarierten Felder und speichern Sie die zurückgegebene task_id.
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.
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 successTypische 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.
Daten verschiedener Plattformen kombinieren und umfassendere Geschäftseinblicke gewinnen
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.
Kwai API
Rufen Sie öffentliche Kwai-Profile, eine Seite mit Kontobeiträgen oder einen bekannten Beitrag ab – mit normalisierten Angaben zu Identität, Inhalt, Medien, Zeitstempeln und sichtbarem Engagement.
Truth Social API
Rufen Sie öffentliche Kontodetails ab, erfassen Sie eine Quellseite mit Kontobeiträgen oder wandeln Sie die URL eines bekannten Beitrags in normalisierte Datensätze um.
Google Ad Library API
Finden Sie öffentliche Werbetreibende, erfassen Sie die Creatives eines Unternehmens oder rufen Sie ein bekanntes Creative aus dem Transparency Center per URL ab – für Recherche und Prüfung.
Google Maps API
Finden Sie öffentliche Orte, rufen Sie normalisierte Details zu bekannten Maps-URLs ab und erfassen Sie öffentliche Bewertungen mit quellenverknüpftem Orts- und Autorenkontext.
Amazon API
Durchsuchen Sie öffentliche Amazon-Produkte und erfassen Sie normalisierte Produktdetails, Bestseller, Bewertungen, Verkäuferprofil-Datensätze und Creator-Storefronts aus unterstützten Marktplätzen.
Apple App Store API
Erfassen Sie öffentliche Apple-App-Store-App-Details, Kategorie-Rankings und Bewertungen aus bekannten Store-URLs als normalisierte App- und Bewertungsdatensätze.