ChromeWebStore API endpoint
Returns the item cards in a store top chart. `chart` accepts `trending`, `popular`, or `notable`. Defaults: `chart=popular`, `num=50`, `country=us`, `lang=en`.
/chromewebstore/chartsMCP tool: chromewebstore_charts
Returns the item cards in a Chrome Web Store top chart.
Query parameters:
chart — top chart to list, default popular. Allowed values: trending,
popular, notable.num — maximum number of items, default 50.country — two-letter storefront country code, default us.lang — two-letter language code, default en.Response behavior:
chart value returns a typed invalid-params error (HTTP 400).| Field | Filled in, of 25 checked | Values in the sample |
|---|---|---|
| id | 25 | |
| name | 25 | “Volume Master” and 24 other values |
| icon | 25 | lh3.googleusercontent.com |
| tile_image | 23 | lh3.googleusercontent.com |
| summary | 25 | “Up to 600% volume boost” and 24 other values |
| rating | 25 | 3.13 to 4.89, median 4.47 |
| rating_count | 25 | 26 to 383,230, median 35,773 |
| users | 25 | 600,000 to 65,000,000, median 8,000,000 |
| publisher | 21 | “petasittek.com” and 20 other values |
| category | 25 | “make_chrome_yours/accessibility” and 9 other values |
| category_id | 25 | |
| url | 25 | chromewebstore.google.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| chart | string | No | Top chart to list Allowed values: trending, popular, notable. | ||
| num | integer | No | Maximum number of items | 50 | |
| country | string | No | Two-letter storefront country code | us | |
| lang | string | No | Two-letter language code | en | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/chromewebstore/charts?chart=trending&num=10&country=us&lang=en" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"kind": "chart",
"value": "popular",
"count": 1,
"results": [
{
"id": "jghecgabfgfdldnmbfkhmffcabddioke",
"name": "Volume Master",
"rating": 4.8,
"url": "https://chromewebstore.google.com/detail/jghecgabfgfdldnmbfkhmffcabddioke"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/chromewebstore.listResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | chromewebstore.ListResult | No | ||||
| data.count | integer | No | Number of items returned in `results`. | |||
| data.kind | string | No | Type of list returned: `category`, `collection` or `chart`. | |||
| data.results | array | No | Items in the list, in store order. | |||
| data.results[].category | string | No | Store category of the item, for example `productivity/tools`. | |||
| data.results[].category_id | integer | No | Numeric id of the store category the item is listed in. | |||
| data.results[].icon | string | No | URL of the item icon image. | |||
| data.results[].id | string | No | 32-character Chrome Web Store item id. Use it with the item endpoint. | |||
| data.results[].name | string | No | Item name as shown on the store card. | |||
| data.results[].publisher | string | No | Publisher name or website domain shown on the card. | |||
| data.results[].rating | number | No | Average user rating out of 5. | |||
| data.results[].rating_count | integer | No | Number of ratings the item has received. | |||
| data.results[].summary | string | No | Short summary line shown on the store card. | |||
| data.results[].tile_image | string | No | URL of the item promotional tile image. | |||
| data.results[].url | string | No | Chrome Web Store detail page URL of the item. | |||
| data.results[].users | integer | No | Number of users the store reports for the item. | |||
| data.value | string | No | Category slug, collection slug or chart name that was listed. | |||
| 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/chromewebstore/charts?chart=trending&num=10&country=us&lang=en" \
-H "x-api-key: $CRAWLORA_API_KEY"