rednote/
search-users

Öffentliche Rednote-Konten mit einer Textabfrage durchsuchen – mit normalisierten Angaben zu Identität, Biografie, Kontomerkmalen und sichtbaren Reichweitenzahlen von einer Quellseite.

Rednote Search Users API

Textabfrage
Eine Quellseite
Normalisierte Konten
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 Users

Die Suche nach öffentlichen Rednote-Konten kann Identität, Biografie, Profilstatus und sichtbare Zahlen zu Reichweite oder Inhalten für Personen liefern, die zu einer Textabfrage passen. Normalisierte Kontodatensätze behalten die verfügbaren Quellfelder bei und ergänzen collected_at, damit sich das Auffinden und der Vergleich nachvollziehen lassen.

Funktionen der Rednote Search Users API

  • Kontosuche mit einer AbfrageSenden Sie eine nicht leere Abfrage, die dem Keyword des Anbieters auf dessen fest eingestellter erster Seite entspricht – ohne Steuerung der Quellseite und ohne zusätzliche Filter.
  • Normalisierte öffentliche IdentitätErhalten Sie eine stabile Kontostruktur mit den verfügbaren Feldern für ID, Benutzername, Anzeigename, Biografie, öffentliche URL, Profilbilder, Website, Verifizierung und Datenschutz.
  • Sichtbare Konto-MomentaufnahmeBehält die verfügbaren Zahlen zu Followern, Gefolgten und Beiträgen zusammen mit collected_at bei, sodass jeder zurückgegebene Wert an seinen Beobachtungszeitpunkt gebunden bleibt.

Parameter der Rednote Search Users API

ParameterErforderlichBeschreibung
queryErforderlichErforderliche, nicht leere Zeichenfolge, die dem Keyword des Anbieters zugeordnet wird. Dieser Endpunkt hat keine Felder für Enum-Werte, results_limit, Anbieter-Cursor, Sortierung oder Medienfilter.

So verwenden Sie die Rednote Search Users API

Senden Sie einen Suchbegriff für Konten, verfolgen Sie die asynchrone Aufgabe und lesen Sie die gespeicherten normalisierten Kontodatensätze aus.

  1. Wählen Sie einen nicht leeren Begriff für das öffentliche Konto, den Creator-Namen, die Marke oder das Thema, das Sie finden möchten.
  2. Senden Sie query an /v1/rednote/search-users 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; liefert die Antwort mit den gespeicherten Ergebnissen has_more zurück, fahren Sie mit deren next_cursor fort.
curl -X POST "https://api.socq.ai/v1/rednote/search-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"photography"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; next_cursor paginates stored results only

Anwendungsfälle der Rednote Search Users API

  • Creator-Shortlist aufbauen: Finden Sie öffentliche Konten über einen Namen oder einen Themenbegriff und prüfen Sie die verfügbaren Identitäts- und Biografiefelder, bevor Sie Kandidaten auswählen.
  • Kontoverzeichnis anreichern: Ergänzen Sie eine Liste gefundener Konten um normalisierte IDs, Benutzernamen, Anzeigenamen, Profiltexte, Bilder, URLs, Websites und Kontomerkmale.
  • Öffentliche Kontosignale vergleichen: Nutzen Sie die verfügbaren Zahlen zu Followern, Gefolgten und Beiträgen als Momentaufnahmen mit Erfassungszeitpunkt – und nicht als private Analysedaten oder aktuelle Gesamtwerte.

Profi-Tipps zur Rednote Search Users API

  • Senden Sie ausschließlich query; results_limit, cursor, page, sort, filter, media_type und zusätzliche Felder werden von diesem Endpunkt abgelehnt.
  • Betrachten Sie den Aufruf beim Anbieter als eine fest eingestellte erste Seite. Der next_cursor des gemeinsamen Aufgaben-Readers paginiert gespeicherte SocQ-Zeilen und nicht weitere Rednote-Quellseiten.
  • Rechnen Sie damit, dass IDs, Benutzernamen, Namen, Biografietexte, Bilder, Websites, Kontomerkmale und einzelne Kennzahlen null sein können, wenn die öffentliche Antwort sie auslässt.
  • Speichern Sie collected_at zusammen mit den sichtbaren Zahlen und planen Sie für jede erfolgreiche Aufgabe pauschal 1,00 SocQ-Credits ein, unabhängig von der Anzahl der zurückgegebenen Konten.

Ergänzend zur Rednote Search Users 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 Users API — FAQ

Rednote Search Users API findet öffentliche Rednote-Konten zu einer Textabfrage und liefert normalisierte Kontodatensätze zurück.

Akzeptiert wird genau eine erforderliche, nicht leere Zeichenfolge query. Enum-Werte, results_limit, Anbieter-Cursor, Sortierung und Filter werden nicht unterstützt.

Nein. Die Eingabe beim Anbieter ist fest auf Seite 1 eingestellt; next_cursor und has_more im gemeinsamen Aufgabenergebnis beschreiben ausschließlich die Paginierung über bereits gespeicherte SocQ-Datensätze.

Das Kontoschema kann Identität, Benutzername, Anzeigename, Biografie, öffentliche URL, Profilbilder, Website, Verifizierungs- und Datenschutzmerkmale, Standort, sichtbare Zahlen zu Followern, Gefolgten und Beiträgen sowie – falls verfügbar – den Erfassungskontext enthalten.

Jede erfolgreiche Aufgabe kostet pauschal 1,00 SocQ-Credits, unabhängig von der Anzahl der Ergebnisse und davon, welche optionalen Felder verfügbar sind.