---
title: "Facet the TrustMRR dataset"
method: GET
path: "/datasets/trustmrr/facets"
tags: ["Datasets"]
---

# Facet the TrustMRR dataset

`GET /datasets/trustmrr/facets`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/datasets/trustmrr/facets`
- Auth: API key in header `x-api-key`

Returns terms-aggregation counts for one facet of the TrustMRR dataset, scoped to the same filters as search. Facet enum: `category`, `country`, `payment_provider`, `target_audience`, `business_type`, `tech`, `channels`, `listing_tier`, `status`, `on_sale`, `is_sponsored`, `tags`.

## Query parameters

- `facet` 'category' | 'country' | 'payment_provider' | 'target_audience' | 'business_type' | 'tech' | 'channels' | 'listing_tier' | 'status' | 'on_sale' | 'is_sponsored' | 'tags', required
- `q` string
- `category` string
- `country` string
- `payment_provider` string
- `on_sale` boolean
- `min_mrr` number

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsTrustmrrFacetResponseDoc
  - `code` integer
  - `data` DatasetsTrustmrrFacetResponse
    - `dataset` string: Identifier of the dataset queried (`trustmrr`).
    - `facet` string: Facet that was aggregated.
    - `items` EsTrustmrrDatasetFacetItem[]: Facet values with the number of matching records for each.
      - `count` integer: Number of startups in this bucket.
      - `value` string: Bucket value for the requested facet, such as a category name, country or payment provider.
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `500`: Internal Server Error

---

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