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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Erforderliche, 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.
- 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.
- Senden Sie query an /v1/rednote/search-users 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; 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 onlyAnwendungsfä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.
Verwandte APIs
Ergänzend zur Rednote Search Users API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Rednote-Daten benötigen.