rednote/
home-recommendations

Raccogli una pagina pubblica di consigli della home di Rednote senza query iniziale, poi leggi i campi normalizzati di post, autore, media, engagement e momento della raccolta.

Rednote Home Recommendations API

Nessuna query iniziale
Feed a pagina singola
Post 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 Home Recommendations

Una richiesta di consigli della home recupera una pagina pubblica del feed di Rednote senza bisogno di un profilo, di un URL di nota o di una frase di ricerca. Ogni elemento disponibile viene proiettato in un record di post standard con identità della fonte, testo, autore, media, engagement visibile, data di pubblicazione e momento della raccolta.

Funzionalità della Rednote Home Recommendations API

  • Richiesta del feed home senza queryInvia un corpo vuoto o la categoria verificata homefeed_recommend per richiedere una pagina attuale di consigli senza inventare un utente o una query.
  • Dimensione della pagina limitataRichiedi un intero da 1 a 40; se lo ometti si usa 20, mentre la pagina restituita può contenere meno elementi pubblici.
  • Struttura dei post indipendente dal providerLeggi identità della nota, testo, autore, media, timestamp e metriche visibili disponibili tramite lo schema condiviso dei post, invece dei nomi dei campi del provider.
  • Risultati asincroni persistentiInvia una sola volta, segui lo stato dell’attività e scorri i record salvati da SocQ dopo la normalizzazione dell’unica risposta del provider.

Parametri della Rednote Home Recommendations API

ParametriObbligatorioDescrizione
categoryFacoltativoStringa facoltativa non vuota. Se omessa, la mappatura del provider inserisce homefeed_recommend. È l’unica categoria definita dal backend e documentata qui; le altre stringhe non vengono presentate come categorie verificate.
media_typeFacoltativoEnum facoltativo: all, image o video. La mappatura attuale imposta il flag immagine del provider solo per image; all e video corrispondono entrambi a false, quindi video non garantisce una risposta con soli video.
results_limitFacoltativoIntero positivo facoltativo da 1 a 40. Il valore predefinito è 20, imposta la dimensione di pagina richiesta al provider e, se indicato esplicitamente, limita le righe salvate.

Come usare la Rednote Home Recommendations API

Scegli solo i valori facoltativi verificati, invia la richiesta asincrona e leggi i risultati standard salvati.

  1. Parti dai valori predefiniti del backend oppure imposta esplicitamente category, media_type e results_limit.
  2. Invia con POST il corpo JSON a /v1/rednote/home-recommendations e salva data.task_id dalla risposta di invio.
  3. Interroga /v1/tasks/{task_id} finché l’attività non ha successo o segnala un errore.
  4. Leggi data.results.items; segui next_cursor solo quando has_more indica altri record salvati da SocQ.
curl -X POST "https://api.socq.ai/v1/rednote/home-recommendations" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"homefeed_recommend","media_type":"all","results_limit":20}'

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

Casi d’uso della Rednote Home Recommendations API

  • Istantanee delle pagine di consigli: Acquisisci una pagina pubblica limitata del feed home con collected_at, così ogni elemento resta legato a una sola osservazione.
  • Code di scoperta editoriale: Invia testi, autori e riferimenti ai media dei post normalizzati a un flusso di lavoro di revisione umana o di classificazione.
  • Audit dei contenuti visibili: Confronta il mix di media disponibili e i campi pubblici di engagement tra attività di consigli inviate separatamente.

Consigli degli esperti per la Rednote Home Recommendations API

  • Usa {} quando vuoi tutti i valori predefiniti del provider; il validatore della richiesta pubblica non richiede alcun campo.
  • Lascia category su homefeed_recommend a meno che tu non abbia validato in modo indipendente un’altra categoria del provider; il runtime accetta una stringa non vuota ma non pubblica un enum delle categorie.
  • Usa media_type=video con cautela, perché al momento corrisponde allo stesso flag del provider di all; solo image modifica quel flag.
  • Scegli results_limit tra 1 e 40 e non dare per scontato che il provider restituisca esattamente il numero richiesto di elementi pubblici.
  • Non inviare un cursore del provider: l’esecutore a monte fa una sola richiesta e legge items, notes o feeds da quell’unica risposta.
  • Usa next_cursor solo per proseguire tra i risultati salvati da SocQ dopo il completamento; non recupera un’altra pagina di Rednote.
  • Preventiva un costo fisso di 1,00 crediti SocQ per attività; l’addebito non cambia con il limite scelto o con il numero di elementi restituiti.

Oltre alla Rednote Home Recommendations API, usa queste API quando ti serve un altro tipo di dati pubblici di Rednote.

Esplora altre piattaforme

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

Rednote Home Recommendations API — FAQ

Rednote Home Recommendations API raccoglie una pagina pubblica di consigli della home di Rednote sotto forma di record di post normalizzati.

No. Tutti e tre i campi supportati sono facoltativi e un corpo JSON vuoto usa la categoria homefeed_recommend del provider e una richiesta da 20 elementi.

Il validatore pubblico accetta una stringa category non vuota, ma il backend definisce solo homefeed_recommend come valore predefinito stabile. Questa pagina non indica altri valori di categoria derivati da ricerche esterne.

Il validatore accetta video, ma la trasformazione attuale del provider associa video e all allo stesso flag false. Solo image modifica quel flag, quindi una risposta con soli video non è garantita.

No. La chiamata al provider è a pagina singola; next_cursor appartiene al lettore condiviso dei risultati delle attività di SocQ e scorre solo i record già salvati per l’attività completata.

No. Non accetta stato di accesso, identità utente, azioni sull’account, comandi di pubblicazione o controlli di moderazione.

Ogni attività usa un costo fisso di 1,00 crediti SocQ, indipendente da results_limit e dal numero di record restituiti.