Public Profile

X

Retrieve one public X profile by username with identity, account status and public metrics.

Current price
$0.0003/result
Availability
Ready to run
Last accepted verification

What this API does

Return one public X profile by a strict 1-15 character username, including stable string ID, canonical URL, name, bio, location, timestamps, verification/protection/automation flags, public metrics, media, pinned post IDs, public bio links and withheld/unavailable state. URLs, @handles, IDs, login credentials, cookies and actions are not accepted as input.

Agents select this operation with tool ID x.public-profile, then inspect its current executable contract before a run.

Public input and output shape

Input

usernamestring · required

Public X username without @ or URL.

minLength: 1 · maxLength: 15

Output

captured_atstring

Returned captured at value.

profileobject

Returned profile value.

unavailablenull

Returned unavailable value.

Example request and output

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

Request

{
  "tool_id": "x.public-profile",
  "input": {
    "username": "openai"
  }
}

Output

{
  "profile": {
    "id": "4398626122",
    "url": "https://x.com/OpenAI",
    "name": "OpenAI",
    "username": "OpenAI",
    "verified": true
  },
  "captured_at": "2026-08-20T00:00:00.000Z",
  "unavailable": null
}
Teaching errors and limitations
  • invalid_input: username must be a normalized public X username without @ or URL.example: {"username":"openai"}
Updated
21 August 2026

Use Public Profile with Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.