rednote/
search-notes

Cerca note pubbliche di Rednote con una query testuale e filtri facoltativi di ordinamento, media e periodo, con contenuti, autori, media, timestamp ed engagement visibile normalizzati.

Rednote Search Notes API

Ricerca di note per parola chiave
Filtri di ordinamento e media
Istantanea pubblica a pagina singola
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 Notes

Rednote Search Notes sono post pubblici corrispondenti a una parola chiave, con identità della nota, testo, contesto dell’autore, media, data di pubblicazione ed engagement visibile. Questi record supportano la ricerca sugli argomenti, il confronto tra formati, la revisione delle fonti e l’analisi puntuale dei risultati di ricerca.

Funzionalità della Rednote Search Notes API

  • Ricerca per parola chiave con tre dimensioni di filtroAccetta una query testuale più le selezioni supportate di ordinamento, tipo di media e finestra di pubblicazione per definire una ricerca mirata di note pubbliche.
  • Identità e contenuto delle note normalizzatiRestituisce ID delle note, URL pubblici, testo, tipo di risorsa, data di pubblicazione e momento della raccolta nella struttura condivisa PostItem.
  • Contesto di autore, media ed engagement visibileConserva i campi pubblici disponibili dell’autore, i riferimenti a immagini o video, gli hashtag, le menzioni e i conteggi visibili di Mi piace, commenti, condivisioni e visualizzazioni.
  • Pagina di ricerca della fonte limitataEsegue una sola volta per attività la pagina 1 della ricerca scelta, producendo un’istantanea definita senza pretendere una scansione completa e multipagina della fonte.

Parametri della Rednote Search Notes API

ParametriObbligatorioDescrizione
queryObbligatorioTesto obbligatorio non vuoto usato per cercare note pubbliche di Rednote; il Playground lo lascia vuoto finché non inserisci un tuo termine.
sort_byFacoltativoOrdinamento facoltativo dei risultati: general, latest o most_liked. Il Playground parte da general.
media_typeFacoltativoFiltro facoltativo sul formato della nota: all, image o video. Il Playground parte da all.
published_withinFacoltativoFiltro facoltativo sulla finestra di pubblicazione: all, day, week o six_months. Il Playground parte da all.

Come usare la Rednote Search Notes API

Invia una query di ricerca Rednote e filtri facoltativi, segui l’attività asincrona, poi leggi i record delle note salvati con la paginazione a cursore di SocQ.

  1. Prepara una query non vuota e scegli solo valori supportati di sort_by, media_type e published_within.
  2. Invia con POST il payload a /v1/rednote/search-notes e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività non ha successo o restituisce un errore.
  4. Leggi data.results.items e segui next_cursor finché has_more è true; questo scorre i risultati salvati, non altre pagine di ricerca di Rednote.
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

Casi d’uso della Rednote Search Notes API

  • Catalogazione dei risultati per parola chiave: Usa ID delle note, URL pubblici, testo, riferimenti agli autori e collected_at per costruire un’istantanea tracciabile per una query definita.
  • Confronto tra risultati con immagini e video: Esegui selezioni media_type separate e confronta i riferimenti ai media restituiti, il testo delle note e l’engagement visibile tra le istantanee risultanti.
  • Revisione degli argomenti basata sull’attualità: Combina l’ordinamento latest o una finestra di pubblicazione con published_at e collected_at per rivedere le note emerse di recente su un argomento.
  • Analisi del contesto degli autori: Associa testo e media delle note corrispondenti ai campi disponibili sull’identità dell’autore per esaminare quali account pubblici compaiono in un’istantanea di query.

Consigli degli esperti per la Rednote Search Notes API

  • Elimina gli spazi superflui dalla query e verifica che non sia vuota prima dell’invio, così la validazione dei campi obbligatori non rifiuta l’attività.
  • Usa solo i valori enum documentati; scegli general, all e all quando vuoi la ricerca più ampia configurata in modo esplicito.
  • Considera ogni attività come una sola pagina di ricerca della fonte ed esegui attività separate per diverse combinazioni di filtri, invece di dare per scontato che l’istantanea copra le pagine successive della fonte.
  • Segui next_cursor finché has_more è false quando l’istantanea salvata si estende su più pagine di risultati di SocQ; questo cursore non richiede mai un’altra pagina della fonte Rednote.
  • Usa ID e URL della nota per riconciliare esecuzioni separate della stessa query, perché ordinamento e metriche visibili possono cambiare tra un momento di raccolta e l’altro.
  • Gestisci testo, campi dell’autore, media, data di pubblicazione, hashtag, menzioni e singole metriche come nullable ed esegui l’escape del testo pubblico prima di mostrarlo.

Esplora altre piattaforme

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

Rednote Search Notes API — FAQ

Rednote Search Notes API trova note pubbliche di Rednote a partire da una query testuale con filtri facoltativi di ordinamento, tipo di media e finestra di pubblicazione, restituendo identità della nota, testo, contesto dell’autore, media, timestamp ed engagement visibile in forma normalizzata.

query è obbligatorio. sort_by accetta general, latest o most_liked; media_type accetta all, image o video; published_within accetta all, day, week o six_months.

L’esempio predefinito usa la query 旅行攻略 con sort_by general e media_type all, mentre published_within è omesso. L’endpoint non accetta results_limit, un numero di pagina né un cursore della fonte.

Ogni PostItem può contenere ID della nota, URL, testo, dati dell’autore, media, timestamp di pubblicazione e raccolta, hashtag, menzioni e conteggi visibili di Mi piace, commenti, condivisioni e visualizzazioni. I valori facoltativi della fonte restano null quando non sono disponibili.

No. Ogni attività richiede una sola volta la pagina 1 della fonte; next_cursor legge solo la pagina successiva dei risultati già salvati da SocQ, con limiti dei risultati dell’attività da 1 a 500 e 50 per impostazione predefinita.

Ogni attività usa un costo fisso di 1 credito SocQ. Il numero di note salvate o restituite non cambia questo addebito fisso per attività.