> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usegoro.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# X profile

> Public profile data for one or more X (Twitter) accounts: display name, bio, follower and following counts, tweet and media counts, verification status and type

Public profile data for one or more X (Twitter) accounts: display name, bio, follower and following counts, tweet and media counts, verification status and type, location, website, join date, and profile and header images.

<Note>Use when you have X handles and need the accounts behind them: sizing an audience before outreach, checking whether a handle is real, verified or protected, or enriching handles you collected elsewhere. One result, and one billable item, per handle.</Note>

## Price

**\$0.0006 per result.** That is the rate you pay for each result the call returns, so the total depends on how many it produces.

Billing follows actual usage, so a call that returns fewer results costs less. `discover` and `inspect` also return a ceiling for your specific request, which is a maximum you will never be charged above.

## Input

| Field       | Type    | Required | Notes                                                                         |
| ----------- | ------- | -------- | ----------------------------------------------------------------------------- |
| `usernames` | `array` | yes      | X handles, without the @ sign. One result, and one billable item, per handle. |

<Note>
  Goro forwards your input to the underlying tool unchanged, so any field the
  tool accepts works here even if it is not listed above.
</Note>

## Example

```bash theme={null}
curl -X POST https://api.usegoro.ai/v1/run \
  -H "Authorization: Bearer $GORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"twitter.profile","input":{"usernames":["example"]}}'
```

## Response

One row of the response. Values are illustrative.

```json theme={null}
{
  "id": "1234567890",
  "desc": "Building tools for people who ship. Occasional threads about deep space.",
  "name": "Priya Raman",
  "avatar": "https://example.com/media/sample-avatar.jpg",
  "status": "active",
  "friends": 312,
  "profile": "example_user",
  "rest_id": "1234567890",
  "website": "https://example.com",
  "location": "Lisbon, Portugal",
  "protected": false,
  "sub_count": 48213,
  "affiliates": [],
  "created_at": "Mon Mar 04 11:22:19 +0000 2013",
  "media_count": 884,
  "header_image": "https://example.com/media/sample-header.jpg",
  "blue_verified": true,
  "statuses_count": 5107,
  "business_account": {
    "affiliates_count": 2
  },
  "verification_type": "Business",
  "pinned_tweet_ids_str": [
    "1234567890123456789"
  ]
}
```