Skip to main content
POST
Create an RSS watch

Authorizations

x-api-key
string
header
required

API key created from the Nephia dashboard for your Account.

Headers

Idempotency-Key
string

Unique key (e.g. UUID) making this POST safe to retry for 24 hours. Replays return the original response with an Idempotency-Replayed: true header; reusing a key with a different body returns 422.

Maximum string length: 255

Body

application/json
refresh_interval_seconds
number
required
Required range: 120 <= x <= 86400
feed_url
string<uri>
query
string
Minimum string length: 1
terms
string[]

Several search texts, OR'd into one upstream request. Mutually exclusive with query, and billed as one tick — the cost does not scale with the number of terms. Your plan caps how many a single search may carry.

Minimum array length: 2
Required string length: 1 - 60
lang
string
Required string length: 2 - 8
country
string
Required string length: 2 - 4
webhook_url
string<uri>
ai
object
backfill
boolean
match
enum<string>

How strictly results must carry your query. Omit for the platform's own matching (default). word keeps only items containing the query as a whole word (and quotes it upstream where the platform honours quotes); contains keeps items containing it as a substring.

Available options:
platform,
word,
contains

Response

Watch created

id
string
required
accountId
string
required
source
enum<string>
required
Available options:
x,
reddit,
youtube,
tiktok,
bluesky,
hackernews,
mastodon,
lemmy,
github,
producthunt,
stackoverflow,
rss,
ai_answers,
vinted
market
string
required
criteria
object
required
criteriaHash
string
required
refreshIntervalSeconds
number
required
webhookUrl
string | null
required
billingMode
enum<string>
required
Available options:
subscription,
payg,
deferred,
metered
isActive
boolean
required
createdAt
string
required
updatedAt
string
required
pausedReason
string | null