Create a watch

A standing watch over newly detected launches, delivered by HMAC-signed webhook, Slack webhook or email digest. Technology and keyword counts per watch and total watches are capped by plan.

Requires the watches scope. Available on: indie, pro, firehose.

post/watches

Request

  • Base URL: https://firstsited.com/api/v1
  • URL: https://firstsited.com/api/v1/watches
  • Auth: HTTP bearer

Request body

techsstring[]

Technologies, matching ANY one of them.

techsAllstring[]

Technologies the launch must ALL carry. Counts toward the per-watch technology allowance.

techsExcludingstring[]

Technologies that disqualify a launch. FREE: never counts toward the allowance, since each one narrows the watch. Means NOT DETECTED rather than not installed, so only reliably detected technologies may be excluded.

keywordsstring[]

Words the launch's name, tagline, page title, first heading or meta description must carry, matching ANY one of them. Whole words, case-insensitive; a multi-word entry is a phrase. Each must be 3 to 60 characters. Capped per watch by the plan (maxKeywordsPerWatch in x-stackscope-plans), on its own allowance rather than the technologies', so a technology and a keyword fit together on every plan. A keyword so common that a month of it would exceed the plan's launch ceiling is refused at creation with the estimate that says so.

categoriesstring[]

Product categories, matching any one.

countriesstring[]

ISO2 country codes, matching any one.

indieboolean

Restrict to launches classed as indie.

hasEmailboolean

Only launches whose site publishes a role email address (true), or only those that do not (false). Omit for no filter. Needs the contacts scope; refused with 400 without it.

hasContactUrlboolean

Only launches whose site publishes its own contact page (true), or only those that do not (false). Omit for no filter; set both to require both. Needs the contacts scope; refused with 400 without it.

channel'webhook' | 'slack' | 'email' | 'portal'

Delivery channel.

webhookUrlstring

HTTPS endpoint; required for webhook and slack.

digestCadence'instant' | 'daily' | 'weekly'

Delivery cadence.

Response

Success.

object required

Changes

No recorded changes to this operation across all 1 revision of this API.