# X API: Get profile

> Gets the public X profile for a username or profile link, including counts, verification, images and account details. Does not include posts or a timeline.

Unofficial. Not affiliated with or endorsed by X.

- Page: https://fous.com/methods/x.com/get-profile
- Method: `x.com/get_profile`, version 1
- Website: x.com
- Returns: username, display name, bio, follower/following/post counts, joined date, verification, location, website, images, profile link, user ID
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `username` | string | yes | `"NASA"` | X handle with or without @, or an X profile link, for example NASA or https://x.com/NASA. |

## Output

From a run on Oct 23, 2026. Its input:

```json
{
  "username": "NASA"
}
```

Its output:

```json
{
  "bio": "Making the seemingly impossible, possible. ✨",
  "posts": 74449,
  "location": "Pale Blue Dot",
  "username": "NASA",
  "followers": 92310285,
  "following": 115,
  "x_user_id": "11348282",
  "joined_date": "2007-12-19",
  "display_name": "NASA",
  "profile_link": "https://x.com/NASA",
  "website_link": null,
  "banner_image_link": "https://pbs.twimg.com/profile_banners/11348282/1788992290",
  "verification_type": "none",
  "profile_picture_link": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_400x400.jpg"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"x.com/get_profile","input":{"username":"NASA"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Can you pull up the public profile for @elonmusk and tell me his follower count and when the account was created?
- I need the bio, location, and website listed on the X account at https://x.com/NASA.
- What's the verification status and user ID for the handle openai on X?
- Look up the X profile for jack and show me how many accounts he follows and his total post count.
- Get the profile details for the X account linked at x.com/BBCNews, including the profile image and banner.

## Input schema

```json
{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "username": {
      "type": "string",
      "minLength": 1,
      "description": "X handle with or without @, or an X profile link, for example NASA or https://x.com/NASA."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "username",
    "display_name",
    "bio",
    "followers",
    "following",
    "posts",
    "joined_date",
    "verification_type",
    "location",
    "website_link",
    "profile_picture_link",
    "banner_image_link",
    "profile_link",
    "x_user_id"
  ],
  "properties": {
    "bio": {
      "type": [
        "string",
        "null"
      ]
    },
    "posts": {
      "type": [
        "integer",
        "null"
      ]
    },
    "location": {
      "type": [
        "string",
        "null"
      ]
    },
    "username": {
      "type": "string"
    },
    "followers": {
      "type": [
        "integer",
        "null"
      ]
    },
    "following": {
      "type": [
        "integer",
        "null"
      ]
    },
    "x_user_id": {
      "type": "string"
    },
    "joined_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "display_name": {
      "type": "string"
    },
    "profile_link": {
      "type": "string"
    },
    "website_link": {
      "type": [
        "string",
        "null"
      ]
    },
    "banner_image_link": {
      "type": [
        "string",
        "null"
      ]
    },
    "verification_type": {
      "type": "string"
    },
    "profile_picture_link": {
      "type": [
        "string",
        "null"
      ]
    }
  }
}
```

## See more

- [X API: Get post](https://fous.com/methods/x.com/get-post.md): Gets a public X (Twitter) post from its link: author, full text, posting time, likes, reposts, replies, quotes, views, language, media and the quoted post. Deleted, protected and unavailable posts cannot be returned.
- [Instagram API: Get profile](https://fous.com/methods/instagram.com/get-profile.md): Gets an Instagram account's public profile from its username, @name or profile link: name, bio, exact follower, following and post counts, verified and private flags, first bio link, profile picture and account ID.
- [Bluesky API: Get profile](https://fous.com/methods/bsky.app/get-profile.md): Looks up a public Bluesky profile by handle or profile link, including bio, audience counts and join date. A bare name first checks its .bsky.social handle, then the top relevant people-search result.
- [Threads API: Get profile](https://fous.com/methods/threads.com/get-profile.md): Gets a public Threads profile by username or profile link, with bio, followers, verification, picture and bio links. Private profiles are not returned.
- [TikTok API: Get profile](https://fous.com/methods/tiktok.com/get-profile.md): Gets a TikTok creator's public profile and totals (followers, following, likes, videos) from a username, @handle or profile link. Profiles not visible to public visitors cannot be returned.
- [Mastodon API: Get profile](https://fous.com/methods/mastodon.social/get-profile.md): Gets a public Mastodon profile by handle or profile link, with its bio, counts, dates and profile fields. Major servers are read directly. Other servers are looked up through mastodon.social, and their home-server account ID is not available.
- [Chess.com API: Get player stats](https://fous.com/methods/chess.com/get-player-stats.md): Gets a Chess.com player's public profile, ratings and game records, best puzzle rating and Puzzle Rush best score from a username or member profile link.
- [Pinterest API: Get profile](https://fous.com/methods/pinterest.com/get-profile.md): Gets a public Pinterest profile and its visible boards in profile order. Monthly views are null when Pinterest does not show them.
- [All X methods](https://fous.com/methods/x.com.md)
