rednote/
home-recommendations

Collectez une page publique de recommandations de la page d’accueil Rednote sans requête de départ, puis lisez les champs normalisés de publication, d’auteur, de média, d’engagement et de date de collecte.

Rednote Home Recommendations API

Aucun point de départ requis
Flux d’une page
Publications normalisées
1 crédit par requête
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
categoryFacultatifChaî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_typeFacultatifEnum 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_limitFacultatifEntier 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.

  1. Partez des valeurs par défaut du backend, ou définissez explicitement category, media_type et results_limit.
  2. Envoyez le corps JSON en POST à /v1/rednote/home-recommendations et conservez data.task_id dans la réponse d’envoi.
  3. Interrogez /v1/tasks/{task_id} jusqu’à la réussite de la tâche ou la signalisation d’un échec.
  4. 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 only

Cas 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.

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.

Explorer d’autres plateformes

Combinez les données Rednote avec les données publiques d’autres plateformes sociales prises en charge.

Rednote Home Recommendations API — FAQ

Rednote Home Recommendations API collecte une page publique de recommandations de la page d’accueil Rednote sous forme d’enregistrements de publications normalisés.

Non. Les trois champs pris en charge sont facultatifs, et un corps JSON vide utilise la catégorie homefeed_recommend du fournisseur et une taille de requête de 20 éléments.

Le validateur public accepte une chaîne category non vide, mais le backend ne définit que homefeed_recommend comme valeur par défaut stable. Cette page ne revendique aucune autre valeur de catégorie issue de recherches externes.

Le validateur accepte video, mais la transformation actuelle du fournisseur associe video et all au même indicateur false. Seul image modifie cet indicateur, donc une réponse exclusivement vidéo n’est pas garantie.

Non. L’appel au fournisseur ne porte que sur une page ; next_cursor relève du lecteur de résultats de tâches commun de SocQ et ne pagine que les enregistrements déjà stockés pour la tâche terminée.

Non. Il n’accepte ni état de connexion, ni identité d’utilisateur, ni actions de compte, ni commandes de publication, ni contrôles de modération.

Chaque tâche consomme un montant fixe de 1,00 crédit SocQ, quels que soient results_limit et le nombre d’enregistrements renvoyés.