New-launch feed

Launches in reverse chronological order, filterable by technology, category and country. Plans without the feed scope can retrieve the same rows through /export.

Requires the feed scope. Available on: pro, firehose.

get/launches

Request

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

Query parameters

limitinteger

Rows to return; default 50, maximum 100. A larger value is clamped.

cursorstring

Opaque cursor from the previous response's nextCursor. Preferred over offset. A cursor is bound to the filters it was issued under, so repeat every filter alongside it or the call returns 400 cursor_filter_mismatch.

offsetinteger

Row offset. Ignored when a cursor is present.

observed_sincestring

Lower bound on when the row entered our corpus, inclusive. This is the parameter to poll on, not since.

has_emailstring

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.

has_contact_urlstring

Only launches whose site publishes its own contact page (true), or only those that do not (false). Omit for no filter. Needs the contacts scope.

observed_untilstring

Upper bound on when the row entered our corpus, exclusive. End it short of the present so the window has settled before you read it.

sincestring

Lower bound on the launch date, inclusive. For historical queries, not for polling.

untilstring

Upper bound on the launch date, exclusive.

techstring

Technology slug.

keywordsstring

Whole words the launch's name, tagline, page title, first heading or meta description must carry, matching ANY one of them. Comma-separated, or repeat the parameter. Case-insensitive; a multi-word entry is a phrase; each 3 to 60 characters, up to ten. The same rule a watch's keywords use, so a word that filters here is the word a watch would fire on. A term outside the rule returns 400 invalid_keywords rather than being dropped.

categorystring

Category slug.

countrystring

ISO2 country code.

launch_typestring

Either directory or discovered.

indieboolean

Restrict to sites classed as product launches.

includestring

Set to quality to attach banded quality columns.

min_confidencenumber

Shorthand setting both floors below. The two per-dimension parameters win where both are supplied.

min_category_confidencenumber

Category floor, 0 to 1. No floor by default: every category we hold is served with its confidence. Set 0.9 to match the public site.

min_country_confidencenumber

Country floor, 0 to 1. No floor by default. Set 0.45 to match the public site; 0.9/0.45 together reproduce the figures published on /data.

Response

Success.

object required

Changes

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