rednote/
search-notes

Recherchez des notes Rednote publiques à partir d’une requête textuelle, avec des filtres facultatifs de tri, de média et de période, et obtenez contenu, auteurs, médias, horodatages et engagement visible, le tout normalisé.

Rednote Search Notes API

Recherche de notes par mot-clé
Filtres de tri et de média
Instantané public d’une page
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 Search Notes

Les résultats de Rednote Search Notes sont des publications publiques correspondant à un mot-clé, avec l’identité de la note, son texte, le contexte de l’auteur, les médias, la date de publication et l’engagement visible. Ces enregistrements alimentent les études thématiques, la comparaison des formats, l’examen des sources et l’analyse ponctuelle de résultats de recherche.

Fonctionnalités de la Rednote Search Notes API

  • Recherche par mot-clé avec trois dimensions de filtreAccepte une requête textuelle ainsi que les choix pris en charge d’ordre, de type de média et de période de publication pour cadrer une recherche de notes publiques.
  • Identité et contenu de note normalisésRenvoie les ID de notes, les URL publiques, le texte, le type de ressource, la date de publication et l’heure de collecte dans la structure PostItem commune.
  • Contexte d’auteur, de médias et d’engagement visibleConserve les champs publics d’auteur disponibles, les références d’images ou de vidéos, les hashtags, les mentions et les nombres visibles de mentions, de commentaires, de partages et de vues.
  • Page de recherche source bornéeExécute une fois par tâche la page 1 de la recherche choisie, pour produire un instantané défini plutôt que de prétendre à une exploration exhaustive de toutes les pages de la source.

Paramètres de la Rednote Search Notes API

ParamètresObligatoireDescription
queryObligatoireTexte obligatoire et non vide servant à rechercher des notes Rednote publiques ; le Playground le laisse vide jusqu’à ce que vous saisissiez votre propre terme.
sort_byFacultatifOrdre des résultats, facultatif : general, latest ou most_liked. Le Playground démarre avec general.
media_typeFacultatifFiltre facultatif de format de note : all, image ou video. Le Playground démarre avec all.
published_withinFacultatifFiltre facultatif de période de publication : all, day, week ou six_months. Le Playground démarre avec all.

Comment utiliser la Rednote Search Notes API

Envoyez une requête de recherche Rednote et des filtres facultatifs, suivez la tâche asynchrone, puis lisez les notes enregistrées grâce à la pagination par curseur de SocQ.

  1. Préparez une requête query non vide et choisissez uniquement des valeurs prises en charge pour sort_by, media_type et published_within.
  2. Envoyez la charge utile en POST à /v1/rednote/search-notes et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
  4. Lisez data.results.items et suivez next_cursor tant que has_more vaut true ; il pagine les résultats enregistrés, pas d’autres pages de recherche 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 true

Cas d’usage de la Rednote Search Notes API

  • Catalogage des résultats d’un mot-clé : Appuyez-vous sur les ID de notes, les URL publiques, le texte, les références d’auteur et collected_at pour bâtir un instantané traçable d’une requête définie.
  • Comparaison entre résultats image et vidéo : Lancez des recherches distinctes par media_type et comparez, d’un instantané à l’autre, les références de médias, le texte des notes et l’engagement visible.
  • Veille thématique axée sur la fraîcheur : Combinez le tri latest ou une période de publication avec published_at et collected_at pour passer en revue les notes récemment remontées sur un même sujet.
  • Analyse du contexte des auteurs : Rapprochez le texte et les médias des notes trouvées des champs d’identité d’auteur disponibles pour voir quels comptes publics apparaissent dans l’instantané d’une requête.

Conseils d’expert pour la Rednote Search Notes API

  • Supprimez les espaces superflus de la requête et vérifiez qu’elle n’est pas vide avant l’envoi, pour que la validation du champ obligatoire ne rejette pas la tâche.
  • N’utilisez que les valeurs d’énumération documentées ; choisissez general, all et all pour obtenir la recherche explicite la plus large.
  • Considérez chaque tâche comme une seule page de recherche source et lancez des tâches distinctes pour chaque combinaison de filtres, au lieu de supposer que l’instantané couvre les pages suivantes de la source.
  • Suivez next_cursor jusqu’à ce que has_more soit false quand l’instantané enregistré s’étend sur plusieurs pages de résultats SocQ ; ce curseur ne demande jamais une autre page source à Rednote.
  • Rapprochez les exécutions d’une même requête avec l’ID et l’URL de la note, car l’ordre et les métriques visibles peuvent varier d’une collecte à l’autre.
  • Gérez le texte, les champs d’auteur, les médias, la date de publication, les hashtags, les mentions et chaque métrique comme des valeurs pouvant être nulles, et échappez le texte public avant de l’afficher.

En complément de la Rednote Search Notes 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 Search Notes API — FAQ

Rednote Search Notes API trouve des notes Rednote publiques à partir d’une requête textuelle, avec des filtres facultatifs d’ordre, de type de média et de période de publication, et renvoie l’identité normalisée de la note, le texte, le contexte de l’auteur, les médias, les horodatages et les champs d’engagement visibles.

query est obligatoire. sort_by accepte general, latest ou most_liked ; media_type accepte all, image ou video ; published_within accepte all, day, week ou six_months.

L’exemple par défaut utilise la requête 旅行攻略 avec sort_by à general et media_type à all, tandis que published_within est omis. L’endpoint n’accepte ni results_limit, ni numéro de page, ni curseur de source.

Chaque PostItem peut contenir l’ID de la note, l’URL, le texte, les informations sur l’auteur, les médias, les horodatages de publication et de collecte, les hashtags, les mentions et les nombres visibles de mentions, de commentaires, de partages et de vues. Les valeurs source facultatives restent nulles lorsqu’elles sont indisponibles.

Non. Chaque tâche demande une seule fois la page 1 de la source ; next_cursor ne lit que la page suivante des résultats déjà enregistrés par SocQ, avec une limite de résultats de tâche de 1 à 500 et de 50 par défaut.

Chaque tâche consomme 1 crédit SocQ fixe. Le nombre de notes enregistrées ou renvoyées ne modifie pas ce tarif fixe par tâche.