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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
username | Erforderlich | Der X-Benutzername, dessen Medien-Tab erfasst wird, mit oder ohne führendes @. |
results_limit | Optional | Wie 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.
- Senden Sie {"username": "NASA", "results_limit": 20} per POST an /v1/x/user-media.
- Prüfen Sie GET /v1/tasks/{task_id} alle paar Sekunden, bis status den Wert succeeded hat.
- 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.
Verwandte APIs
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.
- 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