rednote/
search-notes

Öffentliche Rednote-Notes per Textabfrage mit optionalen Filtern für Sortierung, Medien und Zeitraum durchsuchen – mit normalisierten Inhalten, Autoren, Medien, Zeitstempeln und sichtbarer Interaktion.

Rednote Search Notes API

Note-Suche per Stichwort
Filter für Sortierung und Medien
Öffentliche Momentaufnahme mit einer Seite
1 Credit pro Anfrage
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

Rednote Search Notes

Die Treffer von Rednote Search Notes sind öffentliche Beiträge, die zu einem Stichwort passen, mit Note-Identität, Text, Autorenkontext, Medien, Veröffentlichungszeit und sichtbarer Interaktion. Diese Datensätze unterstützen die Themenrecherche, den Vergleich von Formaten, die Quellenprüfung und die Analyse von Suchergebnissen per Momentaufnahme.

Funktionen der Rednote Search Notes API

  • Stichwortsuche mit drei FilterdimensionenAkzeptiert eine Textabfrage sowie unterstützte Auswahlen für Sortierung, Medientyp und Veröffentlichungszeitraum, um eine fokussierte Suche nach öffentlichen Notes zu definieren.
  • Normalisierte Note-Identität und InhalteLiefert Note-IDs, öffentliche URLs, Text, Ressourcentyp, Veröffentlichungszeit und Erfassungszeit in der gemeinsamen Struktur PostItem.
  • Kontext zu Autor, Medien und sichtbarer InteraktionBewahrt verfügbare öffentliche Autorenfelder, Bild- oder Videoverweise, Hashtags, Erwähnungen und die sichtbaren Zahlen zu Likes, Kommentaren, Teilen und Aufrufen.
  • Begrenzte Seite der QuellsucheFührt Seite 1 der gewählten Suche einmal pro Aufgabe aus und erzeugt so eine definierte Momentaufnahme, statt einen vollständigen Abruf über mehrere Quellseiten zu behaupten.

Parameter der Rednote Search Notes API

ParameterErforderlichBeschreibung
queryErforderlichErforderlicher, nicht leerer Text, mit dem öffentliche Rednote-Notes gesucht werden; der Playground lässt ihn leer, bis Sie einen eigenen Begriff eingeben.
sort_byOptionalOptionale Sortierung der Ergebnisse: general, latest oder most_liked. Der Playground beginnt mit general.
media_typeOptionalOptionaler Filter nach Note-Format: all, image oder video. Der Playground beginnt mit all.
published_withinOptionalOptionaler Filter für den Veröffentlichungszeitraum: all, day, week oder six_months. Der Playground beginnt mit all.

So verwenden Sie die Rednote Search Notes API

Senden Sie eine Rednote-Suchabfrage mit optionalen Filtern, verfolgen Sie die asynchrone Aufgabe und lesen Sie die gespeicherten Note-Datensätze mit der Cursor-Paginierung von SocQ.

  1. Bereiten Sie eine nicht leere query vor und wählen Sie nur unterstützte Werte für sort_by, media_type und published_within.
  2. Senden Sie die Nutzlast per POST an /v1/rednote/search-notes und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler meldet.
  4. Lesen Sie data.results.items und folgen Sie next_cursor, solange has_more den Wert true hat; das blättert durch gespeicherte Ergebnisse, nicht durch weitere Rednote-Suchseiten.
curl -X POST "https://api.socq.ai/v1/rednote/search-notes" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"query\":\"$REDNOTE_SEARCH_QUERY\",\"sort_by\":\"general\",\"media_type\":\"all\",\"published_within\":\"all\"}"

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Anwendungsfälle der Rednote Search Notes API

  • Katalogisierung von Stichwortergebnissen: Nutzen Sie Note-IDs, öffentliche URLs, Text, Autorenverweise und collected_at, um eine nachvollziehbare Momentaufnahme für eine definierte Abfrage aufzubauen.
  • Vergleich von Bild- und Videoergebnissen: Führen Sie getrennte Auswahlen für media_type aus und vergleichen Sie zurückgegebene Medienverweise, Note-Texte und sichtbare Interaktion über die entstehenden Momentaufnahmen hinweg.
  • Themenprüfung mit Fokus auf Aktualität: Kombinieren Sie die Sortierung latest oder einen Veröffentlichungszeitraum mit published_at und collected_at, um kürzlich aufgetauchte Notes zu einem Thema zu prüfen.
  • Analyse des Autorenkontexts: Ordnen Sie Text und Medien der gefundenen Notes den verfügbaren Feldern zur Autorenidentität zu, um zu untersuchen, welche öffentlichen Konten in der Momentaufnahme einer Abfrage erscheinen.

Profi-Tipps zur Rednote Search Notes API

  • Kürzen Sie die Abfrage um überflüssige Leerzeichen und prüfen Sie vor dem Senden, dass sie nicht leer ist, damit die Validierung des Pflichtfelds die Aufgabe nicht ablehnt.
  • Verwenden Sie nur die dokumentierten Enum-Werte; wählen Sie general, all und all, wenn Sie die breiteste ausdrücklich konfigurierte Suche wünschen.
  • Behandeln Sie jede Aufgabe als eine Quellseite der Suche und führen Sie für unterschiedliche Filterkombinationen getrennte Aufgaben aus, statt anzunehmen, dass die Momentaufnahme spätere Quellseiten abdeckt.
  • Folgen Sie next_cursor, bis has_more den Wert false hat, wenn die gespeicherte Momentaufnahme mehrere Ergebnisseiten von SocQ umfasst; dieser Cursor fordert nie eine weitere Rednote-Quellseite an.
  • Nutzen Sie Note-ID und URL, um getrennte Abfragedurchläufe abzugleichen, denn Reihenfolge und sichtbare Kennzahlen können sich zwischen den Erfassungszeitpunkten unterscheiden.
  • Behandeln Sie Text, Autorenfelder, Medien, Veröffentlichungszeit, Hashtags, Erwähnungen und einzelne Kennzahlen als Felder, die null sein können, und maskieren Sie öffentlichen Text, bevor Sie ihn darstellen.

Ergänzend zur Rednote Search Notes API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Rednote-Daten benötigen.

Weitere Plattformen entdecken

Kombinieren Sie Rednote-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Rednote Search Notes API — FAQ

Rednote Search Notes API findet öffentliche Rednote-Notes anhand einer Textabfrage mit optionalen Filtern für Sortierung, Medientyp und Veröffentlichungszeitraum und liefert normalisierte Felder zu Note-Identität, Text, Autorenkontext, Medien, Zeitstempeln und sichtbarer Interaktion.

query ist erforderlich. sort_by akzeptiert general, latest oder most_liked; media_type akzeptiert all, image oder video; published_within akzeptiert all, day, week oder six_months.

Das Standardbeispiel verwendet die query 旅行攻略 mit sort_by general und media_type all, während published_within weggelassen wird. Der Endpunkt akzeptiert weder results_limit noch eine Seitenzahl oder einen Quell-Cursor.

Jedes PostItem kann Note-ID, URL, Text, Autorendetails, Medien, Veröffentlichungs- und Erfassungszeitstempel, Hashtags, Erwähnungen und die sichtbaren Zahlen zu Likes, Kommentaren, Teilen und Aufrufen enthalten. Optionale Quellwerte bleiben null, wenn sie nicht verfügbar sind.

Nein. Jede Aufgabe fordert Quellseite 1 einmal an; next_cursor liest nur die nächste Seite von Ergebnissen, die SocQ bereits gespeichert hat, mit Limits für Aufgabenergebnisse von 1 bis 500 und dem Standardwert 50.

Jede Aufgabe kostet pauschal 1 SocQ-Credit. Die Zahl der gespeicherten oder zurückgegebenen Notes ändert diese feste Gebühr pro Aufgabe nicht.