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ètres | Obligatoire | Description |
|---|---|---|
username | Obligatoire | Nom d’utilisateur X dont vous voulez collecter l’onglet Médias, avec ou sans le @ initial. |
results_limit | Facultatif | Nombre 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.
- Envoyez {"username": "NASA", "results_limit": 20} en POST à /v1/x/user-media.
- Interrogez GET /v1/tasks/{task_id} toutes les quelques secondes jusqu’à ce que status vaille succeeded.
- 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.
API associées
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.
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- X User Replies API
- Twitter Follow Checker API