CSV export

The same rows as the feed, as CSV. Every row counts against your site ceiling, so a large export can spend a whole period of that ceiling in a single call. Exports carry a per-key watermark; redistribution is not permitted under the data licence.

With the contacts scope the file gains contact_email, contact_url and contact_checked_at, positioned immediately after url. The columns are present whenever the key is entitled, even where no row on that page carries an address, so parsing by position is stable. An empty pair with a contact_checked_at means the site was examined and publishes nothing; an empty contact_checked_at means it has not been examined.

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

get/export

Request

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

Query parameters

typestring

Export set.

limitinteger

Rows to return; capped at 5000.

observed_sincestring

Lower bound on when the row entered our corpus, inclusive.

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.

sincestring

Lower bound on the launch date, inclusive.

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. Contact columns need no include; they follow the contacts scope.

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.

Changes

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