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ètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Liste 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.
- Rassemblez des liens directs de vidéos, uniformisez le format des URL et dédoublonnez la liste.
- Envoyez le tableau urls en POST à /v1/tiktok/videos et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche atteigne succeeded ou failed.
- 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 trueCas 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.
API associées
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.
- TikTok Hashtags API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Comment Keywords API