Rednote Search Users
La recherche de comptes Rednote publics permet de faire remonter l’identité, la biographie, le statut du profil et les nombres visibles d’audience ou de contenus des personnes correspondant à une requête textuelle. Les enregistrements de comptes normalisés gardent les champs source disponibles et reçoivent collected_at, pour une découverte et une comparaison traçables.
Fonctionnalités de la Rednote Search Users API
- Découverte de comptes par requête uniqueEnvoyez une requête non vide qui correspond au mot-clé du fournisseur sur sa première page fixe, sans contrôle de page source ni filtre supplémentaire.
- Identité publique normaliséeObtenez une structure de compte stable pour l’ID, le nom d’utilisateur, le nom affiché, la biographie, l’URL publique, les images de profil, le site web et les champs de vérification et de confidentialité, lorsqu’ils sont disponibles.
- Instantané visible du compteGarde les nombres d’abonnés, d’abonnements et de publications disponibles avec collected_at, pour que chaque valeur renvoyée reste liée à son moment d’observation.
Paramètres de la Rednote Search Users API
| Paramètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Chaîne obligatoire et non vide, transmise au mot-clé du fournisseur. Cet endpoint n’a ni énumération, ni results_limit, ni curseur du fournisseur, ni champ de tri ou de filtre de média. |
Comment utiliser la Rednote Search Users API
Envoyez un terme de recherche de compte, suivez la tâche asynchrone, puis lisez les enregistrements de comptes normalisés qu’elle a enregistrés.
- Choisissez un terme non vide correspondant au compte public, au nom de créateur, à la marque ou au sujet que vous voulez découvrir.
- Envoyez query à /v1/rednote/search-users et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou signale un échec.
- Lisez data.results.items ; si la réponse sur les résultats enregistrés renvoie has_more, poursuivez avec son next_cursor.
curl -X POST "https://api.socq.ai/v1/rednote/search-users" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"photography"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; next_cursor paginates stored results onlyCas d’usage de la Rednote Search Users API
- Constituer une présélection de créateurs : Repérez des comptes publics à partir d’un nom ou d’un terme thématique, puis examinez l’identité et la biographie disponibles avant de retenir des candidats.
- Compléter un annuaire de comptes : Ajoutez à une liste de découverte des ID, noms d’utilisateur, noms affichés, textes de profil, images, URL, sites web et indicateurs de compte normalisés.
- Comparer des signaux de comptes publics : Exploitez les nombres d’abonnés, d’abonnements et de publications disponibles comme des instantanés datés par collected_at, sans les prendre pour des statistiques privées ni pour des totaux en direct.
Conseils d’expert pour la Rednote Search Users API
- N’envoyez que query : results_limit, cursor, page, sort, filter, media_type et tout champ supplémentaire sont rejetés par cet endpoint.
- Voyez dans l’appel au fournisseur une première page fixe. Le next_cursor du lecteur de tâches commun pagine les lignes SocQ enregistrées, pas d’autres pages source de Rednote.
- Admettez que les ID, noms d’utilisateur, noms, textes de biographie, images, sites web, indicateurs de compte et métriques individuelles puissent être nuls quand la réponse publique les omet.
- Stockez collected_at avec les nombres visibles, et prévoyez 1,00 crédit SocQ fixe pour chaque tâche réussie, quel que soit le nombre de comptes renvoyés.
API associées
En complément de la Rednote Search Users API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Rednote.