Skip to content
X (Twitter)

List a profile's tweets

The tweets of a profile on X (Twitter), tab by tab (posts, replies, reposts, videos, photos), newest first, 20 or so a page, with their text, counts, media and author, read with your connected X account.

x/tweets/list20 credits a callv1.1.0

When to use it

You want what an account posts on X: pass its handle (nasa, @nasa) or its profile's address. tab is the profile's own: posts (the default: its tweets, its threads as their tweets one by one), replies (its replies, each with the tweet it answers, which is another account's: author says whose a tweet is), reposts (the tweets it reposted, each with the tweet repeated in retweeted_tweet), videos or photos (the two lists of its Media tab: its tweets with a video, or with a photo, ten or so a page). Follow next unchanged for older tweets. It needs one of your X accounts connected (POST /v2/accounts), and X counts each account's requests: about 250 pages of posts, or 50 of any other tab, for 15 minutes. For tweets about a subject, or an account's tweets between two dates, use x/tweets/search.

It runs with one of your own X (Twitter) accounts, connected once: Accounts.

Try it

The options on the left write the call; the answer on the right is the contract's example. With your API key, the same call returns live data.

1Request
The profile: its handle, with or without the @ (nasa, @nasa), or its address on x.com (https://x.com/nasa).
The tab of the profile's page: posts, replies, reposts, or one of the two lists of its Media tab, videos or photos.
The connected X account to read with (GET /v2/accounts).
Where to go on, from next in an answer, as it is: opaque, and only for the profile and tab it was given with (otherwise invalid_cursor).
20 credits a call
Code, from the fields above
curl https://api.lobstr.io/v2/run \
  -H "Authorization: Bearer $LOBSTR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "x",
    "operation": "tweets/list",
    "options": {
      "profile": "nasa"
    }
  }'
2Response

An example answer, from the contract. Run it on your own input with your API key.

{
  "object": "run",
  "id": "run_df6ueordlxhipljdflyzjg6vdq",
  "livemode": true,
  "source": "x",
  "operation": "tweets/list",
  "version": "1.1.0",
  "schema_url": "https://api.lobstr.io/v2/catalog/x/tweets/list",
  "options": {
    "profile": "nasa"
  },
  "fields": null,
  "status": "succeeded",
  "count": 1,
  "has_more": true,
  "next": {
    "source": "x",
    "operation": "tweets/list",
    "options": {
      "profile": "nasa",
      "cursor": "gAAAAABpNWd0x2kQ8vZr3TfYc1LmRb7uHsE9wA4jXoKqDn6yPiGt5"
    }
  },
  "cost": {
    "credits": 20
  },
  "results": [
    {
      "object": "tweet",
      "id": "2122000000000000001",
      "position": 1,
      "is_pinned": false,
      "url": "https://x.com/NASA/status/2122000000000000001",
      "text": "Liftoff of the resupply mission to the International Space Station. https://t.co/abc123",
      "language": "en",
      "created_at": "2026-11-15T18:42:10Z",
      "reply_count": 312,
      "retweet_count": 1840,
      "quote_count": 96,
      "like_count": 12950,
      "bookmark_count": 410,
      "view_count": 1204500,
      "author": {
        "id": "11348282",
        "handle": "NASA",
        "name": "NASA",
        "url": "https://x.com/NASA",
        "description": "Exploring the secrets of the universe for the benefit of all.",
        "description_language": "en",
        "description_urls": [],
        "location": "Pale Blue Dot",
        "website_url": "https://www.nasa.gov/",
        "created_at": "2007-12-19T20:20:32Z",
        "follower_count": 86000000,
        "following_count": 170,
        "tweet_count": 73000,
        "media_count": 28000,
        "like_count": 16000,
        "is_blue_verified": true,
        "is_verified": false,
        "verified_type": "government",
        "is_protected": false,
        "is_possibly_sensitive": false,
        "professional": null,
        "avatar_url": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_normal.jpg",
        "banner_url": "https://pbs.twimg.com/profile_banners/11348282/1763000000",
        "avatar_shape": "square",
        "pinned_tweet_ids": [],
        "affiliation": null
      },
      "in_reply_to": null,
      "is_quote": false,
      "quoted_tweet": null,
      "retweeted_tweet": null,
      "urls": [
        {
          "url": "https://www.nasa.gov/live",
          "display": "nasa.gov/live",
          "short_url": "https://t.co/abc123"
        }
      ],
      "hashtags": [],
      "symbols": [],
      "mentions": [],
      "media": [],
      "card": null,
      "article": null,
      "place": null,
      "posted_with": null,
      "is_paid_promotion": null,
      "has_ai_generated_media": null,
      "is_possibly_sensitive": false,
      "is_long": false,
      "edit": {
        "tweet_ids": [
          "2122000000000000001"
        ],
        "editable_until": "2026-11-15T19:42:10Z",
        "edits_remaining": 5
      },
      "ids": {
        "tweet_id": "2122000000000000001",
        "conversation_id": "2122000000000000001",
        "author_id": "11348282",
        "quoted_tweet_id": null
      },
      "source_url": "https://x.com/nasa",
      "observed_at": "2026-11-16T15:00:00Z"
    }
  ]
}

Options

profilestringrequired
The profile: its handle, with or without the @ (nasa, @nasa), or its address on x.com (https://x.com/nasa). Not its display name.
tab"posts" | "replies" | "reposts" | "videos" | "photos"Default posts
The tab of the profile's page: posts, replies, reposts, or one of the two lists of its Media tab, videos or photos.
accountstring
The connected X account to read with (GET /v2/accounts). Left out, the platform takes the first of your X accounts with a free slot.
cursorstring
Where to go on, from next in an answer, as it is: opaque, and only for the profile and tab it was given with (otherwise invalid_cursor). Leave it out to start at the newest tweets.

Record

Each record of results, in the envelope every call returns (Run an operation).

objectstring
idstring
The tweet's id.
positioninteger
Its rank in the profile's tab, across pages.
is_pinnedboolean
Whether the profile pinned it at the top of its Posts tab (the page writes Pinned above it).
urlstring
The tweet on x.com.
textstring
The whole text, a long tweet's included (is_long). Links are X's short ones (t.co), given in full in urls and media.
languagestring
The language X detected: ISO 639-1, or X's own codes (und, zxx, qme...).
created_atdate
When it was posted, UTC.
reply_countinteger
retweet_countinteger
Reposts.
quote_countinteger
like_countinteger
bookmark_countinteger
view_countinteger
Null when X shows no view count for it.
author.idstring
The account's id.
author.handlestring
Its @handle, without the @.
author.namestring
author.urlstring
author.descriptionstring
The bio.
author.description_languagestring
author.description_urlslist
The links of the bio
author.locationstring
As the account wrote it.
author.website_urlstring
The profile's link, in full.
author.created_atdate
author.follower_countinteger
author.following_countinteger
author.tweet_countinteger
author.media_countinteger
author.like_countinteger
The tweets the account liked.
author.is_blue_verifiedboolean
The blue check of a paying subscriber.
author.is_verifiedboolean
X's earlier verification.
author.verified_typestring
business or government, when X says so.
author.is_protectedboolean
author.is_possibly_sensitiveboolean
author.professional.typestring
business or creator.
author.professional.categorieslist
author.avatar_urlstring
author.banner_urlstring
author.avatar_shapestring
circle, square (organizations), hexagon.
author.pinned_tweet_idslist
author.affiliation.namestring
The organization's name on the badge.
author.affiliation.urlstring
The organization's profile, as X links it.
author.affiliation.badge_urlstring
The badge's image.
author.affiliation.typestring
business_label on every badge seen.
in_reply_to.tweet_idstring
in_reply_to.user_idstring
in_reply_to.handlestring
is_quoteboolean
quoted_tweetobject
The tweet it quotes, with a tweet's fields but position, quoted_tweet, retweeted_tweet, source_url and observed_at. Null when it quotes none, or one X no longer shows (ids.quoted_tweet_id still says which).
retweeted_tweetobject
The tweet it reposts, with the same fields as quoted_tweet.
urlslist
hashtagslist
Without the #.
symbolslist
Cashtags, without the $.
mentionslist
medialist
card.typestring
X's name of the card: summary, summary_large_image, player...
card.urlstring
card.titlestring
card.descriptionstring
card.domainstring
card.image_urlstring
article.idstring
article.titlestring
article.preview_textstring
article.cover_urlstring
article.published_atdate
article.modified_atdate
place.idstring
X's id of the place.
place.namestring
place.full_namestring
The name with its region or country, as the page writes it.
place.typestring
city, admin, country, neighborhood, poi.
place.countrystring
place.country_codestring
Two letters.
place.bounding_boxlist
The corners of the box around the place, each longitude then latitude.
posted_withstring
The app it was posted with, when X says it: Twitter Web App.
is_paid_promotionboolean
The author's own disclosure of a paid partnership.
has_ai_generated_mediaboolean
X's label of media made with AI.
is_possibly_sensitiveboolean
is_longboolean
A tweet longer than 280 characters; text holds it whole.
edit.tweet_idslist
Its versions, the first to the last.
edit.editable_untildate
edit.edits_remaininginteger
ids.tweet_idstring
ids.conversation_idstring
The first tweet of its thread.
ids.author_idstring
ids.quoted_tweet_idstring
source_urlstring
The profile's tab on x.com.
observed_atdate
When it was read, UTC.

Errors

Its own, besides those of every call (Errors). A failed call is free.

CodeStatusWhat it means
invalid_profile422Pass a profile's handle (nasa, @nasa) or its address (https://x.com/nasa); tab is posts, replies, reposts, videos or photos.
profile_not_found404X has no profile with this handle (not charged).
profile_unavailable404X does not show this profile, suspended or withheld (not charged).
profile_protected403This profile's posts are protected: X shows them to its followers only, and your connected X account does not follow it (not charged).
account_required422You have no connected X account. Connect one with POST /v2/accounts {"site": "x", "cookies": ...}: the cookies of a browser where you are logged in to x.com (https://docs.lobstr.io/accounts).
account_rate_limited429This X account cannot read a profile right now: it pauses a couple of seconds between two pages, and X counts each account's requests (about 250 pages of posts, 50 of any other tab, for 15 minutes). retry_after says when it can again, in seconds. Retrying before then gets this same answer: nothing is queued. Retryable.
account_unusable409X logged this account out, or locked it. Open x.com in the browser the account comes from, then connect it again with POST /v2/accounts and fresh cookies (the same account keeps its id).
site_unavailable503X did not answer properly; retry later (not charged). Retryable.
unexpected_answer424X answered in a shape we do not read yet; we are told and fix it (not charged).

Price

20 credits per call that returns tweets, a short last page included. An empty answer, a failed call and a busy account are free. What a credit costs on each plan: Credits and pricing.

Each connected account makes one call every 2 seconds, plus 0 to 2 seconds; a busy account answers at once with account_rate_limited and retry_after.

Changelog

1.1.02026-11-17
Two more fields, both null on most tweets: place, the place a tweet's author tagged it with, and author.affiliation, the organization whose badge the author carries next to its name. author.website_url is null, no longer an empty string, when the profile has no link.
1.0.02026-11-17
First version on the API v2, in place of the v1 Twitter User Tweets Scraper: a profile by its handle or its address, every tab of its page (posts, replies, reposts, videos, photos), about 20 tweets a page with their counts, media, author, quoted tweet and edits, read with your own connected X account.