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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
category | Facoltativo | Stringa 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_type | Facoltativo | Enum 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_limit | Facoltativo | Intero 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.
- Parti dai valori predefiniti del backend oppure imposta esplicitamente category, media_type e results_limit.
- Invia con POST il corpo JSON a /v1/rednote/home-recommendations e salva data.task_id dalla risposta di invio.
- Interroga /v1/tasks/{task_id} finché l’attività non ha successo o segnala un errore.
- 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 onlyCasi 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.
API correlate
Oltre alla Rednote Home Recommendations API, usa queste API quando ti serve un altro tipo di dati pubblici di Rednote.