Datasets API endpoint
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`.
/datasets/trustmrr/facetsReturns terms-aggregation counts for one facet of the TrustMRR dataset, scoped to the same filters as search (so you can, for example, get the category breakdown of for-sale startups with MRR over $10k).
Query parameters:
facet: required. Allowed values: category, country, payment_provider, target_audience, business_type, tech, channels, listing_tier, status, on_sale, is_sponsored, tags./datasets/trustmrr/search filters are accepted to scope the aggregation (e.g. q, category, country, payment_provider, on_sale, min_mrr).| Field | Filled in, of 31 checked | Values in the sample |
|---|---|---|
| value | 31 | |
| count | 31 | 7 to 2,595, median 164 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| facet | string | Yes | Facet enum: category, country, payment_provider, target_audience, business_type, tech, channels, listing_tier, status, on_sale, is_sponsored, tags Allowed values: category, country, payment_provider, target_audience, business_type, tech, channels, listing_tier, status, on_sale, is_sponsored, tags. | category | |
| q | string | No | Full-text query, max 256 characters | ||
| category | string | No | Exact category filter, max 128 characters | ||
| country | string | No | Exact ISO country-code filter, max 128 characters | ||
| payment_provider | string | No | Payment-provider filter, max 128 characters | ||
| on_sale | boolean | No | Filter for startups currently listed for sale | ||
| min_mrr | number | No | Minimum verified MRR in USD | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/datasets/trustmrr/facets?facet=category&q=coffee&country=us&on_sale=true" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"dataset": "trustmrr",
"facet": "category",
"items": [
{
"value": "SaaS",
"count": 1840
},
{
"value": "Artificial Intelligence",
"count": 1210
}
]
}
}Request schema
No body schema
Response schema
#/definitions/datasets.trustmrrFacetResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | datasets.TrustmrrFacetResponse | No | ||||
| data.dataset | string | No | Identifier of the dataset queried (`trustmrr`). | |||
| data.facet | string | No | Facet that was aggregated. | |||
| data.items | array | No | Facet values with the number of matching records for each. | |||
| data.items[].count | integer | No | Number of startups in this bucket. | |||
| data.items[].value | string | No | Bucket value for the requested facet, such as a category name, country or payment provider. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/datasets/trustmrr/facets?facet=category&q=coffee&country=us&on_sale=true" \
-H "x-api-key: $CRAWLORA_API_KEY"