Twitter Media Scraper
La scheda “Contenuti multimediali” di un profilo X (Twitter) raccoglie i tweet in cui un account ha condiviso foto, video o GIF, dal più recente, ciascuno con la sua didascalia e i suoi Mi piace, risposte, repost e visualizzazioni. Letti come un unico feed, questi post mostrano cosa pubblica un account sul piano visivo, quali clip ottengono più visualizzazioni e come cambia nel tempo il suo uso di immagini e video.
Funzionalità della Twitter Media Scraper API
- La scheda Contenuti multimediali da un nome utenteInvia un nome utente, con o senza la @ iniziale, e ricevi i tweet dell’account che contengono foto, video o GIF nell’ordine della sua scheda “Contenuti multimediali”, dal più recente.
- File video al bitrate più altoPer un video, media.url rimanda all’MP4 con il bitrate più alto e thumbnail_url alla sua immagine di anteprima, così puoi salvare le clip alla migliore qualità offerta da X.
- Tutti gli allegati di un post in un unico elencomedia elenca ogni immagine e video di un post con il relativo tipo, così un post con più foto le tiene insieme sotto un’unica didascalia.
- Didascalia, link ed engagement per ogni postOgni post contiene anche text, url, published_at, author e i conteggi di Mi piace, commenti, condivisioni e visualizzazioni, collegando ogni file al post da cui proviene.
Parametri della Twitter Media Scraper API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
username | Obbligatorio | Il nome utente X di cui raccogliere la scheda Contenuti multimediali, con o senza la @ iniziale. |
results_limit | Facoltativo | Quanti post multimediali restituire, da 1 a 1.000. Il valore predefinito è 20. |
Come usare la Twitter Media Scraper API
Invia un nome utente e scorri pagina per pagina i post della sua scheda Contenuti multimediali.
- Invia con POST {"username": "NASA", "results_limit": 20} a /v1/x/user-media.
- Controlla GET /v1/tasks/{task_id} a intervalli di pochi secondi finché status non diventa succeeded.
- Leggi i post da results.items e scarica ogni media.url; richiedi la pagina successiva con results.next_cursor finché has_more è 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.Casi d’uso della Twitter Media Scraper API
- Archiviare le foto e i video di un account: Scarica ogni media.url e archivialo con url e published_at del post per conservare una copia datata di ciò che un account ha condiviso.
- Trovare le clip più viste di un account: Tieni i post il cui tipo di media è video e ordinali per views_count e likes_count per scegliere le clip che hanno reso di più.
- Analizzare il mix di contenuti visivi di un brand: Conta i post con immagini e con video per mese a partire da published_at e media.type per vedere come cambia l’equilibrio tra foto e video di un brand.
- Recuperare immagini per report e brief: Usa thumbnail_url e i link alle immagini insieme alla didascalia e al numero di visualizzazioni di ogni post per illustrare analisi della concorrenza o riepiloghi di campagna.
Consigli degli esperti per la Twitter Media Scraper API
- Assegna ai file salvati il nome dell’id del post più la posizione dell’allegato in media, così i post con più foto mantengono il loro ordine.
- Per aggiornare un archivio, chiedi un results_limit basso e smetti di sfogliare le pagine quando raggiungi un id di post che hai già, perché i post più recenti arrivano per primi.
- Misura larghezza e altezza dai file scaricati quando un layout richiede dimensioni esatte.
- Rimuovi il link https://t.co finale da text prima di analizzare le didascalie; X lo aggiunge per rimandare ai media allegati.
API correlate
Oltre alla Twitter Media Scraper API, usa queste API quando ti serve un altro tipo di dati pubblici di X.
- Twitter Tweet Scraper API — Recupera testo dei post pubblici, autori, engagement, media, hashtag, menzioni e relazioni della conversazione dagli URL di stato di x.com o twitter.com.
- Twitter User Tweets Scraper API — Raccoglie i post pubblici recenti, autori, media, hashtag, menzioni ed engagement a partire dal nome utente, escludendo le risposte.
- X Post Quotes API — Raccoglie le citazioni pubbliche di URL di stato noti con commento, autori, engagement, media, date e contesto del post di origine.
- X Post Replies API — Raccoglie le risposte pubbliche dagli URL dei post X con ordinamento selezionabile, testo delle risposte, autori, engagement visibile, media e contesto del post principale.
- Twitter Mentions API — Raccoglie i post pubblici che menzionano un account indicato.
- Twitter Video Transcript API — Trasforma in testo il parlato dei video di X, con la durata di ogni video.
- 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