x/
user-media

Collectez l’onglet Médias d’un compte X à partir de son nom d’utilisateur : posts avec photos, vidéos et GIF du plus récent au plus ancien, avec légende, mentions « J’aime », vues et liens directs vers les fichiers, vidéos en MP4 au débit le plus élevé.

Twitter Media Scraper API

Nom d’utilisateur en entrée
Photos, vidéos et GIF
MP4 au débit maximal
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

Twitter Media Scraper

L’onglet Médias d’un profil X (Twitter) rassemble les tweets dans lesquels un compte a partagé des photos, des vidéos ou des GIF, du plus récent au plus ancien, chacun avec sa légende et ses nombres de mentions « J’aime », de réponses, de reposts et de vues. Lus comme un seul fil, ces posts montrent ce qu’un compte publie en images, quels extraits attirent le plus de vues et comment son usage de la photo et de la vidéo évolue dans le temps.

Fonctionnalités de la Twitter Media Scraper API

  • L’onglet Médias à partir d’un nom d’utilisateurEnvoyez un nom d’utilisateur, avec ou sans @ initial, et recevez les tweets du compte qui contiennent des photos, des vidéos ou des GIF, dans l’ordre de son onglet Médias, du plus récent au plus ancien.
  • Des fichiers vidéo au débit le plus élevéPour une vidéo, media.url pointe vers le MP4 au débit le plus élevé et thumbnail_url vers son image d’aperçu : les extraits peuvent ainsi être enregistrés dans la meilleure qualité proposée par X.
  • Toutes les pièces jointes d’un post dans une seule listemedia liste chaque image et chaque vidéo d’un post avec son type : un post de plusieurs photos les garde ainsi réunies sous une même légende.
  • Légende, lien et engagement pour chaque postChaque post contient aussi text, url, published_at, author et les nombres de mentions « J’aime », de commentaires, de partages et de vues, ce qui rattache chaque fichier au post dont il provient.

Paramètres de la Twitter Media Scraper API

ParamètresObligatoireDescription
usernameObligatoireNom d’utilisateur X dont vous voulez collecter l’onglet Médias, avec ou sans le @ initial.
results_limitFacultatifNombre de posts avec médias à renvoyer, de 1 à 1 000. 20 par défaut.

Comment utiliser la Twitter Media Scraper API

Envoyez un nom d’utilisateur et parcourez page par page les posts de son onglet Médias.

  1. Envoyez {"username": "NASA", "results_limit": 20} en POST à /v1/x/user-media.
  2. Interrogez GET /v1/tasks/{task_id} toutes les quelques secondes jusqu’à ce que status vaille succeeded.
  3. Lisez les posts dans results.items et téléchargez chaque media.url ; demandez la page suivante avec results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/x/user-media" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"NASA","results_limit":20}'

# For a video, media.url is the highest-bitrate MP4 and thumbnail_url its preview.

Cas d’usage de la Twitter Media Scraper API

  • Archiver les photos et vidéos d’un compte : Téléchargez chaque media.url et classez-le avec l’url et le published_at du post pour conserver une copie datée de ce qu’un compte a partagé.
  • Trouver les extraits les plus regardés d’un compte : Gardez les posts dont le type de média est video et classez-les par views_count et likes_count pour retenir les extraits les plus performants.
  • Analyser le mix de contenus visuels d’une marque : Comptez les posts avec image et avec vidéo par mois à partir de published_at et de media.type pour voir comment l’équilibre entre photos et vidéos d’une marque évolue.
  • Récupérer des visuels pour des rapports et des briefs : Utilisez thumbnail_url et les liens d’images avec la légende et le nombre de vues de chaque post pour illustrer des analyses concurrentielles ou des bilans de campagne.

Conseils d’expert pour la Twitter Media Scraper API

  • Nommez les fichiers enregistrés d’après l’id du post suivi de la position de la pièce jointe dans media, afin que les posts de plusieurs photos gardent leur ordre.
  • Pour mettre à jour une archive, demandez un petit results_limit et arrêtez la pagination dès que vous atteignez un id de post déjà enregistré, puisque les posts les plus récents arrivent en premier.
  • Mesurez la largeur et la hauteur à partir des fichiers téléchargés lorsqu’une mise en page exige des dimensions exactes.
  • Retirez le lien https://t.co placé à la fin de text avant d’analyser les légendes ; X l’ajoute pour pointer vers le média joint.

En complément de la Twitter Media Scraper API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques X.

  • Twitter Tweet Scraper API — Récupérez le texte des posts publics, auteurs, l’engagement, médias, hashtags, mentions et relations de conversation à partir d’URL de statuts x.com ou twitter.com.
  • Twitter User Tweets Scraper API — Collectez par nom d’utilisateur les posts publics récents, auteurs, médias, hashtags, mentions et l’engagement, hors réponses.
  • X Post Quotes API — Collectez les citations publiques de statuts connus à partir de leur URL, avec commentaire, auteurs, engagement, médias, horodatages et contexte du post source.
  • X Post Replies API — Collectez les réponses publiques à partir d’URL de posts X avec tri au choix, texte des réponses, auteurs, engagement visible, médias et contexte du post parent.
  • Twitter Mentions API — Collectez les posts publics qui mentionnent un compte donné.
  • Twitter Video Transcript API — Transformez la parole des vidéos X en texte, avec la durée de chaque vidéo.

Explorer d’autres plateformes

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

Twitter Media Scraper API — FAQ

Twitter Media Scraper API est une interface programmatique qui collecte les posts avec photos, vidéos et GIF de l’onglet Médias d’un compte X à partir de son nom d’utilisateur. Elle renvoie pour chaque post son texte, son auteur, ses compteurs d’engagement et une liste media avec les URL directes des fichiers, les vidéos étant fournies en MP4 au débit le plus élevé.

Envoyez le nom d’utilisateur du compte, réglez results_limit sur la profondeur voulue et téléchargez chaque media.url des posts renvoyés. Chaque fichier reste rattaché à son post grâce à url et published_at.

Pour chaque vidéo, media.url est le MP4 au débit le plus élevé disponible, et thumbnail_url fournit l’image d’aperçu.

Oui. Les posts avec GIF font partie de l’onglet Médias et reviennent avec les posts photo et vidéo, dans le même ordre, du plus récent au plus ancien.

Entre 1 et 1 000, à régler avec results_limit ; la valeur par défaut est 20. Les résultats sont paginés : continuez la lecture avec next_cursor tant que has_more vaut true.

Chaque requête accepte un seul nom d’utilisateur. Envoyez une requête par compte et fusionnez les résultats par author.username.