READ API LIVEBuild on /v1 for search, profiles, timelines, audience graph, and tweet context.READ DOCS

Static endpoint reference · Workflow APIs

Twitter profile API endpoint reference

Aggregate one user (by username) and their recent tweets in a single workflow call.

GET/v1/profiles/by-username/{username}Workflow APIs1 base + 1 per item#

Aggregate one user (by username) and their recent tweets in a single workflow call.

curl 'https://api.xfetch.io/v1/profiles/by-username/elonmusk' \
  -H "Authorization: Bearer $XFETCH_API_KEY"
NameInTypeRequiredConstraintsDescription
usernamepathstringrequiredpattern: ^[A-Za-z0-9_]{1,15}$
Response
{
  "data": {
    "user": {
      "id": "44196397",
      "username": "elonmusk",
      "name": "Elon Musk",
      "description": "https://t.co/dDtDyVssfm",
      "created_at": "2009-06-02T20:12:29.000Z",
      "verified": true,
      "protected": false,
      "profile_image_url": "https://pbs.twimg.com/profile_images/2053244804520427520/m8mdWZCG_normal.jpg",
      "follower_count": 239956432,
      "following_count": 1332,
      "tweet_count": 102633,
      "media_count": 4489,
      "status": "active"
    },
    "recent_tweets": [
      {
        "id": "2055734812669865997",
        "text": "These come from court transcripts",
        "author_id": "44196397",
        "created_at": "2026-05-16T19:39:07.000Z",
        "lang": "en",
        "conversation_id": "2055734812669865997",
        "possibly_sensitive": false,
        "like_count": 45028,
        "retweet_count": 9207,
        "reply_count": 2190,
        "quote_count": 236,
        "bookmark_count": 3116,
        "is_quote_status": true,
        "entities": {
          "hashtags": [],
          "urls": [],
          "mentions": []
        },
        "display_text_range": [
          0,
          33
        ],
        "quoted_tweet_id": "2055714457343471890"
      }
    ]
  },
  "meta": {
    "request_id": "req_01HXFETCHEXAMPLE",
    "credits": {
      "charged": 2,
      "remaining": 998
    }
  }
}

Context

From endpoint contract to working workflow

The commercial guide explains when to use this read, while this page keeps the request parameters, response example, schema, and code-derived pricing together. Both point back to the full reference index so the endpoint remains part of one documented API surface.

Run this endpoint in the dashboard playground

Sign in with Google to mint a key and open the documented endpoint selection.