Datasets API endpoint
Returns aggregation buckets. Facet enum: `item_type`, `category`, `developer`, `developer_email`, `manifest_version`, `permission`, `status`, `collects_data`, `has_broad_host_access`. Item type enum: `extension`, `theme`, `app`, `unknown`. Search sort, status and manifest-version enums match the search endpoint.
/datasets/chrome-extensions/facetsfacet is required. Allowed values: item_type, category, developer, developer_email, manifest_version, permission, status, collects_data, has_broad_host_access. Search filters, including the exact developer_email filter, match the search endpoint. Allowed item_type values are extension, theme, app, unknown; status accepts active, removed; manifest_version accepts 2, 3; and sort accepts relevance, users_desc, rating_desc, reviews_desc, updated_desc, trending_desc.
| Field | Filled in, of 2 checked | Values in the sample |
|---|---|---|
| value | 2 | 2 to 3, median 2 |
| count | 2 | 70,784 to 334,952, median 70,784 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| facet | string | Yes | Facet enum: item_type, category, developer, developer_email, manifest_version, permission, status, collects_data, has_broad_host_access Allowed values: item_type, category, developer, developer_email, manifest_version, permission, status, collects_data, has_broad_host_access. | item_type | |
| q | string | No | Full-text query | ||
| item_type | string | No | Item type enum: extension, theme, app, unknown Allowed values: extension, theme, app, unknown. | ||
| category | string | No | Exact category | ||
| developer | string | No | Exact developer | ||
| developer_email | string | No | Exact developer email | ||
| permission | string | No | Exact permission | ||
| status | string | No | Status enum: active, removed Allowed values: active, removed. | ||
| manifest_version | integer | No | Manifest version enum: 2, 3 Allowed values: 2, 3. | ||
| collects_data | boolean | No | Data-collection filter | ||
| has_broad_host_access | boolean | No | Broad-host-access filter | ||
| min_users | integer | No | Minimum users | ||
| min_rating | number | No | Minimum rating | ||
| min_rating_count | integer | No | Minimum rating count | ||
| sort | string | No | Sort enum: relevance, users_desc, rating_desc, reviews_desc, updated_desc, trending_desc Allowed values: relevance, users_desc, rating_desc, reviews_desc, updated_desc, trending_desc. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/datasets/chrome-extensions/facets?facet=item_type&q=coffee&item_type=extension&status=active&manifest_version=2&collects_data=true&has_broad_host_access=true&sort=relevance" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"dataset": "chrome-extensions",
"facet": "item_type",
"items": [
{
"value": "extension",
"count": 200000
},
{
"value": "theme",
"count": 50000
}
]
}
}Request schema
No body schema
Response schema
#/definitions/datasets.chromeExtensionFacetResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | datasets.ChromeExtensionFacetResponse | No | ||||
| data.dataset | string | No | Identifier of the dataset queried (`chrome-extensions`). | |||
| 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 items with this value. | |||
| data.items[].value | string | No | Facet value being counted. | |||
| 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/chrome-extensions/facets?facet=item_type&q=coffee&item_type=extension&status=active&manifest_version=2&collects_data=true&has_broad_host_access=true&sort=relevance" \
-H "x-api-key: $CRAWLORA_API_KEY"