> ## 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.

# Overview

> Conventions for the Nephia product API reference.

## Base URL

```
https://api.nephia.cc
```

Local development:

```
http://localhost:3000
```

In the API playground, switch the server dropdown between Production and Local.

## Authentication

Send your API key in every request:

```
x-api-key: YOUR_API_KEY
```

See [Authentication](/authentication) for key management.

## Sources

Endpoints are grouped by Source. Market codes, search filters, and Source-specific behaviour are documented per Source:

* [Vinted](/sources/vinted) — marketplace listings and reference data
* [X](/sources/x) — tweets, profiles, and search
* [Reddit](/sources/reddit) — posts, comments, subreddits, and users

## Pagination

Pagination differs by Source:

**Vinted** — page-based. Search responses include:

```json theme={null}
{
  "items": [],
  "pagination": {
    "currentPage": 1,
    "totalPages": 10,
    "totalEntries": 240,
    "perPage": 24
  }
}
```

**X** — cursor-based. Paginated endpoints return an opaque `nextCursor`. Pass it back unchanged on the next request.

**Reddit** — cursor-based, same idiom as X.

## Errors

See [Errors](/errors) for the `{ error, code? }` envelope, status codes, and X availability codes.