ChromeWebStore API endpoint
Returns Chrome Web Store search result cards for a keyword, each with id, name, rating, user count, publisher and detail URL. Defaults: `num=30`, `country=us`, `lang=en`.
/chromewebstore/searchMCP tool: chromewebstore_search
Query parameters:
term (required) — search keyword.num — maximum number of results, default 30.country — two-letter storefront country code, default us.lang — two-letter language code, default en.Response behavior:
id, name, icon, summary, rating,
rating_count, users, publisher, category, and a detail url.results array means the query genuinely returned no items — it does
not mean a specific item is missing. To confirm an item's presence, look it up
directly with chromewebstore_item.200 with an empty array.| Field | Filled in, of 10 checked | Values in the sample |
|---|---|---|
| id | 10 | |
| name | 10 | “Free VPN for Chrome - VPN Proxy VeePN” and 9 other values |
| icon | 10 | lh3.googleusercontent.com |
| tile_image | 10 | lh3.googleusercontent.com |
| summary | 10 | median 115 characters |
| rating | 10 | 3.45 to 4.84, median 4.51 |
| rating_count | 10 | 1,969 to 368,026, median 30,273 |
| users | 10 | 500,000 to 15,000,000, median 1,000,000 |
| publisher | 9 | “veepn.com” and 8 other values |
| category | 10 | make_chrome_yours/privacy (6), productivity/workflow (2), productivity/tools (1) and 1 more |
| category_id | 10 | |
| url | 10 | chromewebstore.google.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| term | string | Yes | Search keyword | vpn | |
| num | integer | No | Maximum number of results | 30 | |
| 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/search?term=vpn&num=10&country=us&lang=en" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"query": "vpn",
"count": 1,
"results": [
{
"id": "majdfhpaihoncoakbjgbdhglocklcgno",
"name": "Free VPN for Chrome - VPN Proxy VeePN",
"rating": 4.5,
"rating_count": 50285,
"publisher": "veepn.com",
"url": "https://chromewebstore.google.com/detail/majdfhpaihoncoakbjgbdhglocklcgno"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/chromewebstore.searchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | chromewebstore.SearchResult | No | ||||
| data.count | integer | No | Number of items returned in `results`. | |||
| data.query | string | No | Search keyword that was run. | |||
| data.results | array | No | Items matching the search, 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. | |||
| 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/search?term=vpn&num=10&country=us&lang=en" \
-H "x-api-key: $CRAWLORA_API_KEY"