---
title: "Count services"
method: GET
path: "/api/v1/services/facets"
tags: ["Catalog"]
---

# Count services

`GET /api/v1/services/facets`

## Request

- Base URL: `https://spoofy.social`
- URL: `https://spoofy.social/api/v1/services/facets`
- Auth: none required

How many services match the filters, and for each platform, metric, target, tier, kind and country value how many it has with the other filters applied — what a filter bar shows next to each choice. The same filters as GET /api/v1/services.

## Query parameters

- `platform` string
- `metric` string
- `target` string
- `tier` string
- `kind` string
- `country` string
- `q` string

## Response `200`

The counts.

- CatalogFacets
  - `total` integer: How many services match all the filters.
  - `facets` object: Per dimension, how many services each value has with the other filters applied (not its own), most first. `country` values are ISO codes, regions (EU, ASIA, …) and WW (worldwide).
    - `platform` FacetValue[]
      - `value` string: What to pass to the filter of the same name.
      - `label` string
      - `count` integer
    - `metric` FacetValue[]
      - `value` string: What to pass to the filter of the same name.
      - `label` string
      - `count` integer
    - `target` FacetValue[]
      - `value` string: What to pass to the filter of the same name.
      - `label` string
      - `count` integer
    - `tier` FacetValue[]
      - `value` string: What to pass to the filter of the same name.
      - `label` string
      - `count` integer
    - `kind` FacetValue[]
      - `value` string: What to pass to the filter of the same name.
      - `label` string
      - `count` integer
    - `country` FacetValue[]
      - `value` string: What to pass to the filter of the same name.
      - `label` string
      - `count` integer

## Other responses

- `400`: A parameter has a value it cannot take.
- `429`: Slow down: too many requests in a short time. Wait `Retry-After` seconds and carry on.

---

[API](https://skmtc.dev/spoofy/apis/spoofy-api.md) · [All operations](https://skmtc.dev/spoofy/apis/spoofy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spoofy/apis/spoofy-api/revisions/58adc986f826?raw)