---
title: "Get an X user from the dataset"
method: GET
path: "/datasets/x-users/items/{username}"
tags: ["Datasets"]
---

# Get an X user from the dataset

`GET /datasets/x-users/items/{username}`

## Request

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

Returns one X user from the dataset by `username`, with or without a leading @. The record has name, bio, location, external URL, avatar and banner, followers, following, posts, likes, listed count, blue-verified flag and verified type. An unknown username returns 404; no live scrape runs.

## Path parameters

- `username` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsXUserResponseDoc
  - `code` integer
  - `data` EsXUserRecord
    - `avatar_url` string
    - `banner_url` string
    - `bio` string
    - `bio_url_host` string[]
    - `bio_urls` string[]: BioURLs are links written in the bio text, expanded from t.co. Distinct from ExternalURL (the single profile-header link).
    - `crawled_at` string
    - `created_at` string
    - `email` string: Email is an address the account self-published in its own bio. Extracted verbatim, never inferred or de-obfuscated. HasEmail is the faceting flag (an exists query on a keyword is fine, but a bool keeps parity with the other has_* fields and is cheaper to aggregate).
    - `external_url` string
    - `follower_following_ratio` number
    - `followers` integer
    - `following` integer
    - `has_bio` boolean
    - `has_bio_url` boolean
    - `has_email` boolean
    - `has_external_url` boolean
    - `id` string
    - `is_blue_verified` boolean
    - `is_default_profile_image` boolean: IsDefaultProfileImage marks never-customized shells.
    - `likes` integer
    - `listed` integer: Listed is how many curated lists include the account -- the best authority proxy available. Media/Likes are activity signals.
    - `location_raw` string
    - `media` integer
    - `name` string
    - `posts` integer
    - `schema_version` integer
    - `source_tier` string
    - `username` string
    - `verified_type` string: VerifiedType is the verification flavour ("Business", "Government", ...); empty for ordinary/blue accounts.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[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/0497899e2016?raw)