x/
user-media

Den Medien-Tab eines X-Kontos per Benutzername erfassen: Posts mit Fotos, Videos und GIFs, neueste zuerst, mit Bildunterschrift, Likes, Aufrufen und direkten Dateilinks, Videos als MP4 mit höchster Bitrate.

Twitter Media Scraper API

Benutzername als Eingabe
Fotos, Videos und GIFs
MP4 mit höchster Bitrate
0,7 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

Twitter Media Scraper

Der Medien-Tab eines Profils auf X (Twitter) sammelt die Tweets, in denen ein Konto Fotos, Videos oder GIFs geteilt hat, die neuesten zuerst, jeweils mit Bildunterschrift sowie Likes, Antworten, Reposts und Aufrufen. Als ein Feed gelesen zeigen diese Posts, was ein Konto visuell veröffentlicht, welche Clips die meisten Aufrufe erzielen und wie sich sein Einsatz von Bildern und Videos im Lauf der Zeit verändert.

Funktionen der Twitter Media Scraper API

  • Der Medien-Tab über einen BenutzernamenSenden Sie einen Benutzernamen, das führende @ ist optional, und erhalten Sie die Tweets des Kontos mit Fotos, Videos oder GIFs in der Reihenfolge seines Medien-Tabs, die neuesten zuerst.
  • Videodateien mit der höchsten BitrateBei einem Video verweist media.url auf das MP4 mit der höchsten Bitrate und thumbnail_url auf das Vorschaubild, sodass sich Clips in der besten Qualität speichern lassen, die X anbietet.
  • Alle Anhänge eines Posts in einer Listemedia führt jedes Bild und Video eines Posts mit seinem Typ auf, sodass ein Post mit mehreren Fotos diese unter einer Bildunterschrift zusammenhält.
  • Bildunterschrift, Link und Interaktion pro PostJeder Post enthält außerdem text, url, published_at, author und die Zahl der Likes, Kommentare, Shares und Aufrufe, wodurch jede Datei mit dem Post verknüpft bleibt, aus dem sie stammt.

Parameter der Twitter Media Scraper API

ParameterErforderlichBeschreibung
usernameErforderlichDer X-Benutzername, dessen Medien-Tab erfasst wird, mit oder ohne führendes @.
results_limitOptionalWie viele Medien-Posts zurückgegeben werden, von 1 bis 1.000. Standard ist 20.

So verwenden Sie die Twitter Media Scraper API

Senden Sie einen Benutzernamen und blättern Sie durch die Posts seines Medien-Tabs.

  1. Senden Sie {"username": "NASA", "results_limit": 20} per POST an /v1/x/user-media.
  2. Prüfen Sie GET /v1/tasks/{task_id} alle paar Sekunden, bis status den Wert succeeded hat.
  3. Lesen Sie die Posts aus results.items und laden Sie jede media.url herunter; solange has_more true ist, fordern Sie die nächste Seite mit results.next_cursor an.
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.

Anwendungsfälle der Twitter Media Scraper API

  • Fotos und Videos eines Kontos archivieren: Laden Sie jede media.url herunter und legen Sie sie mit url und published_at des Posts ab, um eine datierte Kopie dessen zu behalten, was ein Konto geteilt hat.
  • Die meistgesehenen Clips eines Kontos finden: Behalten Sie die Posts, deren Medientyp video ist, und ranken Sie sie nach views_count und likes_count, um die Clips mit der besten Leistung auszuwählen.
  • Den visuellen Content-Mix einer Marke prüfen: Zählen Sie Bild- und Video-Posts pro Monat anhand von published_at und media.type, um zu sehen, wie sich das Verhältnis von Fotos und Videos einer Marke verändert.
  • Bildmaterial für Berichte und Briefings beschaffen: Nutzen Sie thumbnail_url und Bildlinks zusammen mit Bildunterschrift und Aufrufzahl jedes Posts, um Wettbewerbsanalysen oder Kampagnenrückblicke zu illustrieren.

Profi-Tipps zur Twitter Media Scraper API

  • Benennen Sie gespeicherte Dateien nach der id des Posts plus der Position des Anhangs in media, damit Posts mit mehreren Fotos ihre Reihenfolge behalten.
  • Um ein Archiv zu aktualisieren, fordern Sie ein kleines results_limit an und hören Sie mit dem Blättern auf, sobald Sie eine Post-ID erreichen, die Sie bereits haben, denn die neuesten Posts kommen zuerst.
  • Messen Sie Breite und Höhe an den heruntergeladenen Dateien, wenn ein Layout exakte Abmessungen braucht.
  • Entfernen Sie den abschließenden https://t.co-Link aus text, bevor Sie Bildunterschriften analysieren; X hängt ihn an, um auf die angehängten Medien zu verweisen.

Ergänzend zur Twitter Media Scraper API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher X-Daten benötigen.

  • Twitter Tweet Scraper API — Öffentliche Post-Texte, Autoren, Interaktionen, Medien, Hashtags, Erwähnungen und Gesprächsbeziehungen aus Status-URLs von x.com oder twitter.com abrufen.
  • Twitter User Tweets Scraper API — Aktuelle öffentliche Posts, Autoren, Medien, Hashtags, Erwähnungen und Interaktionen per Benutzername erfassen – ohne Antworten.
  • X Post Quotes API — Öffentliche Zitat-Posts zu bekannten Status-URLs erfassen – mit Kommentar, Autoren, Interaktionen, Medien, Zeitstempeln und Kontext des Quell-Posts.
  • X Post Replies API — Öffentliche Antworten aus X-Post-URLs erfassen – mit wählbarer Sortierung, Antworttext, Autoren, sichtbaren Interaktionen, Medien und Kontext des übergeordneten Posts.
  • Twitter Mentions API — Öffentliche Posts erfassen, die ein angegebenes Konto erwähnen.
  • Twitter Video Transcript API — Gesprochenes aus X-Videos in Text umwandeln, inklusive Videolänge.

Weitere Plattformen entdecken

Kombinieren Sie X-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Twitter Media Scraper API — FAQ

Twitter Media Scraper API ist eine Programmierschnittstelle, die die Posts mit Fotos, Videos und GIFs aus dem Medien-Tab eines X-Kontos per Benutzername erfasst. Sie liefert zu jedem Post Text, Autor, Interaktionszahlen und eine Liste media mit direkten Datei-URLs, Videos als MP4 mit der höchsten Bitrate.

Senden Sie den Benutzernamen des Kontos, setzen Sie results_limit auf die gewünschte Tiefe und laden Sie jede media.url aus den zurückgegebenen Posts herunter. Jede Datei bleibt über url und published_at mit ihrem Post verknüpft.

Bei jedem Video ist media.url das MP4 mit der höchsten verfügbaren Bitrate, und thumbnail_url liefert das Vorschaubild.

Ja. Posts mit GIFs gehören zum Medien-Tab und kommen zusammen mit Foto- und Video-Posts zurück, in derselben Reihenfolge mit den neuesten zuerst.

Zwischen 1 und 1.000, festgelegt über results_limit; Standard ist 20. Die Ergebnisse sind in Seiten aufgeteilt, lesen Sie also mit next_cursor weiter, solange has_more true ist.

Jede Anfrage nimmt einen Benutzernamen entgegen. Senden Sie eine Anfrage pro Konto und führen Sie die Ergebnisse über author.username zusammen.