rednote/
search-users

Recherchez des comptes Rednote publics avec une seule requête textuelle et obtenez identité, biographie, indicateurs de compte et métriques d’audience visibles, normalisés, à partir d’une page du fournisseur.

Rednote Search Users API

Requête textuelle
Une seule page source
Comptes normalisés
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 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ètresObligatoireDescription
queryObligatoireChaî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.

  1. Choisissez un terme non vide correspondant au compte public, au nom de créateur, à la marque ou au sujet que vous voulez découvrir.
  2. Envoyez query à /v1/rednote/search-users et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou signale un échec.
  4. 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 only

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

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.

Explorer d’autres plateformes

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

Rednote Search Users API — FAQ

Rednote Search Users API repère des comptes Rednote publics à partir d’une requête textuelle et renvoie des enregistrements de comptes normalisés.

Elle accepte exactement une chaîne query obligatoire et non vide. Aucune énumération, results_limit, curseur du fournisseur, tri ou filtre n’est pris en charge.

Non. L’entrée du fournisseur est fixée à la page 1 ; next_cursor et has_more, dans le résultat de tâche commun, ne décrivent que la pagination des enregistrements SocQ déjà stockés.

Le schéma de compte peut inclure l’identité, le nom d’utilisateur, le nom affiché, la biographie, l’URL publique, les images de profil, le site web, les indicateurs de vérification et de confidentialité, la localisation, les nombres visibles d’abonnés, d’abonnements et de publications, ainsi que le contexte de collecte lorsqu’il est disponible.

Chaque tâche réussie coûte 1,00 crédit SocQ fixe, quel que soit le nombre de résultats ou la disponibilité des champs facultatifs.