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

# Introduction

> Structured data from live Sources — pull on demand or subscribe with Watches.

Nephia is a B2B API for structured data from live Sources (Vinted, X, Reddit). Pull on demand or subscribe with Watches that push webhook events.

## Sources

Each **Source** has its own endpoints, filters, and watch behaviour. See [Vinted](/sources/vinted) for market details, [X](/sources/x) for X-specific behaviour, and [Reddit](/sources/reddit) for Reddit.

## Pull vs watch

**Pull** — request data on demand. Each call deducts credits from your Account balance.

**Watch** — subscribe to search criteria. Nephia polls on an interval and POSTs webhook events when matches change. Each poll tick deducts credits; see [Credits](/credits#watch-billing) and [Watches](/watches).

| Mode  | Use when                                   |
| ----- | ------------------------------------------ |
| Pull  | Ad-hoc lookups, backfills, one-off queries |
| Watch | Real-time alerts on new listings or tweets |

## Auth

All product API calls use an API key tied to your **Account** (billing tenant). See [Authentication](/authentication).