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.
Request
- Base URL: https://firstsited.com/api/v1
- URL: https://firstsited.com/api/v1/launches
- Auth: HTTP bearer
Query parameters
Rows to return; default 50, maximum 100. A larger value is clamped.
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.
Row offset. Ignored when a cursor is present.
Lower bound on when the row entered our corpus, inclusive. This is the parameter to poll on, not since.
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.
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.
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.
Lower bound on the launch date, inclusive. For historical queries, not for polling.
Upper bound on the launch date, exclusive.
Technology slug.
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.
Category slug.
ISO2 country code.
Either directory or discovered.
Restrict to sites classed as product launches.
Set to quality to attach banded quality columns.
Shorthand setting both floors below. The two per-dimension parameters win where both are supplied.
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.
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.
Changes
No recorded changes to this operation across all 1 revision of this API.