tiktok-creative-center/
creator-cards

Consultez les fiches Creator Marketplace de TikTok pour jusqu’à 20 créateurs par ID : répartition des abonnés par âge, sexe, pays et appareil, vues médianes, engagement et tarif de départ.

TikTok Creator Marketplace API

Jusqu’à 20 créateurs
Données démographiques de l’audience
Tarifs de départ
0,5 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 Creator Marketplace

Une fiche TikTok Creator Marketplace est le profil que voient les marques lorsqu’elles évaluent un créateur pour une mission rémunérée : elle réunit la bio et le nombre d’abonnés du créateur, la répartition de ses abonnés par âge, sexe, pays et appareil, les vues médianes, les taux d’engagement et de croissance, et le tarif de départ qu’il affiche pour une vidéo sponsorisée. Ces fiches permettent aux marques de comparer les créateurs sur l’adéquation d’audience, la performance habituelle et le prix, en une seule vue.

Fonctionnalités de la TikTok Creator Marketplace API

  • Quatre découpages d’audienceaudience répartit les abonnés par tranche d’âge, sexe, pays et marque de téléphone, et chaque entrée est une part de 0 à 1.
  • Repères de performancemetrics contient followers_count, median_views, engagement_rate, followers_growth_rate et six_second_view_rate.
  • Tarif de départ affichéstarting_price renvoie le montant et la devise que le créateur affiche pour une vidéo sponsorisée, sous forme de nombre avec lequel vous pouvez calculer.
  • Jusqu’à 20 créateurs par requêtecreator_ids accepte de 1 à 20 ID Creator Marketplace et renvoie une fiche pour chaque créateur qui en possède une.
  • Identité sur chaque ficheusername, name, le texte de bio, avatar_url, region, tiktok_user_id, url et recent_video_ids rattachent un ID Marketplace à un compte réel.

Paramètres de la TikTok Creator Marketplace API

ParamètresObligatoireDescription
creator_idsObligatoireDe 1 à 20 ID Creator Marketplace, par exemple des valeurs de creator_id issues des résultats de TikTok Creative Center Top Videos.

Comment utiliser la TikTok Creator Marketplace API

Collectez des ID de créateurs dans Top Videos, puis lisez leurs fiches.

  1. Lancez TikTok Creative Center Top Videos et copiez le creator_id des créateurs que vous voulez évaluer.
  2. Envoyez {"creator_ids": ["7011198409688219653", "7070293872819044358"]} en POST à /v1/tiktok-creative-center/creator-cards.
  3. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded, puis lisez une fiche par créateur dans results.items.
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/creator-cards" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"creator_ids":["7011198409688219653","7070293872819044358"]}'

# audience.ages, genders, countries and devices are shares from 0 to 1.

Cas d’usage de la TikTok Creator Marketplace API

  • Vérifier l’adéquation de l’audience : Comparez audience.ages, genders et countries d’une présélection avec la clientèle que vous voulez toucher, et écartez les créateurs dont les abonnés se trouvent sur de mauvais marchés.
  • Comparer le coût par vue : Divisez starting_price.amount par median_views pour comparer ce qu’achète le tarif affiché de chaque créateur, plutôt que de comparer des nombres d’abonnés.
  • Classer l’élan des créateurs : Triez une présélection par engagement_rate et followers_growth_rate pour trouver les créateurs à la fois réactifs et en croissance.

Conseils d’expert pour la TikTok Creator Marketplace API

  • Prenez les ID dans le champ creator_id des lignes de Top Videos ; un ID utilisateur TikTok comme author.id ne correspond à aucune fiche et est ignoré.
  • Considérez chaque découpage d’audience comme une liste de parts dont la somme peut être légèrement inférieure à 1, et rapprochez les entrées par libellé plutôt que par position.
  • Lisez starting_price.amount avec currency et voyez-y le chiffre d’ouverture du créateur, car les tarifs définitifs se négocient projet par projet.

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

Explorer d’autres plateformes

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

TikTok Creator Marketplace API — FAQ

TikTok Creator Marketplace API est une interface programmatique pour récupérer les fiches TikTok Creator Marketplace de jusqu’à 20 créateurs à partir de leurs ID Creator Marketplace. Elle renvoie la répartition des abonnés par âge, sexe, pays et appareil, les vues médianes, les taux d’engagement et de croissance, les tarifs de départ et l’identité du créateur.

L’ID Creator Marketplace, renvoyé sous le nom creator_id dans les lignes de Top Videos et composé de 5 à 32 chiffres. Un ID utilisateur TikTok ordinaire n’identifie aucune fiche, et les autres formats sont rejetés avec une erreur 400.

Les créateurs qui ont rejoint le Creator Marketplace de TikTok et configuré un profil ; TikTok fixe l’éligibilité, y compris des seuils d’âge et d’abonnés qui varient selon les projets. Un ID sans fiche est ignoré et non facturé, et si tous les ID sont ignorés la tâche échoue et les crédits sont remboursés. Chaque fiche renvoyée coûte 0,5 crédit.

Quatre découpages des abonnés du créateur : tranches d’âge avec des libellés comme 18-24 ou 55+, sexe, pays et marque de téléphone, chaque entrée avec une part de 0 à 1. Les pays contiennent aussi country_code et un nombre d’abonnés échantillonnés.

starting_price donne le montant et la devise que le créateur indique comme prix de départ d’une vidéo sponsorisée. C’est un chiffre d’ouverture : chaque créateur fixe son propre tarif de départ et le prix final se négocie projet par projet.

Non, la recherche se fait par ID Creator Marketplace. Les candidats viennent de TikTok Creative Center Top Videos, où chaque ligne du classement contient un creator_id.

Pas auprès de TikTok. La recherche fonctionne avec votre seule clé API SocQ, sans compte de marque ni agrément de partenaire.