Captapi

officiel

Données publiques de médias sociaux pour agents IA : profils, publications, commentaires, transcriptions et recherche depuis TikTok, Instagram, YouTube, X, Facebook, Threads, Reddit et pages d'entreprise LinkedIn, ainsi que les bibliothèques publicitaires Meta, Google, LinkedIn et TikTok.

Que pouvez-vous faire avec Captapi MCP ?

  • Récupérer les transcriptions — Demandez la transcription d'une vidéo publique YouTube, TikTok, Instagram, Facebook ou X via une URL.
  • Résumer le contenu social — Demandez un résumé IA d'une vidéo, d'un reel ou d'une publication sur les plateformes prises en charge.
  • Extraire les commentaires et les réponses — Récupérez les commentaires ou les réponses aux commentaires d'une publication ou d'une vidéo donnée.
  • Recherche et consultation de profils — Recherchez des publications, des utilisateurs ou des hashtags, et récupérez les détails d'une chaîne, d'un profil ou d'une page.
  • Comparer les métriques des publications — Obtenez les vues, likes, commentaires, partages et taux d'engagement normalisés pour une URL ou jusqu'à 10 URLs.
  • Vérifier l'utilisation du compte — Demandez votre solde de crédits, l'historique de vos requêtes ou votre utilisation quotidienne.

Serveur MCP hébergé

npx add-mcp 'https://api.captapi.com/mcp'

S’installe dans Claude Code, Codex, Cursor et plus

Documentation

Introduction

Captapi vous fournit des données structurées issues des réseaux sociaux publics via une API REST unique et cohérente. Envoyez une URL publique de YouTube, TikTok, Instagram, Facebook et bien d'autres, et recevez en retour du JSON propre — profils, publications, transcriptions, résumés IA, commentaires, résultats de recherche et données de bibliothèque publicitaire. Pas d'OAuth, pas de SDK par plateforme, aucune infrastructure de collecte de données à maintenir.

  • • Une seule clé API fonctionne sur les 33 plateformes.
  • • Passez cache=true pour être servi depuis le cache partagé de 24 h (0 crédit en cas de succès du cache). Par défaut, les données sont toujours fraîches.
  • • Vous n'êtes facturé que pour les requêtes réussies.

Démarrage rapide

Après avoir créé un compte et copié votre clé API depuis le tableau de bord, effectuez votre première requête :

curl "https://api.captapi.com/v1/youtube/transcript?url=https%3A%2F%2Fyoutube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ" \
  -H "Authorization: Bearer capt_live_..."

Lisible par machine : spécification OpenAPI 3.1 (paramètres, schémas de réponse, erreurs, coût en crédits par endpoint), liste des endpoints sur une ligne et llms.txt.

Authentification

Toutes les requêtes sont authentifiées avec un jeton Bearer. Générez des clés dans votre tableau de bord et envoyez-les dans l'en-tête Authorization. Gardez les clés secrètes — n'exposez jamais les clés capt_live_ dans du code côté client.

Comme alternative à Authorization: Bearer, envoyez la même clé en tant que x-api-key: <key>.

Authorization: Bearer capt_live_xxxxxxxxxxxxxxxxxxxx

Effectuer des requêtes

La plupart des endpoints prennent un paramètre de requête url ou q. Certains nécessitent un autre identifiant à la place — par exemple userId, username, repo, advertiser ou comment_id. Consultez la documentation de chaque endpoint pour les paramètres exacts. Lors de la construction d'une chaîne de requête, vous devez encoder en URL les valeurs d'URL afin qu'elles ne soient pas interprétées comme plusieurs paramètres.

# URL-encode the target URL before passing it
urlencode "https://youtube.com/watch?v=dQw4w9WgXcQ"

Format de réponse

Chaque réponse est du JSON avec un booléen success au niveau supérieur et un objet data.

Succès

{
  "success": true,
  "data": {
    "language": "en",
    "segments": [
      { "start": 0.0, "end": 4.12, "text": "Hey everyone, welcome back." }
    ],
    "text": "Hey everyone, welcome back."
  }
}

Erreur

HTTP/1.1 502 Bad Gateway
Retry-After: 60

{
  "success": false,
  "error": {
    "code": "UPSTREAM_UNAVAILABLE",
    "message": "The upstream data source failed for this request. Retry shortly.",
    "retryable": true
  }
}

En-têtes de réponse. X-Captapi-Credits correspond aux crédits facturés, X-Captapi-Cache vaut 1 en cas de succès du cache et 0 sinon, et X-Captapi-Request-Id identifie l'appel ; incluez-le lorsque vous contactez le support. Server-Timing indique la durée totale de la requête en millisecondes, par exemple total;dur=4387.

Le champ source. Les endpoints qui peuvent servir des données de plusieurs manières incluent source dans data : native (la page ou l'API propre à la plateforme), extended (un chemin de repli plus lent ; certains endpoints le facturent différemment et le précisent sur leur page), cache (servi depuis le cache de 24 h), captions (une transcription issue des sous-titres publiés par la plateforme) ou asr (transcription produite par reconnaissance vocale).

Déprécié : le champ timings. L'objet timings dans data sera supprimé des corps de réponse le 2026-12-17. Lisez plutôt l'en-tête de réponse Server-Timing.

Crédits et mise en cache

Les crédits sont l'unité de facturation. Le coût est par endpoint (voir chaque page de documentation) — généralement 1 à 4 pour les recherches simples ; de nombreux endpoints de liste/recherche/commentaires coûtent un forfait de 2 crédits par appel, tandis que certains endpoints de liste évoluent encore selon les résultats (souvent plus élevé). Les requêtes échouées ne sont jamais facturées.

Les résultats vides sont gratuits. Un appel de liste ou de recherche qui s'est exécuté mais n'a rien trouvé coûte 0 crédit, par exemple une recherche sans correspondance, une publication sans commentaires ou une page au-delà du dernier résultat. L'en-tête de réponse X-Captapi-Credits indique toujours ce qu'un appel a réellement coûté.

Quelques endpoints coûtent plus cher lorsqu'un chemin de repli plus lent sert l'appel, par exemple lorsque la page propre à la plateforme ne se charge pas. Leurs pages indiquent la règle et la plage que nous avons observée : TikTok Song Details, LinkedIn Company Posts et TikTok Shop Products.

Par défaut, chaque requête de données récupère des données fraîches (cache=false). Passez cache=true pour être servi depuis le cache de réponses partagé de 24 h à 0 crédit.

Erreurs

Les erreurs renvoient un statut non-2xx et un objet error avec un code stable, un message lisible par l'humain et retryable. Ne réessayez que lorsque retryable est vrai, après l'en-tête Retry-After. Les requêtes échouées ne sont jamais facturées. Faites correspondre code exactement : la casse diffère selon les codes. Le tableau liste les plus courants ; les pages des endpoints listent leurs codes spécifiques.

StatutCodeRéessayableSignification
400BAD_REQUESTfalseUn paramètre est manquant ou invalide, par exemple une URL provenant de la mauvaise plateforme. Certains endpoints utilisent un code plus spécifique, comme HASHTAG_HAS_SPACES.
400plaintext_not_allowedfalseClé API envoyée via http://. Faites tourner la clé et réessayez avec https:// — une redirection ne protège pas le premier saut.
401UNAUTHORIZEDfalseClé API manquante, invalide ou révoquée.
402insufficient_creditsfalseVotre solde est trop bas pour cette requête. Rien n'est facturé.
404NOT_FOUNDfalseLa ressource cible n'existe pas ou n'est pas publique. Certains endpoints nomment le cas, par exemple no_captions ou PROFILE_NOT_FOUND.
422VALIDATION_ERRORfalseUn paramètre a échoué à la validation. error.issues liste chaque champ.
429rate_limit_exceededtrueVous dépassez la limite par minute de votre forfait. Attendez Retry-After.
502UPSTREAM_UNAVAILABLEtrueLa plateforme a échoué pour cette requête. Réessayez sous peu.
503SERVICE_UNAVAILABLEtrueTemporairement indisponible. Certains endpoints utilisent un code plus spécifique, par exemple COMMUNITY_UNAVAILABLE.
504UPSTREAM_TIMEOUTtrueLa plateforme n'a pas répondu à temps. Réessayez sous peu.

Limites de débit

Les limites de débit évoluent avec votre forfait et sont renvoyées sur chaque réponse via les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset. Lorsque vous dépassez la limite, vous recevrez un 429 — attendez et réessayez après la fenêtre de réinitialisation.

Référence de l'API

179 endpoints répartis en 36 groupes. Cliquez sur un endpoint pour obtenir tous les paramètres, exemples et FAQ.

YouTube et Shorts

MéthodeEndpointCréditsDescription
GET/v1/youtube/transcript1Transcription
GET/v1/youtube/audio-transcript2Transcription audio
GET/v1/youtube/summarize3Résumeur
GET/v1/youtube/video-details1Détails de la vidéo
GET/v1/youtube/comments2Commentaires
GET/v1/youtube/channel-details1Détails de la chaîne
GET/v1/youtube/search2Recherche
GET/v1/youtube/channel-videos2Vidéos de la chaîne
GET/v1/youtube/playlist-videos2Vidéos de la playlist
GET/v1/youtube/playlist1Playlist
GET/v1/youtube/shorts/transcript1Transcription des Shorts
GET/v1/youtube/shorts/summarize3Résumeur de Shorts
GET/v1/youtube/shorts/video-details1Statistiques des Shorts
GET/v1/youtube/shorts/comments2Commentaires des Shorts
GET/v1/youtube/channel-shorts2Shorts de la chaîne
GET/v1/youtube/trending-shorts2Shorts tendance
GET/v1/youtube/channel-streams2Diffusions de la chaîne
GET/v1/youtube/hashtag-search~20Recherche par hashtag
GET/v1/youtube/comment-replies2Réponses aux commentaires
GET/v1/youtube/channel-playlists2Playlists de la chaîne
GET/v1/youtube/community-posts1Publications de la communauté
GET/v1/youtube/community-post-details1Détails d'une publication de la communauté
GET/v1/youtube/video-sponsors0Sponsors de la vidéo

TikTok

MéthodeEndpointCréditsDescription
GET/v1/tiktok/transcript2Transcription
GET/v1/tiktok/summarize4Résumeur
GET/v1/tiktok/video-details1Détails de la vidéo
GET/v1/tiktok/comments2Commentaires
GET/v1/tiktok/channel-details1Détails de la chaîne
GET/v1/tiktok/profile-region2Région du profil
GET/v1/tiktok/audience-demographics3Démographie de l'audience
GET/v1/tiktok/search-suggestions2Suggestions de recherche
GET/v1/tiktok/channel-posts2Publications de la chaîne
GET/v1/tiktok/comment-replies2Réponses aux commentaires
GET/v1/tiktok/user-followers1Abonnés de l'utilisateur
GET/v1/tiktok/user-followings1Abonnements de l'utilisateur
GET/v1/tiktok/music-posts2Publications musicales
GET/v1/tiktok/top-search2Recherche principale
GET/v1/tiktok/search/hashtag~14Recherche par hashtag
GET/v1/tiktok/search/users1Recherche d'utilisateurs
GET/v1/tiktok/song-details1Détails de la chanson
GET/v1/tiktok/trending-feed2Fil tendance
GET/v1/tiktok/popular-hashtags2Hashtags populaires
GET/v1/tiktok/popular-songs2Chansons populaires
GET/v1/tiktok/live1Direct
GET/v1/tiktok/live-info1Informations sur le direct
GET/v1/tiktok/popular-creators2Créateurs populaires

Instagram Reels

MéthodeEndpointCréditsDescription
GET/v1/instagram/transcript2Transcription
GET/v1/instagram/summarize4Résumeur
GET/v1/instagram/details1Détails de la publication et du Reel
GET/v1/instagram/comments~45Commentaires de la publication
GET/v1/instagram/channel-details1Détails de la chaîne
GET/v1/instagram/channel-posts~6Publications de la chaîne
GET/v1/instagram/channel-reels~6Reels de la chaîne
GET/v1/instagram/reels-search2Recherche de Reels
GET/v1/instagram/trending-reels2Reels tendance
GET/v1/instagram/tagged-posts1Publications avec mention
GET/v1/instagram/reels-by-audio-id~28Reels par ID audio
GET/v1/instagram/hashtag-search2Recherche par hashtag
GET/v1/instagram/profile-search1Recherche de profil
GET/v1/instagram/embed1HTML d'intégration
GET/v1/instagram/highlights1À la une
GET/v1/instagram/highlights-details1Détails des à la une
GET/v1/instagram/basic-profile1Profil de base

Facebook

MéthodeEndpointCréditsDescription
GET/v1/facebook/details2Détails de la publication et du Reel
GET/v1/facebook/summarize4Résumeur
GET/v1/facebook/comments2Commentaires
GET/v1/facebook/page-details2Détails de la page
GET/v1/facebook/profile-posts2Publications du profil
GET/v1/facebook/profile-reels2Reels du profil
GET/v1/facebook/group-posts~20Publications du groupe
GET/v1/facebook/comment-replies2Réponses aux commentaires
GET/v1/facebook/profile-photos2Photos du profil

Twitter / X

MéthodePoint de terminaisonCréditsDescription
GET/v1/twitter/tweet-details1Détails du tweet
GET/v1/twitter/transcript1Transcription
GET/v1/twitter/profile1Profil
GET/v1/twitter/user-tweets2Tweets de l'utilisateur
GET/v1/twitter/community1Communauté
GET/v1/twitter/community-tweets2Tweets de la communauté

Reddit

MéthodePoint de terminaisonCréditsDescription
GET/v1/reddit/subreddit-posts2Publications du subreddit
GET/v1/reddit/post-details1Détails de la publication
GET/v1/reddit/post-comments2Commentaires de la publication
GET/v1/reddit/post-transcript2Transcription de la publication
GET/v1/reddit/search2Recherche
GET/v1/reddit/subreddit-details1Détails du subreddit
GET/v1/reddit/subreddit-search2Rechercher des publications dans un subreddit

Threads

MéthodePoint de terminaisonCréditsDescription
GET/v1/threads/profile1Profil
GET/v1/threads/user-posts2Publications de l'utilisateur
GET/v1/threads/post-details1Détails de la publication
GET/v1/threads/search2Recherche de publications
GET/v1/threads/search-users1Rechercher des utilisateurs

Bluesky

MéthodePoint de terminaisonCréditsDescription
GET/v1/bluesky/profile1Profil
GET/v1/bluesky/user-posts~3Publications de l'utilisateur
GET/v1/bluesky/post-details1Détails de la publication

Pinterest

MéthodePoint de terminaisonCréditsDescription
GET/v1/pinterest/pin-details1Détails de l'épingle
GET/v1/pinterest/user-pins~13Épingles de l'utilisateur
GET/v1/pinterest/search2Recherche
GET/v1/pinterest/board~13Tableau
GET/v1/pinterest/user-boards~13Tableaux de l'utilisateur

LinkedIn

MéthodePoint de terminaisonCréditsDescription
GET/v1/linkedin/profile1Profil
GET/v1/linkedin/company2Entreprise
GET/v1/linkedin/post-details1Détails de la publication
GET/v1/linkedin/post-transcript1Transcription de la publication
GET/v1/linkedin/company-posts1Publications de l'entreprise
GET/v1/linkedin/search-posts~16Rechercher des publications

Rumble

MéthodePoint de terminaisonCréditsDescription
GET/v1/rumble/video-details1Détails de la vidéo
GET/v1/rumble/video/transcript1Transcription de la vidéo
GET/v1/rumble/channel-videos~12Vidéos de la chaîne
GET/v1/rumble/search~12Recherche
GET/v1/rumble/comments2Commentaires

TikTok Shop

MéthodePoint de terminaisonCréditsDescription
GET/v1/tiktok-shop/shop-search2Recherche de boutiques
GET/v1/tiktok-shop/shop-products2Produits de la boutique
GET/v1/tiktok-shop/product-details2Détails du produit
GET/v1/tiktok-shop/product-reviews~45Avis sur le produit
GET/v1/tiktok-shop/user-showcase~45Vitrine de l'utilisateur

Facebook Marketplace

MéthodePoint de terminaisonCréditsDescription
GET/v1/facebook/marketplace-search2Recherche sur Marketplace
GET/v1/facebook/marketplace-location-search2Recherche par localisation
GET/v1/facebook/marketplace-item2Article Marketplace

Facebook Events

MéthodePoint de terminaisonCréditsDescription
GET/v1/facebook/event-search2Recherche d'événements
GET/v1/facebook/event-details2Détails de l'événement
GET/v1/facebook/profile-events2Événements du profil

Facebook Ad Library

MéthodePoint de terminaisonCréditsDescription
GET/v1/ad-library/facebook/search2Recherche
GET/v1/ad-library/facebook/company-ads2Annonces de l'entreprise
GET/v1/ad-library/facebook/search-companies2Rechercher des entreprises
GET/v1/ad-library/facebook/ad-details2Détails de l'annonce
GET/v1/ad-library/facebook/ad-transcript2Texte de l'annonce

TikTok Ad Library

MéthodePoint de terminaisonCréditsDescription
GET/v1/ad-library/tiktok/search2Recherche
GET/v1/ad-library/tiktok/top-ads2Meilleures annonces
GET/v1/ad-library/tiktok/ad-details2Détails de l'annonce

Google Ad Library

MéthodePoint de terminaisonCréditsDescription
GET/v1/ad-library/google/company-ads2Annonces de l'entreprise
GET/v1/ad-library/google/ad-details2Détails de l'annonce
GET/v1/ad-library/google/advertiser-search1Recherche d'annonceurs

LinkedIn Ad Library

MéthodePoint de terminaisonCréditsDescription
GET/v1/ad-library/linkedin/search-ads2Rechercher des annonces
GET/v1/ad-library/linkedin/ad-details2Détails de l'annonce

Amazon Seller Storefront

MéthodePoint de terminaisonCréditsDescription
GET/v1/amazon-shop/page1Vitrine du vendeur

GitHub

MéthodePoint de terminaisonCréditsDescription
GET/v1/github/user1Utilisateur
GET/v1/github/repositories~12Dépôts
GET/v1/github/pull-requests~12Pull requests
GET/v1/github/activity~12Activité
GET/v1/github/followers~3Abonnés
GET/v1/github/following~3Abonnements
GET/v1/github/contributions2Contributions
GET/v1/github/repository1Dépôt
GET/v1/github/trending-repositories2Tendances
GET/v1/github/trending-developers2Développeurs en tendance

Twitch

MéthodePoint de terminaisonCréditsDescription
GET/v1/twitch/profile1Profil
GET/v1/twitch/user-videos2Vidéos de l'utilisateur
GET/v1/twitch/user-schedule1Planning de l'utilisateur
GET/v1/twitch/clip1Clip

Spotify

MéthodePoint de terminaisonCréditsDescription
GET/v1/spotify/artist1Artiste
GET/v1/spotify/track1Piste
GET/v1/spotify/album1Album
GET/v1/spotify/search2Recherche
GET/v1/spotify/podcast1Podcast
GET/v1/spotify/podcast-episodes2Épisodes du podcast

SoundCloud

MéthodePoint de terminaisonCréditsDescription
GET/v1/soundcloud/artist1Artiste
GET/v1/soundcloud/artist-tracks2Pistes de l'artiste
GET/v1/soundcloud/track1Piste

Linktree

MéthodePoint de terminaisonCréditsDescription
GET/v1/linktree/page1Page

Snapchat

MéthodePoint de terminaisonCréditsDescription
GET/v1/snapchat/user-profile1Profil de l'utilisateur

Truth Social

MéthodePoint de terminaisonCréditsDescription
GET/v1/truth-social/profile1Profil
GET/v1/truth-social/user-posts2Publications de l'utilisateur
GET/v1/truth-social/post1Publication

Kick

MéthodePoint de terminaisonCréditsDescription
GET/v1/kick/clip1Clip

Compte CaptAPI

MéthodePoint de terminaisonCréditsDescription
GET/v1/account/balance0Solde de crédits
GET/v1/account/request-history0Historique des requêtes
GET/v1/account/daily-usage0Utilisation quotidienne
GET/v1/account/most-used-routes0Routes les plus utilisées

Kwai

MéthodePoint de terminaisonCréditsDescription
GET/v1/kwai/profile1Profil
GET/v1/kwai/user-posts~20Publications de l'utilisateur
GET/v1/kwai/post2Publication

Komi

MéthodePoint de terminaisonCréditsDescription
GET/v1/komi/page1Page

Pillar

MéthodePoint de terminaisonCréditsDescription
GET/v1/pillar/page1Page

Linkbio

MéthodePoint de terminaisonCréditsDescription
GET/v1/linkbio/page1Page

Linkme

MéthodePoint de terminaisonCréditsDescription
GET/v1/linkme/profile1Profil

Google Maps

MéthodePoint de terminaisonCréditsDescription
GET/v1/google/business-search2Recherche d'entreprises

Analyses multiplateformes

MéthodePoint de terminaisonCréditsDescription
GET/v1/analytics/post1Métriques unifiées pour une publication/vidéo/réel (plateforme détectée automatiquement)
GET/v1/analytics/compare1/urlComparer les métriques unifiées de jusqu'à 10 URL en un seul appel

Le compagnon de lecture des outils de publication et de planification : transmettez l'URL de n'importe quelle publication, vidéo ou réel pris en charge (YouTube, TikTok, Instagram, Facebook, X, Reddit, Threads, Bluesky, Pinterest, LinkedIn ou Rumble) et obtenez un objet de métriques normalisé — vues, mentions J'aime, commentaires, partages, enregistrements, interactions et engagementRate — avec la plateforme détectée automatiquement. Les champs qu'un réseau n'expose pas restent null (YouTube n'a pas de compteurs publics de partages/enregistrements).

# Platform is auto-detected from the URL
curl "https://api.captapi.com/v1/analytics/post?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ" \
  -H "Authorization: Bearer capt_live_..."

# Compare several posts in one call (same metrics shape per URL)
curl "https://api.captapi.com/v1/analytics/compare?urls=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ,https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DjNQXAC9IVRw" \
  -H "Authorization: Bearer capt_live_..."

Fichiers vidéo (envoi direct)

MéthodePoint de terminaisonCréditsDescription
POST/v1/video/transcript1/minTranscription parole-texte d'un fichier envoyé
POST/v1/video/summarize1/min +1Transcrire un fichier envoyé + résumé par IA

Intégrations

Utilisez Captapi depuis des agents IA, des outils de workflow, des acteurs cloud ou votre terminal — les mêmes 179 points de terminaison, sans plomberie REST.

Voir toutes les intégrations

[

Serveur MCP

Serveur Model Context Protocol exposant les 179 points de terminaison sous forme d'outils typés pour Claude, Cursor, VS Code et tout agent MCP.

](https://captapi.com/docs/integrations#mcp)[

CLI

Appelez chacun des 179 points de terminaison depuis votre terminal, vos scripts ou votre CI — une commande, du JSON sur stdout.

](https://captapi.com/docs/integrations#cli)[

n8n

Nœud communautaire (n8n-nodes-captapi) qui intègre les 179 points de terminaison dans vos workflows n8n.

](https://captapi.com/docs/integrations#n8n)

Prêt à construire ?

Obtenez votre clé API gratuite et effectuez votre premier appel en 60 secondes.

Obtenez votre clé API