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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Testo obbligatorio non vuoto usato per cercare note pubbliche di Rednote; il Playground lo lascia vuoto finché non inserisci un tuo termine. |
sort_by | Facoltativo | Ordinamento facoltativo dei risultati: general, latest o most_liked. Il Playground parte da general. |
media_type | Facoltativo | Filtro facoltativo sul formato della nota: all, image o video. Il Playground parte da all. |
published_within | Facoltativo | Filtro 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.
- Prepara una query non vuota e scegli solo valori supportati di sort_by, media_type e published_within.
- Invia con POST il payload a /v1/rednote/search-notes e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività non ha successo o restituisce un errore.
- 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 trueCasi 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.
API correlate
Oltre alla Rednote Search Notes API, usa queste API quando ti serve un altro tipo di dati pubblici di Rednote.