Stack breakdown

The stack of the sites matching a filter, as counts and shares rather than rows: how many carry anything in each kind of technology (payments, analytics, hosting...) and which technologies inside each kind, ranked. Aggregate only, so it returns no per-site rows and never consumes the site ceiling. Each distinct set of filters counts as one Explore slice against the plan's monthly allowance the first time it is worked out; the same filters asked again within ten minutes are served from cache and count nothing. Shares are a floor: only technologies detected on the crawled page are counted, and the technology filtered on is left out of its own breakdown. A set too broad to summarise returns 400 slice_too_broad; a spent slice allowance returns 429 monthly_slices_exhausted.

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

get/breakdown

Request

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

Query parameters

technology_categorystring

One kind of technology to report on, e.g. payments. Omit for every kind. This is the technology's category as /tech lists it, not the site's category. An unknown value returns an empty groups array and names the kinds present in note.

techstring

Technology slug. The matching sites are the population; the technology itself is left out of its own breakdown.

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 of the sites.

countrystring

ISO2 country code.

launch_typestring

Either directory or discovered.

indieboolean

Restrict to sites classed as product launches.

sincestring

Lower bound on the launch date, inclusive.

untilstring

Upper bound on the launch date, exclusive.

observed_sincestring

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

observed_untilstring

Upper bound on when the row entered our corpus, exclusive.

has_emailstring

Only sites that publish a role email address (true), or only those that do not (false). Omit for no filter. Needs the contacts scope.

has_contact_urlstring

Only sites that publish their own contact page (true), or only those that do not (false). Omit for no filter. Needs the contacts scope.

min_country_confidencenumber

Country floor for the country filter, 0 to 1. No floor by default.

Response

Success.

object required

Changes

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