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ètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Texte obligatoire et non vide servant à rechercher des notes Rednote publiques ; le Playground le laisse vide jusqu’à ce que vous saisissiez votre propre terme. |
sort_by | Facultatif | Ordre des résultats, facultatif : general, latest ou most_liked. Le Playground démarre avec general. |
media_type | Facultatif | Filtre facultatif de format de note : all, image ou video. Le Playground démarre avec all. |
published_within | Facultatif | Filtre 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.
- Préparez une requête query non vide et choisissez uniquement des valeurs prises en charge pour sort_by, media_type et published_within.
- Envoyez la charge utile en POST à /v1/rednote/search-notes et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
- 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 trueCas 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.
API associées
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.