---
title: "Retrieve an X profile"
method: GET
path: "/x/profile/{username}"
tags: ["X"]
---

# Retrieve an X profile

`GET /x/profile/{username}`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/x/profile/{username}`
- Auth: API key in header `x-api-key`

Returns the public profile of an X account by `username`, with or without a leading `@`: name, description, location, avatar and banner images, creation date, verification flags, and `metrics` for followers, following, posts, likes, listed and media. `verified_type` and `affiliate_label` appear only when the account has them. Returns 404 when the profile is not public.

## Path parameters

- `username` string, required

## Headers

- `x-api-key` string, required

## Response `200`

Wrapped profile payload

- XProfileResponseDoc
  - `code` integer
  - `data` XProfile
    - `affiliate_label` string: AffiliateLabel is the small highlighted-affiliation badge X shows next to the display name (e.g. "Prime Video" for an account run on behalf of that brand). Distinct from VerifiedType; empty when the account has no highlighted affiliation.
    - `avatar_url` string
    - `banner_url` string
    - `bio_urls` string[]: BioURLs are links written inside the bio, expanded from their t.co form. Distinct from ExternalURL, which is the single profile-header link.
    - `created_at` string
    - `description` string
    - `email` string: Email is an address the account self-published in its own bio text. It is only ever extracted, never inferred or de-obfuscated. Empty for the vast majority of profiles.
    - `external_url` string
    - `id` string
    - `is_blue_verified` boolean
    - `is_default_profile_image` boolean: IsDefaultProfileImage marks accounts still on the placeholder avatar -- a strong shell/abandoned-account signal.
    - `is_protected` boolean
    - `is_unavailable` boolean
    - `location` string
    - `metrics` XProfileMetrics
      - `followers` integer
      - `following` integer
      - `likes` integer
      - `listed` integer: Listed is how many curated lists include this account -- the best authority proxy in the payload. Media/Likes are activity signals. Only the syndication source populates these; the x.com page parser leaves them zero.
      - `media` integer
      - `posts` integer
    - `name` string
    - `url` string
    - `username` string
    - `verified_type` string: VerifiedType distinguishes the flavour of verification (e.g. "Business", "Government"); empty for ordinary/blue accounts.
  - `msg` string

## Other responses

- `400`: Missing or invalid parameters
- `404`: Profile not found
- `503`: Upstream error or parser drift

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)