---
title: "Facet the Chrome Web Store dataset"
method: GET
path: "/datasets/chrome-extensions/facets"
tags: ["Datasets"]
---

# Facet the Chrome Web Store dataset

`GET /datasets/chrome-extensions/facets`

## Request

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

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.

## Query parameters

- `facet` 'item_type' | 'category' | 'developer' | 'developer_email' | 'manifest_version' | 'permission' | 'status' | 'collects_data' | 'has_broad_host_access', required
- `q` string
- `item_type` 'extension' | 'theme' | 'app' | 'unknown'
- `category` string
- `developer` string
- `developer_email` string
- `permission` string
- `status` 'active' | 'removed'
- `manifest_version` 2 | 3
- `collects_data` boolean
- `has_broad_host_access` boolean
- `min_users` integer
- `min_rating` number
- `min_rating_count` integer
- `sort` 'relevance' | 'users_desc' | 'rating_desc' | 'reviews_desc' | 'updated_desc' | 'trending_desc'

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsChromeExtensionFacetResponseDoc
  - `code` integer
  - `data` DatasetsChromeExtensionFacetResponse
    - `dataset` string: Identifier of the dataset queried (`chrome-extensions`).
    - `facet` string: Facet that was aggregated.
    - `items` EsChromeExtensionFacetItem[]: Facet values with the number of matching records for each.
      - `count` integer: Number of items with this value.
      - `value` string: Facet value being counted.
  - `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)