Launches using one technology

Changed on

The launches detected using a given technology. Offset paging only, and bounded on the launch date rather than arrival, so it is not the endpoint to poll; use /launches with observed_since and a cursor for a standing job.

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

get/tech/{slug}/launches

Request

  • Base URL: https://firstsited.com/api/v1
  • URL: https://firstsited.com/api/v1/tech/{slug}/launches
  • Auth: HTTP bearer

Path parameters

slugstring required

Technology slug.

Query parameters

limitinteger

Rows to return; default 50, maximum 100.

offsetinteger

Row offset.

sincestring

Lower bound on the launch date, inclusive.

untilstring

Upper bound on the launch date, exclusive.

launch_typestring

Either directory or discovered.

includestring

Set to quality to attach banded quality columns.

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.

nearstring

Only sites within radius of a place: a town or city name, a postcode, or lat,lng. A name that fits several places takes the biggest, with places in the country= filter first; the response names the one used in near. Give radius too. A site we could not place never matches. A place we cannot find returns 400 invalid_near naming it; while the place filter is switched off, 400 location_filter_off.

radiusstring

How far from near: 30mi or 50km, a bare number being km. From 5 to 248 miles (8 to 400 km); outside that returns 400 invalid_near.

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

    • info

      added the new optional query request parameter near

    • info

      added the new optional query request parameter radius