Rednote Home Recommendations
Une demande de recommandations de la page d’accueil récupère une page publique du flux Rednote sans exiger de profil, d’URL de note ni d’expression de recherche. Chaque élément disponible est converti en un enregistrement de publication standard, avec son identité source, son texte, son auteur, ses médias, son engagement visible, sa date de publication et sa date de collecte.
Fonctionnalités de la Rednote Home Recommendations API
- Requête de flux d’accueil sans point de départEnvoyez un corps vide ou la catégorie homefeed_recommend vérifiée pour obtenir une page de recommandations actuelle, sans avoir à inventer d’utilisateur ni de requête.
- Taille de page bornéeDemandez un entier de 1 à 40 ; en l’absence de valeur, la page en compte 20, mais elle peut renvoyer moins d’éléments publics.
- Structure de publication indépendante du fournisseurLisez l’identité de la note, le texte, l’auteur, les médias, les horodatages et les indicateurs visibles disponibles grâce au schéma de publication commun, plutôt qu’avec les noms de champs du fournisseur.
- Résultats asynchrones durablesEnvoyez une fois, suivez le statut de la tâche et paginez les enregistrements stockés par SocQ une fois l’unique réponse du fournisseur normalisée.
Paramètres de la Rednote Home Recommendations API
| Paramètres | Obligatoire | Description |
|---|---|---|
category | Facultatif | Chaîne facultative non vide. En son absence, la correspondance du fournisseur injecte homefeed_recommend. C’est la seule catégorie définie par le backend et documentée ici ; les autres chaînes ne sont pas présentées comme des catégories vérifiées. |
media_type | Facultatif | Enum facultatif : all, image ou video. La correspondance actuelle n’active l’indicateur image du fournisseur que pour image ; all et video donnent tous deux false, si bien que video ne garantit pas une réponse exclusivement composée de vidéos. |
results_limit | Facultatif | Entier positif facultatif de 1 à 40. Il vaut 20 par défaut, fixe la taille de page demandée au fournisseur et plafonne les lignes stockées lorsqu’il est fourni explicitement. |
Comment utiliser la Rednote Home Recommendations API
Ne choisissez que des valeurs facultatives vérifiées, envoyez la requête asynchrone, puis lisez les résultats standard stockés.
- Partez des valeurs par défaut du backend, ou définissez explicitement category, media_type et results_limit.
- Envoyez le corps JSON en POST à /v1/rednote/home-recommendations et conservez data.task_id dans la réponse d’envoi.
- Interrogez /v1/tasks/{task_id} jusqu’à la réussite de la tâche ou la signalisation d’un échec.
- Lisez data.results.items ; ne suivez next_cursor que si has_more renvoie à d’autres enregistrements stockés par 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 onlyCas d’usage de la Rednote Home Recommendations API
- Instantanés de pages de recommandations : Capturez une page publique bornée du flux d’accueil avec collected_at, pour que chaque élément reste lié à une même observation.
- Files de découverte éditoriale : Alimentez un flux de relecture humaine ou de classification avec les textes, les auteurs et les références média des publications normalisées.
- Audits de contenus visibles : Comparez la répartition des médias disponibles et les champs d’engagement public entre des tâches de recommandations envoyées séparément.
Conseils d’expert pour la Rednote Home Recommendations API
- Utilisez {} pour conserver toutes les valeurs par défaut du fournisseur ; le validateur de requête public n’exige aucun champ.
- Laissez category sur homefeed_recommend, sauf si vous avez validé de façon indépendante une autre catégorie du fournisseur ; l’exécution accepte toute chaîne non vide mais ne publie pas d’enum de catégories.
- Manipulez media_type=video avec prudence, car il correspond aujourd’hui au même indicateur du fournisseur que all ; seul image modifie cet indicateur.
- Choisissez un results_limit entre 1 et 40 et ne supposez pas que le fournisseur renverra exactement le nombre d’éléments publics demandé.
- N’envoyez pas de curseur du fournisseur : l’exécuteur en amont effectue une seule requête et lit items, notes ou feeds dans cette réponse unique.
- N’utilisez next_cursor que pour parcourir les résultats stockés par SocQ après la réussite ; il ne va pas chercher une autre page Rednote.
- Prévoyez un coût fixe de 1,00 crédit SocQ par tâche ; il ne varie ni avec la limite choisie ni avec le nombre d’éléments renvoyés.
API associées
En complément de la Rednote Home Recommendations API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Rednote.