x/
user-media

Raccogli la scheda Contenuti multimediali di un account X dal suo nome utente: post con foto, video e GIF dal più recente, con didascalia, Mi piace, visualizzazioni e link diretti ai file, video in MP4 al bitrate più alto.

Twitter Media Scraper API

Input con nome utente
Foto, video e GIF
MP4 al bitrate più alto
0,7 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
usernameObbligatorioIl nome utente X di cui raccogliere la scheda Contenuti multimediali, con o senza la @ iniziale.
results_limitFacoltativoQuanti 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.

  1. Invia con POST {"username": "NASA", "results_limit": 20} a /v1/x/user-media.
  2. Controlla GET /v1/tasks/{task_id} a intervalli di pochi secondi finché status non diventa succeeded.
  3. 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.

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.

Esplora altre piattaforme

Combina i dati di X con i dati pubblici delle altre piattaforme social supportate.

Twitter Media Scraper API — FAQ

Twitter Media Scraper API è un’interfaccia programmatica per raccogliere i post con foto, video e GIF della scheda Contenuti multimediali di un account X a partire dal suo nome utente. Restituisce testo, autore e conteggi di engagement di ogni post, più un elenco media con gli URL diretti dei file e i video in MP4 al bitrate più alto.

Invia il nome utente dell’account, imposta results_limit sulla profondità che ti serve e scarica ogni media.url dai post restituiti. Ogni file resta collegato al suo post tramite url e published_at.

Per ogni video, media.url è l’MP4 con il bitrate più alto disponibile e thumbnail_url fornisce l’immagine di anteprima.

Sì. I post con GIF fanno parte della scheda Contenuti multimediali e tornano insieme ai post con foto e video, nello stesso ordine dal più recente.

Tra 1 e 1.000, impostati con results_limit; il valore predefinito è 20. I risultati sono paginati, quindi continua a leggere con next_cursor finché has_more è true.

Ogni richiesta accetta un solo nome utente. Invia una richiesta per account e unisci i risultati tramite author.username.