Skip to content
GET/user/media$0.0008 / call

User Media

Fetch the media tweets posted by a user, cursor-paginated. Returns the tweet objects that contain attached photos or video, with media URLs included.

Request

curl "https://api.twitterapis.com/user/media?username=nasa" \
  -H "Authorization: Bearer $TWITTERAPIS_KEY"

Parameters

ParameterTypeRequiredDescription
usernamestringrequired

Handle without the leading @.

Example: nasa

cursorstringoptional

Pagination cursor from a previous response.

Response

FieldTypeDescription
tweetsarray<Tweet>

Media tweets for this page (each includes a media array).

has_next_pageboolean

True when more results are available; pass next_cursor to fetch them.

next_cursorstring

Opaque cursor token for the next page. Empty string on the final page.

statusstring

Request status, "success" on a normal response.

Example response

{
  "tweets": [
    {
      "id": "1759987654321000111",
      "text": "A new image of the Pillars of Creation.",
      "media": [{ "type": "photo", "url": "https://pbs.twimg.com/media/....jpg" }],
      "author": { "id": "11348282", "username": "nasa" }
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAABCgABF...",
  "status": "success"
}

Pricing for this endpoint

user/media costs $0.0008 per call and returns ~20 tweets, so roughly $0.04 per 1,000 tweets. No subscriptions or minimum spend.

Related endpoints