Watches

A Watch polls a Source on a fixed interval, compares results to the previous snapshot, and emits webhook events when matches change. See Webhooks for payload shape, signatures, and event types.

Lifecycle

Action	Method	Notes
Create	`POST /v1/{source}/watches`	Provide `criteria`, `refresh_interval_seconds`, and `webhook_url`
List	`GET /v1/{source}/watches`	All watches for your Account
Get	`GET /v1/{source}/watches/{id}`	Single watch for your Account
Pause	`POST /v1/{source}/watches/{id}/pause`	Stops polling; `pausedReason: user_paused`
Resume	`POST /v1/{source}/watches/{id}/resume`	Restarts polling after manual pause or insufficient credits
Delete	`DELETE /v1/{source}/watches/{id}`	Stops polling and removes the watch

Per-Source limits

Source	Base path	Interval min–max	Active cap
Vinted	`/v1/vinted/watches`	15s–3600s	50
X	`/v1/x/watches`	60s–3600s	20

Billing

Each poll tick charges 4 credits before the poll runs. See Credits — Watch billing. When credits are insufficient, the watch is auto-paused with pausedReason: insufficient_credits. Polling does not resume automatically — call POST /v1/{source}/watches/{id}/resume after topping up.

Activity log

GET /v1/{source}/watches/{id}/activity returns operational events for a watch: poll.completed, poll.failed, webhook.delivered, webhook.failed. Each entry includes creditsCharged, eventsEmitted, and delivery metadata where applicable.

curl "https://api.nephia.cc/v1/vinted/watches/WATCH_ID/activity?since=2026-07-01T00:00:00.000Z" \
  -H "x-api-key: YOUR_API_KEY"

Event types

See Webhooks — Event types for the canonical list.

Guides

Sources

API Reference

Lifecycle

Per-Source limits

Billing

Activity log

Event types

​Lifecycle

​Per-Source limits

​Billing

​Activity log

​Event types

Lifecycle

Per-Source limits

Billing

Activity log

Event types