# Nephia

## Docs

- [Get credit balance](https://docs.nephia.cc/api-reference/account/get-credit-balance.md): Returns the remaining pull credits for your Account. Free — does not charge credits.
- [Overview](https://docs.nephia.cc/api-reference/overview.md): Conventions for the Nephia product API reference.
- [Get a Reddit post by id](https://docs.nephia.cc/api-reference/reddit-—-posts/get-a-reddit-post-by-id.md): Costs 2 credits. Post only — use /comments for the thread.
- [Get comment thread for a post](https://docs.nephia.cc/api-reference/reddit-—-posts/get-comment-thread-for-a-post.md): Costs 2 base + 2 per successful morechildren batch (max 8 batches → max 18 credits). Returns meta.credits_used.
- [Get duplicate posts](https://docs.nephia.cc/api-reference/reddit-—-posts/get-duplicate-posts.md): Costs 4 credits per page.
- [Get trending Reddit posts](https://docs.nephia.cc/api-reference/reddit-—-posts/get-trending-reddit-posts.md): Costs 2 credits per page.
- [List posts by domain](https://docs.nephia.cc/api-reference/reddit-—-posts/list-posts-by-domain.md): Costs 4 credits per page.
- [Search Reddit posts](https://docs.nephia.cc/api-reference/reddit-—-search/search-reddit-posts.md): Costs 4 credits per page. Cursor is opaque.
- [Search Reddit users](https://docs.nephia.cc/api-reference/reddit-—-search/search-reddit-users.md): Costs 4 credits per page.
- [Search subreddits](https://docs.nephia.cc/api-reference/reddit-—-search/search-subreddits.md): Costs 4 credits per page.
- [Get subreddit profile](https://docs.nephia.cc/api-reference/reddit-—-subreddits/get-subreddit-profile.md): Costs 2 credits.
- [Get subreddit rules](https://docs.nephia.cc/api-reference/reddit-—-subreddits/get-subreddit-rules.md): Costs 1 credits.
- [Get subreddit wiki page](https://docs.nephia.cc/api-reference/reddit-—-subreddits/get-subreddit-wiki-page.md): Costs 3 credits.
- [List new subreddits](https://docs.nephia.cc/api-reference/reddit-—-subreddits/list-new-subreddits.md): Costs 2 credits per page.
- [List popular subreddits](https://docs.nephia.cc/api-reference/reddit-—-subreddits/list-popular-subreddits.md): Costs 2 credits per page.
- [List subreddit posts](https://docs.nephia.cc/api-reference/reddit-—-subreddits/list-subreddit-posts.md): Costs 4 credits per page.
- [Get Reddit user profile](https://docs.nephia.cc/api-reference/reddit-—-users/get-reddit-user-profile.md): Costs 2 credits.
- [Get user trophies](https://docs.nephia.cc/api-reference/reddit-—-users/get-user-trophies.md): Costs 1 credits.
- [List moderated subreddits](https://docs.nephia.cc/api-reference/reddit-—-users/list-moderated-subreddits.md): Costs 3 credits.
- [List user comments](https://docs.nephia.cc/api-reference/reddit-—-users/list-user-comments.md): Costs 4 credits per page.
- [List user submitted posts](https://docs.nephia.cc/api-reference/reddit-—-users/list-user-submitted-posts.md): Costs 4 credits per page.
- [Create a Reddit watch](https://docs.nephia.cc/api-reference/reddit-—-watches/create-a-reddit-watch.md): Requires query and/or subreddit. Metered per tick at the search credit rate. Minimum interval 60s. NSFW content is included by default; set include_nsfw to false to opt out.
- [Deactivate a Reddit watch](https://docs.nephia.cc/api-reference/reddit-—-watches/deactivate-a-reddit-watch.md)
- [Get a Reddit watch](https://docs.nephia.cc/api-reference/reddit-—-watches/get-a-reddit-watch.md): Returns a watch for your account. Free — does not charge credits.
- [List Reddit watch activity](https://docs.nephia.cc/api-reference/reddit-—-watches/list-reddit-watch-activity.md): Poll heartbeats and webhook delivery outcomes since an ISO timestamp. Ordered newest first. Default window: last 7 days. Free — does not charge credits.
- [List Reddit watch events](https://docs.nephia.cc/api-reference/reddit-—-watches/list-reddit-watch-events.md)
- [List Reddit watches](https://docs.nephia.cc/api-reference/reddit-—-watches/list-reddit-watches.md): Returns watches for your account. Free — does not charge credits.
- [Pause a Reddit watch](https://docs.nephia.cc/api-reference/reddit-—-watches/pause-a-reddit-watch.md)
- [Resume a paused Reddit watch](https://docs.nephia.cc/api-reference/reddit-—-watches/resume-a-paused-reddit-watch.md)
- [Get listing details](https://docs.nephia.cc/api-reference/vinted-—-items/get-listing-details.md): Costs 9 credit per request.
- [List reference catalog data](https://docs.nephia.cc/api-reference/vinted-—-reference/list-reference-catalog-data.md): Credits per type: brands: 2, colors: 1, statuses: 1, sizes: 1, markets: 1. Use query for brand search (e.g. type=brands&query=nike).
- [Search Vinted listings](https://docs.nephia.cc/api-reference/vinted-—-search/search-vinted-listings.md): Costs 4 credit per request.
- [Get seller profile](https://docs.nephia.cc/api-reference/vinted-—-users/get-seller-profile.md): Costs 2 credit per request.
- [List seller listings](https://docs.nephia.cc/api-reference/vinted-—-users/list-seller-listings.md): Costs 2 credit per request.
- [Create a watch](https://docs.nephia.cc/api-reference/vinted-—-watches/create-a-watch.md): Subscribe to listing changes matching search criteria. Webhook delivery and billing are documented separately.
- [Deactivate a watch](https://docs.nephia.cc/api-reference/vinted-—-watches/deactivate-a-watch.md)
- [Get a watch](https://docs.nephia.cc/api-reference/vinted-—-watches/get-a-watch.md): Returns a watch for your account. Free — does not charge credits.
- [List watch activity](https://docs.nephia.cc/api-reference/vinted-—-watches/list-watch-activity.md): Poll heartbeats and webhook delivery outcomes since an ISO timestamp. Ordered newest first. Default window: last 7 days. Free — does not charge credits.
- [List watch events](https://docs.nephia.cc/api-reference/vinted-—-watches/list-watch-events.md): Replay events since an ISO timestamp. Ordered newest first. Free — does not charge credits.
- [List watches](https://docs.nephia.cc/api-reference/vinted-—-watches/list-watches.md): Returns watches for your account. Free — does not charge credits.
- [Pause a watch](https://docs.nephia.cc/api-reference/vinted-—-watches/pause-a-watch.md)
- [Resume a paused watch](https://docs.nephia.cc/api-reference/vinted-—-watches/resume-a-paused-watch.md)
- [Get list timeline](https://docs.nephia.cc/api-reference/x-—-lists/get-list-timeline.md): Costs 4 credits per page.
- [Search tweets](https://docs.nephia.cc/api-reference/x-—-search/search-tweets.md): Costs 4 credits per page. Cursor is opaque.
- [Get trends for a place](https://docs.nephia.cc/api-reference/x-—-trends/get-trends-for-a-place.md): Costs 4 credits. Query param `woeid` (optional, default `1` = Worldwide). Common WOEIDs: `1` Worldwide, `23424977` United States, `23424975` United Kingdom, `23424819` France, `23424775` Canada, `23424829` Germany, `23424853` Italy, `23424950` Spain, `23424856` Japan, `23424768` Brazil, `2459115` Ne…
- [List trend locations](https://docs.nephia.cc/api-reference/x-—-trends/list-trend-locations.md): Costs 2 credits. Returns the full WOEID catalogue from X (countries, cities, and Worldwide). No query parameters. Pass a location `woeid` to `GET /v1/x/trends?woeid=` to fetch that place's trends. Common WOEIDs: `1` Worldwide, `23424977` United States, `23424975` United Kingdom, `23424819` France, `…
- [Get tweet likers](https://docs.nephia.cc/api-reference/x-—-tweets/get-tweet-likers.md): Costs 4 credits per page.
- [Get tweet quotes](https://docs.nephia.cc/api-reference/x-—-tweets/get-tweet-quotes.md): Costs 4 credits per page.
- [Get tweet replies](https://docs.nephia.cc/api-reference/x-—-tweets/get-tweet-replies.md): Costs 4 credits per page.
- [Get tweet retweeters](https://docs.nephia.cc/api-reference/x-—-tweets/get-tweet-retweeters.md): Costs 4 credits per page.
- [Get tweet thread](https://docs.nephia.cc/api-reference/x-—-tweets/get-tweet-thread.md): Costs 4 credits per page.
- [Lookup tweets by IDs](https://docs.nephia.cc/api-reference/x-—-tweets/lookup-tweets-by-ids.md): Costs 1 base + 1 per found tweet.
- [Lookup tweets by IDs (POST)](https://docs.nephia.cc/api-reference/x-—-tweets/lookup-tweets-by-ids-post.md): Same billing as GET. Costs 2+ credits depending on results.
- [Get user followers](https://docs.nephia.cc/api-reference/x-—-users/get-user-followers.md): Costs 4 credits per page.
- [Get user following](https://docs.nephia.cc/api-reference/x-—-users/get-user-following.md): Costs 4 credits per page.
- [Get user likes](https://docs.nephia.cc/api-reference/x-—-users/get-user-likes.md): Costs 4 credits per page. Likes visibility depends on the authenticated session — often limited for other users.
- [Get user media tweets](https://docs.nephia.cc/api-reference/x-—-users/get-user-media-tweets.md): Costs 4 credits per page. `:username` accepts an XUser ref (username or numeric id).
- [Get user timeline](https://docs.nephia.cc/api-reference/x-—-users/get-user-timeline.md): Costs 4 credits per page. `:username` accepts an XUser ref (username or numeric id).
- [Get user tweets and replies](https://docs.nephia.cc/api-reference/x-—-users/get-user-tweets-and-replies.md): Costs 4 credits per page.
- [Get X user profile](https://docs.nephia.cc/api-reference/x-—-users/get-x-user-profile.md): Costs 2 credits. `verified` is legacy checkmark only; `isBlueVerified` is X Premium/Blue (soft-breaking vs early Nephia).
- [Get X user profile by id](https://docs.nephia.cc/api-reference/x-—-users/get-x-user-profile-by-id.md): Costs 2 credits. `verified` is legacy checkmark only; `isBlueVerified` is X Premium/Blue (soft-breaking vs early Nephia).
- [Search X users](https://docs.nephia.cc/api-reference/x-—-users/search-x-users.md): Costs 4 credits per page. Path param on other user routes also accepts an XUser ref (username or numeric id).
- [Create an X watch](https://docs.nephia.cc/api-reference/x-—-watches/create-an-x-watch.md): Metered per tick at the search credit rate. Minimum interval 60s.
- [Deactivate an X watch](https://docs.nephia.cc/api-reference/x-—-watches/deactivate-an-x-watch.md)
- [Get an X watch](https://docs.nephia.cc/api-reference/x-—-watches/get-an-x-watch.md): Returns a watch for your account. Free — does not charge credits.
- [List X watch activity](https://docs.nephia.cc/api-reference/x-—-watches/list-x-watch-activity.md): Poll heartbeats and webhook delivery outcomes since an ISO timestamp. Ordered newest first. Default window: last 7 days. Free — does not charge credits.
- [List X watch events](https://docs.nephia.cc/api-reference/x-—-watches/list-x-watch-events.md)
- [List X watches](https://docs.nephia.cc/api-reference/x-—-watches/list-x-watches.md): Returns watches for your account. Free — does not charge credits.
- [Pause an X watch](https://docs.nephia.cc/api-reference/x-—-watches/pause-an-x-watch.md)
- [Resume a paused X watch](https://docs.nephia.cc/api-reference/x-—-watches/resume-a-paused-x-watch.md)
- [Authentication](https://docs.nephia.cc/authentication.md): Authenticate product API requests with an API key on your Account.
- [Credits](https://docs.nephia.cc/credits.md): Pull and watch credit costs for your Account.
- [Errors](https://docs.nephia.cc/errors.md): HTTP status codes and the client error envelope.
- [Introduction](https://docs.nephia.cc/introduction.md): Structured data from live Sources — pull on demand or subscribe with Watches.
- [Quickstart](https://docs.nephia.cc/quickstart.md): Make your first authenticated search request in minutes.
- [SDK (Node.js)](https://docs.nephia.cc/sdk.md): Official TypeScript client for the Nephia API.
- [Reddit](https://docs.nephia.cc/sources/reddit.md): Read posts, comments, subreddits, and users on Reddit via Nephia.
- [Vinted](https://docs.nephia.cc/sources/vinted.md): Pull listings, sellers, and reference data from Vinted.
- [X](https://docs.nephia.cc/sources/x.md): Read tweets, profiles, and search on X via Nephia.
- [Watches](https://docs.nephia.cc/watches.md): Subscribe to search criteria and receive webhook events on each poll tick.
- [Webhooks](https://docs.nephia.cc/webhooks.md): Receive listing and tweet events from watches.

## OpenAPI Specs

- [openapi](https://docs.nephia.cc/openapi.json)