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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Erforderlicher, nicht leerer Text, mit dem öffentliche Rednote-Notes gesucht werden; der Playground lässt ihn leer, bis Sie einen eigenen Begriff eingeben. |
sort_by | Optional | Optionale Sortierung der Ergebnisse: general, latest oder most_liked. Der Playground beginnt mit general. |
media_type | Optional | Optionaler Filter nach Note-Format: all, image oder video. Der Playground beginnt mit all. |
published_within | Optional | Optionaler 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.
- Bereiten Sie eine nicht leere query vor und wählen Sie nur unterstützte Werte für sort_by, media_type und published_within.
- Senden Sie die Nutzlast per POST an /v1/rednote/search-notes und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler meldet.
- 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 trueAnwendungsfä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.
Verwandte APIs
Ergänzend zur Rednote Search Notes API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Rednote-Daten benötigen.