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

# X

> Read tweets, profiles, and search on X via Nephia.

X endpoints live under `/v1/x/*`. See the [API Reference](/api-reference/overview) for the full endpoint list. Credit rates are in [Credits](/credits#x).

## Pagination

Search, timelines, replies, thread, quotes, retweeters, likers, followers, and following use an opaque `nextCursor`. Pass it back unchanged on the next request.

## Verification fields

User objects expose two separate flags:

* `verified` — legacy checkmark (government/brand/org verification before X Premium)
* `isBlueVerified` — X Premium / Blue subscription badge

Read both fields. They are not interchangeable.

## XUser ref

On user-keyed routes (`/v1/x/users/:ref/tweets`, `/likes`, `/media`, `/followers`, etc.), `:ref` accepts either a screen name or a numeric user id.

## Tweet lookup

`GET /v1/x/tweets` and `POST /v1/x/tweets/lookup` support batch lookup (up to 100 ids). Responses use partial success: `{ meta, data, errors }` with per-ID availability codes. See [Errors — X availability](/errors#x-availability).

## Profile availability (soft 404)

Profile and XUser-keyed endpoints return HTTP **404** with `USER_NOT_FOUND`, `USER_PROTECTED`, or `USER_SUSPENDED` when the target account state prevents a response. Credits are still charged for definitive 404s.

## Likes and likers session limits

**Likes** (`/v1/x/users/:ref/likes`) typically only returns likes visible to the authenticated X session. For other users, results are often empty or heavily limited.

**Likers** (`/v1/x/tweets/:id/likers`) may return an empty page when X does not expose the liker list to the session.

## Thread vs replies vs quotes

**Thread** (`/v1/x/tweets/:id/thread`) — the focal tweet plus chained self-replies by the same author. Not third-party replies.

**Replies** (`/v1/x/tweets/:id/replies`) — conversation replies under the tweet (paginated). Distinct from thread.

**Quotes** (`/v1/x/tweets/:id/quotes`) — quote-tweets of the given tweet (paginated via search).

## Trends

`GET /v1/x/trends` returns trending topics for a WOEID place. Query param: `woeid` (optional, default `1` = Worldwide).

Use `GET /v1/x/trends/locations` to list every valid WOEID — that catalogue is the source of truth.

## Watches

X watches poll a search query and deliver `tweet.created` webhooks. See [Watches](/watches) and [Webhooks](/webhooks).