Overview

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 for key management.

Sources

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

Vinted — marketplace listings and reference data
X — tweets, profiles, and search
Reddit — posts, comments, subreddits, and users

Pagination

Pagination differs by Source: Vinted — page-based. Search responses include:

{
  "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 for the { error, code? } envelope, status codes, and X availability codes.

Guides

Sources

API Reference

Base URL

Authentication

Sources

Errors

​Base URL

​Authentication

​Sources

​Pagination

​Errors

Base URL

Authentication

Sources

Pagination

Errors