rednote/
search-users

Cerca account pubblici di Rednote con una query testuale, con identità, biografia, flag dell’account e metriche visibili del pubblico normalizzate da una pagina del provider.

Rednote Search Users API

Query testuale
Una pagina della fonte
Account normalizzati
1 credito per richiesta
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

Rednote Search Users

La ricerca pubblica di account Rednote può far emergere identità, biografia, stato del profilo e conteggi visibili di pubblico o contenuti delle persone che corrispondono a una query testuale. I record normalizzati degli account conservano i campi disponibili della fonte e aggiungono collected_at per una scoperta e un confronto tracciabili.

Funzionalità della Rednote Search Users API

  • Scoperta di account con una sola queryInvia una query non vuota che corrisponde alla parola chiave del provider sulla sua prima pagina fissa, senza controlli sulla pagina della fonte né filtri aggiuntivi.
  • Identità pubblica normalizzataRicevi una struttura di account stabile per i campi disponibili di ID, nome utente, nome visualizzato, biografia, URL pubblico, immagini del profilo, sito web, verifica e privacy.
  • Istantanea visibile dell’accountConserva i conteggi disponibili di follower, seguiti e post con collected_at, così ogni valore restituito resta legato al momento dell’osservazione.

Parametri della Rednote Search Users API

ParametriObbligatorioDescrizione
queryObbligatorioStringa obbligatoria non vuota associata alla parola chiave del provider. Questo endpoint non ha campi enum, results_limit, cursore del provider, ordinamento o filtro sui media.

Come usare la Rednote Search Users API

Invia un termine di ricerca di account, segui l’attività asincrona e leggi i record degli account normalizzati salvati.

  1. Scegli un solo termine non vuoto che rappresenti l’account pubblico, il nome del creator, il brand o l’argomento che vuoi scoprire.
  2. Invia query a /v1/rednote/search-users e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività non ha successo o segnala un errore.
  4. Leggi data.results.items; se la risposta dei risultati salvati restituisce has_more, continua con il relativo next_cursor.
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

Casi d’uso della Rednote Search Users API

  • Creare una shortlist di creator: Scopri account pubblici da un nome o da un termine tematico, poi rivedi i campi disponibili di identità e biografia prima di scegliere i candidati.
  • Arricchire una directory di account: Aggiungi a un elenco di scoperta ID, nomi utente, nomi visualizzati, testo del profilo, immagini, URL, siti web e flag dell’account normalizzati.
  • Confrontare i segnali pubblici degli account: Usa i conteggi disponibili di follower, seguiti e post come istantanee con momento di raccolta, senza trattarli come analisi private o totali in tempo reale.

Consigli degli esperti per la Rednote Search Users API

  • Invia solo query; results_limit, cursor, page, sort, filter, media_type e campi extra vengono rifiutati da questo endpoint.
  • Considera la chiamata al provider come una sola prima pagina fissa. Il next_cursor del lettore condiviso delle attività scorre le righe salvate di SocQ, non altre pagine della fonte Rednote.
  • Metti in conto che ID, nomi utente, nomi, testo della biografia, immagini, siti web, flag dell’account e singole metriche siano null quando la risposta pubblica li omette.
  • Salva collected_at insieme ai conteggi visibili e preventiva 1,00 crediti SocQ fissi per ogni attività riuscita, a prescindere dal numero di account restituiti.

Esplora altre piattaforme

Combina i dati di Rednote con i dati pubblici delle altre piattaforme social supportate.

Rednote Search Users API — FAQ

Rednote Search Users API scopre account pubblici di Rednote a partire da una query testuale e restituisce record di account normalizzati.

Accetta esattamente una stringa query obbligatoria non vuota. Non sono supportati campi enum, results_limit, cursore del provider, ordinamento o filtri.

No. L’input del provider è fisso sulla pagina 1; next_cursor e has_more nel risultato condiviso dell’attività descrivono solo la paginazione sui record di SocQ già salvati.

Lo schema dell’account può includere identità, nome utente, nome visualizzato, biografia, URL pubblico, immagini del profilo, sito web, flag di verifica e privacy, località, conteggi visibili di follower, seguiti e post, oltre al contesto di raccolta quando disponibile.

Ogni attività riuscita costa 1,00 crediti SocQ fissi, indipendentemente dal numero di risultati o dalla disponibilità dei campi facoltativi.