---
title: "Stack breakdown"
method: GET
path: "/breakdown"
---

# Stack breakdown

`GET /breakdown`

## Request

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

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.

## Query parameters

- `technology_category` string
- `tech` string
- `keywords` string
- `category` string
- `country` string
- `launch_type` string
- `indie` boolean
- `since` string
- `until` string
- `observed_since` string
- `observed_until` string
- `has_email` string
- `has_contact_url` string
- `min_country_confidence` number

## Response `200`

Success.

- object

## Other responses

- `400`: A required parameter is missing or malformed.
- `401`: No usable key. While the API is unannounced this is masked as 404.
- `403`: The key or plan does not carry the required scope.
- `429`: Quota exhausted (`monthly_credits_exhausted` or `distinct_launch_ceiling_reached`), or the per-key rate limit was exceeded, which returns a plain-text body rather than JSON.

---

[API](https://skmtc.dev/stackscope/apis/firstsited-api.md) · [All operations](https://skmtc.dev/stackscope/apis/firstsited-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stackscope/apis/firstsited-api/revisions/36ae1d406fb1?raw)