Skip to main content
POST
Twitter Media Scraper API

Twitter Media Scraper

Collect the posts from an account’s Media tab on X: every post that carries a photo, video or GIF, newest first. Each post includes its text, engagement counts, views and the media files themselves, with videos pointing to the highest-quality MP4 available and a preview image. Use it to audit a brand’s visual content, gather a creator’s best-performing clips, or build a media archive of an account without scrolling through its timeline.
Provide one X username in username. results_limit defaults to 20 and accepts integers from 1 to 1000. Results are the account’s posts that carry photos, videos or GIFs, newest first.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide one X username in username. results_limit defaults to 20 and accepts integers from 1 to 1000. Results are the account's posts that carry photos, videos or GIFs, newest first.

username
string
required

A public account username.

Minimum string length: 1
callback_url
string<uri>
results_limit
integer
default:20
Required range: 1 <= x <= 1000

Response

Task accepted

code
integer
data
object