tiktok/
videos

Récupérez les métadonnées de vidéos TikTok publiques à partir d’une ou plusieurs URL directes et obtenez créateur, légende, média, musique, hashtags, mentions et engagement normalisés.

TikTok Videos API

Enrichissement d’URL
Analyse créative
Instantanés de performance
0,7 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 Videos

Une vidéo TikTok est une publication au format court, avec légende, contexte du créateur, média, musique, durée, hashtags, mentions, détails de publication et engagement visible. Ces signaux de contenu servent à la veille sur les tendances, à l’analyse des créations, au bilan de campagne et à la comparaison des performances.

Fonctionnalités de la TikTok Videos API

  • Recherche par lot d’URL de vidéosTransforme un lot de liens de vidéos TikTok en enregistrements de contenu cohérents.
  • Identité de vidéo stableÉtablit l’identité et la source d’une vidéo grâce à son ID et à son URL canonique.
  • Champs de contenu et de créateurExtrait la légende, la langue, la date de publication, le créateur, la durée et le contexte de la couverture.
  • Éléments de contexte créatifIntègre hashtags, mentions, musique et indicateurs de contenu à l’analyse des créations.
  • Métriques à un instant donnéAssocie les nombres d’engagement visibles à collected_at pour obtenir des instantanés de performance.

Paramètres de la TikTok Videos API

ParamètresObligatoireDescription
urlsObligatoireListe obligatoire d’URL directes de vidéos TikTok actuellement accessibles au public.

Comment utiliser la TikTok Videos API

Transformez des liens issus de favoris, de rapports ou de systèmes internes en inventaire vidéo prêt à analyser.

  1. Rassemblez des liens directs de vidéos, uniformisez le format des URL et dédoublonnez la liste.
  2. Envoyez le tableau urls en POST à /v1/tiktok/videos et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche atteigne succeeded ou failed.
  4. Lisez data.results.items. Lorsque has_more vaut true, poursuivez avec next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok/videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.tiktok.com/@nasa/video/7412345678901234567"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Cas d’usage de la TikTok Videos API

  • Analyse des motifs de contenu : Croisez légendes, hashtags, mentions, musique et durée pour comparer les éléments récurrents d’une sélection de vidéos.
  • Bilan vidéo d’une campagne : Relevez vues et engagement pour un ensemble de contenus choisis et comparez de façon homogène les performances de la campagne.
  • Catalogues d’actifs vidéo : Indexez les contenus par ID de vidéo, URL canonique, couverture, créateur et date de publication pour les retrouver rapidement.
  • Étiquetage par sujet et par format : Servez-vous de la langue, des légendes, des hashtags et de la musique pour classer thèmes, formats et publics visés.

Conseils d’expert pour la TikTok Videos API

  • Fusionnez les contenus en double sur id et gardez url pour la vérification et le retour à la source.
  • Stockez published_at comme date de sortie et collected_at comme heure de relevé des métriques.
  • Combinez légende, hashtags, mentions et musique en attributs de contenu exploitables en recherche.
  • Quand views est présent et supérieur à zéro, prenez-le comme dénominateur des ratios de mentions « J’aime », de commentaires et de partages.
  • Rattachez les enregistrements Comments au même ID de vidéo pour confronter la performance d’un contenu à la réaction de l’audience.
  • Collectez un ensemble de comparaison sur une période resserrée, afin que les instantanés d’engagement restent significatifs.

En complément de la TikTok Videos 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 Comments API — Collectez les commentaires publics de premier niveau, leurs auteurs, l’engagement, les mentions et les indicateurs d’interaction du créateur.
  • 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 Trending Feed API — Collectez le fil actuel de vidéos publiques d’une région avec créateur, légende, couverture, horodatage et engagement visible.
  • TikTok Video Transcript API — Extrayez le texte de transcription disponible, la langue, le format et le contexte source à partir d’URL de vidéos publiques.
  • TikTok Fake Views Checker API — Évaluez les fausses vues d’une URL de vidéo, avec l’estimation des fausses vues et le niveau de trafic.

Explorer d’autres plateformes

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

TikTok Videos API — FAQ

TikTok Videos API récupère les métadonnées de vidéos accessibles publiquement à partir d’une ou plusieurs URL directes de vidéos TikTok. Elle renvoie créateur, légende, média, musique, hashtags, mentions, publication et engagement sous forme normalisée.

Placez une ou plusieurs URL directes de vidéos TikTok dans le tableau urls. Chaque URL est traitée comme la recherche d’une vidéo connue.

Oui. urls accepte plusieurs liens directs, ce qui permet d’enrichir par lot des listes de vidéos de campagne, de créateurs ou de concurrents.

Les résultats comprennent l’ID de la vidéo, l’URL canonique, la légende, la langue, la date de publication, les hashtags, les mentions ainsi que l’identité publique du créateur et les champs de son profil.

Les résultats peuvent inclure les nombres de mentions « J’aime », de commentaires, de vues, de partages, de favoris et de reposts, avec les métadonnées de durée, de média et de musique.

Stockez les métriques d’engagement avec collected_at, puis comparez un ensemble de vidéos choisi à des moments de collecte proches.

Chaque résultat de vidéo normalisé renvoyé coûte 0,7 crédit.