tiktok/
search-users

Recherchez par mot-clé des créateurs et comptes TikTok publics pour collecter l’identité normalisée des profils, les nombres d’abonnés et les informations de bio.

TikTok Search Users API

Recherche de créateurs
Profils normalisés
Découverte de talents
0,6 crédit par résultat
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

TikTok Search Users

La recherche par mot-clé de comptes de créateurs publics permet de découvrir des influenceurs de niche, des profils de marque et des créateurs de sujets tendance. Les enregistrements de comptes normalisés renvoient les handles, noms affichés, biographies et nombres d’abonnés à l’instant de la collecte, utiles au sourcing de talents.

Fonctionnalités de la TikTok Search Users API

  • Découverte de comptes par mot-cléEnvoyez n’importe quelle chaîne de requête pour trouver des comptes TikTok publics, des handles de créateurs et des profils de communauté pertinents.
  • Profils de créateurs normalisésRecevez des enregistrements structurés contenant nom d’utilisateur, nom affiché, avatar, texte de la bio et badges de compte vérifié.
  • Métriques d’audienceExtrayez les nombres visibles d’abonnés, d’abonnements et de vidéos publiées au total, rattachés à l’heure de collecte.
  • Limite de résultats configurableContrôlez la taille du lot de résultats jusqu’à 2 000 créateurs, avec pagination interne automatique par curseur.

Paramètres de la TikTok Search Users API

ParamètresObligatoireDescription
queryObligatoireMot-clé ou nom de recherche permettant de trouver des comptes de créateurs TikTok publics correspondants.
results_limitFacultatifNombre maximal de profils de créateurs à renvoyer ; vaut 100 par défaut, sur une plage de 1 à 2 000.

Comment utiliser la TikTok Search Users API

Envoyez une requête de recherche comme tâche asynchrone, puis récupérez les profils de créateurs normalisés en interrogeant la tâche.

  1. Choisissez un mot-clé de recherche et, si besoin, un results_limit allant jusqu’à 2 000.
  2. Envoyez une requête POST à /v1/tiktok/search-users avec votre clé API SocQ.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que le statut soit succeeded.
  4. Récupérez les profils normalisés dans data.results.items.
curl -X POST "https://api.socq.ai/v1/tiktok/search-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"taylor swift","results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then inspect data.results.items.

Cas d’usage de la TikTok Search Users API

  • Sélection d’influenceurs et de créateurs : Repérez les créateurs pertinents dans des niches précises et évaluez leurs métriques d’audience actuelles.
  • Surveillance de marque et détection de contrefaçons : Recherchez des noms de marque pour trouver des comptes non officiels, des usurpateurs ou des communautés de fans.
  • Indexation d’une base de talents : Alimentez vos CRM ou plateformes d’analyse avec des données fraîches d’identité et d’abonnés des créateurs.

Conseils d’expert pour la TikTok Search Users API

  • Utilisez des mots-clés de niche précis ou des fragments de handle pour affiner efficacement les résultats.
  • Des valeurs élevées de results_limit paginent automatiquement sur plusieurs pages en amont.
  • Vérifiez le booléen is_verified pour distinguer les comptes de célébrités confirmés des pages de fans.
  • Poursuivez avec TikTok User Videos pour analyser les performances des contenus récents des meilleures correspondances.

En complément de la TikTok Search Users API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques TikTok.

  • TikTok Profiles API — Récupérez par nom d’utilisateur l’identité publique d’un profil, ses biographies, indicateurs de compte et nombres d’audience.
  • TikTok Hashtags API — Collectez les vidéos publiques, créateurs, médias, sons et l’engagement pour des hashtags donnés.
  • TikTok Search API — Recherchez des vidéos publiques par mot-clé avec tris et filtres de publication pris en charge.
  • TikTok Followers List API — Collectez les profils normalisés visibles dans les listes publiques d’abonnés, avec le contexte source conservé et les indicateurs pris en charge.
  • TikTok User Videos API — Collectez par nom d’utilisateur les vidéos publiques du fil d’un profil avec légendes, créateurs, médias, horodatages, engagement et contexte du compte source.
  • TikTok Live Room Info API — Consultez un live connu à partir de la paire d’ID de salle et de propriétaire, et obtenez le statut, le contexte du propriétaire, le média de couverture et les nombres d’audience.

Explorer d’autres plateformes

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

TikTok Search Users API — FAQ

TikTok Search Users API permet de découvrir par mot-clé les comptes et profils de créateurs publics de TikTok. Elle renvoie des noms d’utilisateur, noms affichés, nombres d’abonnés et indicateurs de vérification de compte normalisés, sans exiger d’authentification de session utilisateur.

Non. Toutes les requêtes s’authentifient avec votre clé API SocQ, sans compte développeur TikTok officiel ni OAuth utilisateur.

L’endpoint TikTok Search renvoie les vidéos publiques correspondant à une requête, tandis que TikTok Search Users découvre spécifiquement des comptes de créateurs et des profils de comptes.