Skip to content
Ask Claude about any Chrome extension, answered with Ext Watch data. See how →
API reference

Ext Watch API docs

26 read-only endpoints, each with parameters, credits, examples in curl, JavaScript and Python, and a response.

Make your first requestAPI pricingBase URL app.extwatch.com/api/v1
297,753 extensionsData as of 2026-11-18
Quickstart
# 1. Your key, from the Developers page in the app
export EXTWATCH_API_KEY="ew_live_…"

# 2. Call any endpoint
curl -G "https://app.extwatch.com/api/v1/extensions" \
  -d "category=workflow-and-planning" \
  -d "users_min=10000" \
  -d "sort=users" \
  -d "limit=3" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"

# 3. Read data, total and meta.data_as_of
200 OKdata · 2 of 2,679Workflow & Planning
ExtensionUsersRating
Adobe AcrobatAdobe, Inc.350M+★ 4.465K
Application Launcher For DriveGoogle Ireland, Ltd.104M+★ 2.62,183
Start here

Quickstart and authentication

Every endpoint is a GET to https://app.extwatch.com/api/v1 with your key in the Authorization header. Data comes from our own crawl of the Chrome Web Store; each listing is read about every 2 days.

Your serverKeeps the key secret$EXTWATCH_API_KEYew_live_ + 32 characters
Bearer ew_live_…Authorization header · HTTPSNo CORS · no key in the URL
Ext Watch APIapp.extwatch.com/api/v126 endpointsRead only
200 OKThe envelopedata · total · basis · meta
401No key, or a bad key
Make a key in the app once you have an API plan.Make a key
Scopes
Each key calls only the endpoint groups you tick. On Business, a key can also be limited to up to 20 IP ranges.
mcp_key_used
An MCP key does not work here. Make an API key instead.
Conventions
snake_case names, lists as ids=a,b, dates as YYYY-MM-DD in UTC. Unknown parameters get unknown_param, so a typo never returns the wrong set.
The 401 body
{
  "error": {
    "type": "authentication",
    "code": "missing_key",
    "message": "Send your API key in the Authorization header as Bearer ew_live_…",
    "param": null,
    "retry_after": null,
    "upgrade_url": null,
    "docs_url": "https://extwatch.com/developers/docs#error-missing-key",
    "request_id": "req_…"
  }
}
/v1/meta
curl "https://app.extwatch.com/api/v1/meta" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Responses

One envelope for every answer

Every success has the same fields around data. Here is a real one from today’s data, one row kept.

200 OKGET /v1/extensions?category=workflow-and-planning&users_min=10000&sort=users&limit=3
{
1 "object": "list",
"endpoint": "extensions.search",
2 "data": [ { "id": "efaidnbmnnnibpcajpcglclefindmkaj", "name": "Adobe Acrobat: PDF edit, convert, sign tools", "publisher_name": "Adobe, Inc.", "users": 350000000, "rating": 4.37, … } ],
3 "total": { "count": 2679, "exact": true, "returned": 3, "unit": "extensions" },
"next_cursor": null,
4 "basis": { "set": "Workflow & Planning extensions with 10,000+ users", "as_of": "2026-11-18", "sort": "users", "filters": [ "category = workflow-and-planning", "users_min = 10000" ], … },
5 "facts": [],
"notes": [],
"not_held": [ "Ext Watch holds no revenue or install figures." ],
6 "app_url": "https://app.extwatch.com/explore/…",
7 "meta": { "request_id": "req_…", "data_as_of": "2026-11-18", "plan": "api_developer", "credits_charged": 1 }
}
Today’s data, as of 2026-11-18. Trimmed.
Open this exact set in the appapp.extwatch.com/explore/…
  1. 1object · endpointWhat came back: list, extension, history, changes and so on, and the endpoint id.
  2. 2dataThe rows or the object. Its shape depends on the endpoint. An empty set is [] with a 200.
  3. 3total · next_cursorThe exact count of the whole set, not the page. v1 has no paging: next_cursor is always null, so narrow the filters to reach other rows.
  4. 4basisThe set, the data day, the window, the sort and the filters used, plus any filter not applied and why.
  5. 5facts · notes · not_heldPlain sentences worked out on our side, short caveats, and what Ext Watch does not hold.
  6. 6app_urlThe same set, with the same filters, in the Ext Watch app.
  7. 7metarequest_id, data_as_of, plan, credits_charged, credits_left and pack_credits_left.
Errors

26 stable error codes

The HTTP status, a JSON body with a stable code and one plain sentence, and a docs_url back to its row below. Pick a status to jump to it.

429Rate limited: the body
{
  "error": {
    "type": "rate_limited",
    "code": "rate_limited",
    "message": "Too many requests. Wait a moment and try again.",
    "param": null,
    "retry_after": 12,
    "upgrade_url": null,
    "docs_url": "https://extwatch.com/developers/docs#error-rate-limited",
    "request_id": "req_…"
  }
}
param names the parameter at fault, retry_after says how many seconds to wait, and upgrade_url points to the plans that include an endpoint.
CodeHTTPTypeMessage
invalid_param400invalid_requestA parameter has a value we cannot use.
unknown_param400invalid_requestThis endpoint does not take that parameter.
missing_param400invalid_requestA required parameter is missing.
key_in_query400invalid_requestDo not put keys in the URL. Send them in the Authorization header.
too_many_ids400invalid_requestToo many ids for one call on your plan.
missing_key401authenticationSend your API key in the Authorization header as Bearer ew_live_…
invalid_key401authenticationThat API key is not valid.
key_revoked401authenticationThat API key was revoked. Make a new one on the Developers page.
mcp_key_used401authenticationThis is an MCP key. Make an API key on the Developers page.
plan_required402plan_requiredThis account has no active API plan.
scope_missing403permissionThis key was made without access to this endpoint.
endpoint_not_in_plan403permissionYour API plan does not include this endpoint.
ip_not_allowed403permissionThis key does not accept calls from this address.
not_live403permissionThe Ext Watch API is not available on this account yet.
not_found404not_foundNothing in Ext Watch matches that.
unknown_endpoint404not_foundThere is no endpoint at this path.
method_not_allowed405invalid_requestEvery endpoint is GET only.
ambiguous_name409ambiguousSeveral listings match that name. Ask again with one of the ids in choices.
rate_limited429rate_limitedToo many requests. Wait a moment and try again.
daily_quota429quota_exceededYou have used today’s credits. They reset at midnight UTC.
monthly_quota429quota_exceededYou have used this period’s credits. Add a credit pack or wait for the renewal.
distinct_cap429quota_exceededYou have reached this period’s limit on distinct extensions. It resets at renewal.
server_error500server_errorSomething went wrong on our side. No credits were used.
upstream503unavailableThe data could not be read just now. Try again in a minute.
maintenance503unavailableThe API is being updated. Try again in a few minutes.
timeout504timeoutThat read took too long. Try a narrower request. No credits were used.
Limits and credits

What each call costs

Limits count per account, across all your keys. At a limit, calls stop with a 429. Nothing is billed on top.

X-Credits-Chargedper callcost = max(base, ceil(rows ÷ 10))
RequestRowsWhyCredits
GET/extensions?…&limit=33A list: 1 credit per 10 rows, at least 11
GET/extensions?…&limit=252525 rows ÷ 10, rounded up3
GET/extensions/{id}1One profile, its base cost2
GET/usage · /meta–Account calls are free0
304Not Modified–Nothing changed since your ETag0
Errors use no credits. Usage, meta and 304 calls still count toward the request limits.

Limits by plan

LimitDeveloperProductionBusiness
Requests a minute2060120
Requests per 10 seconds3815
Credits a day (UTC)1,0005,00020,000
Credits a month10,00060,000250,000
Most rows in one call253030
Distinct extensions a month2,00015,00060,000
History30 days1 yearEverything held
Compare up to355

3 plans. Swipe for Production and Business.

Developer
Requests a minute
20
Requests per 10 seconds
3
Credits a day (UTC)
1,000
Credits a month
10,000
Most rows in one call
25
Distinct extensions a month
2,000
History
30 days
Compare up to
3
Production
Requests a minute
60
Requests per 10 seconds
8
Credits a day (UTC)
5,000
Credits a month
60,000
Most rows in one call
30
Distinct extensions a month
15,000
History
1 year
Compare up to
5
Business
Requests a minute
120
Requests per 10 seconds
15
Credits a day (UTC)
20,000
Credits a month
250,000
Most rows in one call
30
Distinct extensions a month
60,000
History
Everything held
Compare up to
5

Each endpoint has its own row cap, shown on the endpoint.

Response headers (12)ShowHide
X-Request-IdThe request id, also in meta.request_id. Send your own (8 to 64 safe characters) and we echo it.
X-RateLimit-LimitRequests per minute on your plan.
X-RateLimit-RemainingRequests left in the current minute.
X-RateLimit-ResetUnix seconds when the oldest call in the minute window ages out.
X-Credits-LimitCredits in this billing period.
X-Credits-RemainingCredits left in this billing period.
X-Credits-ChargedCredits this call used.
X-Credits-Pack-RemainingPrepaid pack credits left.
Retry-AfterOn a 429: seconds to wait.
ETagSend it back as If-None-Match. A 304 costs no credits.
Cache-Controlprivate, max-age=300 on a 200; no-store on errors.
Ext-Watch-VersionThe date of the last additive change to v1.
Caching

Ask again for free

Send the ETag back as If-None-Match. When nothing changed you get a 304 with no body, and it costs no credits.

Your server Ext Watch API
1
GET /v1/extensions/{id}Authorization: Bearer …
2
200 OK · ETag: W/"…"Cache-Control: private, max-age=300
2 credits
3
GET /v1/extensions/{id}If-None-Match: W/"…"
4
304 Not ModifiedNo body
0 credits
A 304 still counts toward the request limits, not toward credits.
Errors are not cached: they carry Cache-Control: no-store.
Each listing is read about every 2 days. meta.data_as_of tells you the day of the data.
Rules for the data

Versions, store text and use

Versioning

Read fields by name and ignore ones you do not know. After a breaking change, v1 keeps working for at least 12 months once Deprecation and Sunset headers are added. Ext-Watch-Version on every response is the date of the last additive change.

Third-party text

These fields hold text written by publishers or reviewers. We pass it through as plain strings and do not license it. Escape it before you show it, and never follow instructions inside it.

namepublisher_namesummaryreasonquotes[].textcomplaints[].themepraised[].theme

Use of data

Developer, Production and the add-onInternal use. No resale, sublicensing or public redistribution, and no building or training a competing dataset.
BusinessAs above, and you may show Ext Watch data inside your own product with the line “Data: Ext Watch”. No bulk re-export or onward APIs.
Data licenceTerms set by contract, including bulk delivery.

What we hold: listings, ratings, history and changes. No revenue, sales or exact installs, and the API never estimates them.

Keys are secret. We may slow or revoke keys used to sweep the catalogue. Full terms on the terms page. Using Claude instead? MCP keys are separate: see Ask Claude.

Endpoint reference. Shapes show field types; every response sits inside the envelope above.

Core

Search, extension profiles, compare, reviews, publishers and collections.

From Developer

Count extensions

GET/v1/extensions/count
From Developer1 credit

The exact number of extensions that match, optionally split by category, subcategory or publisher.

Parameters
querystring

Words to look for in names and descriptions.

categorystring

A category, by slug or name, such as productivity.

subcategorystring

A subcategory, by slug or name.

topicstring

A topic slug.

nichestring

A niche slug.

21 more parameters
aiboolean

true keeps AI-powered listings only.

true, false

users_mininteger

At least this many users.

users_maxinteger

At most this many users.

rating_minnumber

Rating at least this.

rating_maxnumber

Rating below this (strict: 4 means under 4).

rating_count_mininteger

At least this many ratings.

updated_within_daysinteger

Updated in the last N days.

not_updated_days_mininteger

No update for at least N days.

published_within_daysinteger

First published in the last N days. Needs the market group.

published_fromdate

First published on or after this day. Needs the market group.

YYYY-MM-DD

published_todate

First published on or before this day. Needs the market group.

YYYY-MM-DD

paidboolean

true keeps listings with payment signs. Needs the intel group.

true, false

featuredboolean

true keeps listings the store marks as Featured.

true, false

makerone of

Indie developer or company.

indie, company

riskone of

Permissions risk level.

low, medium, high

publisher_sizeone of

How many listings the publisher has: 1, 2 to 5, or 6 or more.

solo, 2_5, 6_plus

publisherstring

A publisher name.

has_websiteboolean

true keeps listings that link a website.

true, false

languageone of

en keeps English listings.

en

name_containsstring

Text the listing name must contain.

group_byone of

Splits the matching set into groups.

category, subcategory, publisher

GET /v1/extensions/count
curl -G "https://app.extwatch.com/api/v1/extensions/count" \
  -d "category=productivity" \
  -d "ai=true" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · groups
{
  "unit": string, "signed": boolean,
  "rows": [{ "key", "label", "value": number, "value_text", "sub", "app_url" }],
  "stats": [{ "label", "value", "value_text" }],
  "top": [Extension]
}

Get an extension

GET/v1/extensions/{id}
From Developer2 credits

One profile: users, rating, last update, users gained over 7, 30 and 90 days, releases and permissions risk.

Parameters
idstringpathRequired

The 32-letter store id of the extension.

fieldslist

Only these fields in each row, comma-separated. Same credits.

detailone of

brief returns less text per row. Same credits.

brief

Third-party textnamepublisher_namesummary
GET /v1/extensions/{id}
curl "https://app.extwatch.com/api/v1/extensions/efaidnbmnnnibpcajpcglclefindmkaj" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
200 OKExample response
{
  "object": "extension",
  "endpoint": "extensions.get",
  "data": {
    "id": "efaidnbmnnnibpcajpcglclefindmkaj",
    "name": "Adobe Acrobat: PDF edit, convert, sign tools",
    "publisher_name": "Adobe, Inc.",
    "publisher_app_url": "https://app.extwatch.com/publishers/…",
    "icon_url": "https://lh3.googleusercontent.com/…",
    "app_url": "https://app.extwatch.com/extensions/…",
    "rank": 1,
    "category": "Workflow & Planning",
    "subcategory": null,
    "users": 350000000,
    "users_text": "≈350M",
    "rating": 4.37,
    "rating_count": 64790,
    "updated_on": "2026-11-06"
  },
  "meta": {
    "request_id": "req_…",
    "data_as_of": "2026-11-18",
    "credits_charged": 1
  }
}
Values from today’s data, as of 2026-11-18. Trimmed.

Look up by name

GET/v1/extensions/lookup
From Developer2 credits

The same profile, found by listing name. Several matches answer 409 with the choices.

Parameters
namestringRequired

The listing name (2 to 80 characters).

fieldslist

Only these fields in each row, comma-separated. Same credits.

detailone of

brief returns less text per row. Same credits.

brief

Third-party textnamepublisher_namesummary
GET /v1/extensions/lookup
curl -G "https://app.extwatch.com/api/v1/extensions/lookup" \
  -d "name=Grammarly" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · extension
{
  "id": string, "name": string, "publisher_name": string | null,
  "icon_url": string | null, "app_url": string,
  "category": string | null, "subcategory": string | null,
  "users": number | null, "users_text": string | null,
  "rating": number | null, "rating_count": number | null,
  "updated_on": YYYY-MM-DD | null
}

Compare extensions

GET/v1/compare
From Developer2 credits

Two to five extensions side by side, with a dated series for the chart.

Parameters
idslist

Store ids, comma-separated (up to 5).

up to 5

nameslist

Listing names, comma-separated.

daysinteger

Days covered by the chart (default 90).

7 to 365

chartone of

What the chart shows.

users, rating, rating_count, none

Third-party textitems[].nameitems[].publisher_name
GET /v1/compare
curl -G "https://app.extwatch.com/api/v1/compare" \
  -d "ids=efaidnbmnnnibpcajpcglclefindmkaj,lmjegmlicamnimmfhcmpkclmigmmcbeh" \
  -d "days=90" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · comparison
{
  "items": [Extension],
  "metrics": [{ "key", "label", "values": [number | null], "best", "higher_better" }],
  "series": [{ "id", "name", "points": [{ "date", "users", "rating", "rating_count" }] }],
  "metric": "users", "days": 90, "not_found": []
}

Extension reviews

GET/v1/extensions/{id}/reviews
From Developer1 creditUp to 5 rows

Star split, low-star share by period, common complaints and praise, and recent quotes.

Parameters
idstringpathRequired

The 32-letter store id of the extension.

ratinginteger

Reviews with exactly these stars.

1 to 5

stars_maxinteger

Reviews with at most these stars.

1 to 5

since_daysinteger

Reviews from the last N days.

1 to 1095

keywordstring

Reviews that contain this word.

2 more parameters
sortone of

Newest or most helpful first.

newest, helpful

limitinteger

How many quotes to return.

1 to 8

Third-party textquotes[].textcomplaints[].themepraised[].theme
GET /v1/extensions/{id}/reviews
curl "https://app.extwatch.com/api/v1/extensions/efaidnbmnnnibpcajpcglclefindmkaj/reviews" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · reviews
{
  "items": [{
    "extension": { "id", "name", "rating", "rating_count" },
    "stars": { "5": number, "4": number, "3": number, "2": number, "1": number },
    "low_share": { "pct", "low", "of" },
    "complaints": [{ "theme", "count" }], "praised": [{ "theme", "count" }],
    "quotes": [{ "stars", "date", "text", "helpful_votes" }]
  }],
  "not_found": []
}

Reviews for several extensions

GET/v1/reviews
From Developer1 creditUp to 5 rows

The same review summary for up to five extensions in one call.

Parameters
idslistRequired

Store ids, comma-separated (up to 5).

up to 5

stars_maxinteger

Reviews with at most these stars.

1 to 5

since_daysinteger

Reviews from the last N days.

1 to 1095

limitinteger

How many quotes to return.

1 to 8

Third-party textquotes[].textcomplaints[].themepraised[].theme
GET /v1/reviews
curl -G "https://app.extwatch.com/api/v1/reviews" \
  -d "ids=efaidnbmnnnibpcajpcglclefindmkaj,lmjegmlicamnimmfhcmpkclmigmmcbeh" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · reviews
{
  "items": [{
    "extension": { "id", "name", "rating", "rating_count" },
    "stars": { "5": number, "4": number, "3": number, "2": number, "1": number },
    "low_share": { "pct", "low", "of" },
    "complaints": [{ "theme", "count" }], "praised": [{ "theme", "count" }],
    "quotes": [{ "stars", "date", "text", "helpful_votes" }]
  }],
  "not_found": []
}

Get a publisher

GET/v1/publishers/{publisher}
From Developer1 credit, or 1 per 10 rows when moreUp to 25 rows

A publisher's listings with users and ratings, plus portfolio totals.

Parameters
publisherstringpathRequired

A publisher id, or a URL-encoded name with by=name.

byone of

id (default) or name: how to read the path value.

id, name

limitinteger

How many rows to return.

1 to 25

Third-party textpublisher.nameextensions[].name
GET /v1/publishers/{publisher}
curl "https://app.extwatch.com/api/v1/publishers/u4aa1399b20671957d839ff11569693bf" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · publisher
{
  "publisher": { "name": string, "app_url": string },
  "stats": [{ "label", "value", "value_text" }],
  "extensions": [Extension]
}

Rank publishers

GET/v1/publishers
From Developer1 credit, or 1 per 10 rows when moreUp to 25 rows

Publishers ranked by number of listings or by total users.

Parameters
rank_byone ofRequired

Ranks publishers instead of reading one.

extensions, users

extensions_mininteger

Publishers with at least this many listings.

extensions_maxinteger

Publishers with at most this many listings.

users_mininteger

At least this many users.

makerone of

Indie developer or company.

indie, company

1 more parameters
limitinteger

How many rows to return.

1 to 25

GET /v1/publishers
curl -G "https://app.extwatch.com/api/v1/publishers" \
  -d "rank_by=users" \
  -d "limit=10" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · groups
{
  "unit": string, "signed": boolean,
  "rows": [{ "key", "label", "value": number, "value_text", "sub", "app_url" }],
  "stats": [{ "label", "value", "value_text" }],
  "top": [Extension]
}

List collections

GET/v1/collections
From Developer1 credit

Every hand-picked collection, with its size.

Parameters

None. Call it as it is.

GET /v1/collections
curl "https://app.extwatch.com/api/v1/collections" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · groups
{
  "unit": string, "signed": boolean,
  "rows": [{ "key", "label", "value": number, "value_text", "sub", "app_url" }],
  "stats": [{ "label", "value", "value_text" }],
  "top": [Extension]
}

Get a collection

GET/v1/collections/{slug}
From Developer1 credit, or 1 per 10 rows when moreUp to 25 rows

The listings in one collection, with the reason each one is in it.

Parameters
slugstringpathRequired

A slug or name.

limitinteger

How many rows to return.

1 to 25

Third-party textnamepublisher_namereason
GET /v1/collections/{slug}
curl "https://app.extwatch.com/api/v1/collections/quiet-leaders-100k" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · list
[{
  ...Extension,
  "rank": number | null,
  "reason"?: string | null,
  "score"?: number | null,
  "similarity"?: number | null,
  "users_gained"?: number | null,
  "published_on"?: YYYY-MM-DD | null,
  "paid"?: string | null
}, …]
// Optional fields come only from the endpoints that use them.

History

Dated history series and the change feed.

From Production

Extension history

GET/v1/extensions/{id}/history
From Production1 credit

Dated users, rating and number of ratings, with the start, end, low, high and signed change.

Parameters
idstringpathRequired

The 32-letter store id of the extension.

daysinteger

Days of history. Your plan sets the most.

7 or more

metricone of

Which number to chart (default users).

users, rating, rating_count

Third-party textseries[].name
GET /v1/extensions/{id}/history
curl "https://app.extwatch.com/api/v1/extensions/efaidnbmnnnibpcajpcglclefindmkaj/history" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · history
{
  "metric": "users | rating | rating_count",
  "window": { "from": YYYY-MM-DD, "to": YYYY-MM-DD, "days": number },
  "series": [{ "id", "name", "points": [{ "date", "users", "rating", "rating_count" }] }],
  "summary": [{ "series_id", "start", "end", "change", "low", "low_on", "high", "high_on" }],
  "not_found": []
}

History for several extensions

GET/v1/history
From Production1 credit

The same dated series for up to five extensions in one call.

Parameters
idslistRequired

Store ids, comma-separated (up to 5).

up to 5

daysinteger

Days of history. Your plan sets the most.

7 or more

metricone of

Which number to chart (default users).

users, rating, rating_count

Third-party textseries[].name
GET /v1/history
curl -G "https://app.extwatch.com/api/v1/history" \
  -d "ids=efaidnbmnnnibpcajpcglclefindmkaj,lmjegmlicamnimmfhcmpkclmigmmcbeh" \
  -d "days=90" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · history
{
  "metric": "users | rating | rating_count",
  "window": { "from": YYYY-MM-DD, "to": YYYY-MM-DD, "days": number },
  "series": [{ "id", "name", "points": [{ "date", "users", "rating", "rating_count" }] }],
  "summary": [{ "series_id", "start", "end", "change", "low", "low_on", "high", "high_on" }],
  "not_found": []
}

Extension changes

GET/v1/extensions/{id}/changes
From Production1 credit, or 1 per 10 rows when moreUp to 30 rows

Every recorded change to a listing: version, permissions, ownership, rating, users, text, screenshots and more.

Parameters
idstringpathRequired

The 32-letter store id of the extension.

daysinteger

Days back (default 30).

1 to 365

kindslist

Kinds of change to keep.

version, permissions, ownership, rating, status, users, listing_text, screenshots, icon, featured

limitinteger

How many rows to return.

1 to 30

Third-party textextension_nametext
GET /v1/extensions/{id}/changes
curl "https://app.extwatch.com/api/v1/extensions/efaidnbmnnnibpcajpcglclefindmkaj/changes" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · changes
{
  "tracked_since": { "version": YYYY-MM-DD, "permissions": YYYY-MM-DD, … },
  "items": [{
    "id", "extension_id", "extension_name",
    "kind": "version | permissions | ownership | rating | status | users | listing_text | screenshots | icon | featured",
    "at", "observed_on",
    "version"?, "permissions_added"?, "permissions_removed"?, "from"?, "to"?, "text"?
  }]
}

Changes for several extensions

GET/v1/changes
From Production1 credit, or 1 per 10 rows when moreUp to 30 rows

The change feed for up to five extensions in one call.

Parameters
idslistRequired

Store ids, comma-separated (up to 5).

up to 5

daysinteger

Days back (default 30).

1 to 365

kindslist

Kinds of change to keep.

version, permissions, ownership, rating, status, users, listing_text, screenshots, icon, featured

limitinteger

How many rows to return.

1 to 30

Third-party textextension_nametext
GET /v1/changes
curl -G "https://app.extwatch.com/api/v1/changes" \
  -d "ids=efaidnbmnnnibpcajpcglclefindmkaj,lmjegmlicamnimmfhcmpkclmigmmcbeh" \
  -d "kinds=version,permissions" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · changes
{
  "tracked_since": { "version": YYYY-MM-DD, "permissions": YYYY-MM-DD, … },
  "items": [{
    "id", "extension_id", "extension_name",
    "kind": "version | permissions | ownership | rating | status | users | listing_text | screenshots | icon | featured",
    "at", "observed_on",
    "version"?, "permissions_added"?, "permissions_removed"?, "from"?, "to"?, "text"?
  }]
}

Market

Launches, risers, competitors and category stats.

From Production

New launches

GET/v1/launches
From Production1 credit, or 1 per 10 rows when moreUp to 25 rows

Extensions first published in a window, with the exact total.

Parameters
windowone of

Gains over 30 or 90 days.

today, yesterday, last_7_days, last_30_days, last_90_days, this_week, last_week, this_month, last_month

daysinteger

How many days back to look.

fromdate

First publish day (default 90 days ago).

YYYY-MM-DD

todate

Last publish day (default today).

YYYY-MM-DD

categorystring

A category, by slug or name, such as productivity.

12 more parameters
subcategorystring

A subcategory, by slug or name.

topicstring

A topic slug.

aiboolean

true keeps AI-powered listings only.

true, false

users_mininteger

At least this many users.

users_maxinteger

At most this many users.

rating_minnumber

Rating at least this.

languageone of

en keeps English listings.

en

makerone of

Indie developer or company.

indie, company

paidboolean

true keeps listings with payment signs.

true, false

featuredboolean

true keeps listings the store marks as Featured.

true, false

sortone of

Order of the rows.

users, newest, users_per_day, ratings_gained_30d

limitinteger

How many rows to return.

1 to 25

Third-party textnamepublisher_namereason
GET /v1/launches
curl -G "https://app.extwatch.com/api/v1/launches" \
  -d "window=last_30_days" \
  -d "users_min=1000" \
  -d "sort=users" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · list
[{
  ...Extension,
  "rank": number | null,
  "reason"?: string | null,
  "score"?: number | null,
  "similarity"?: number | null,
  "users_gained"?: number | null,
  "published_on"?: YYYY-MM-DD | null,
  "paid"?: string | null
}, …]
// Optional fields come only from the endpoints that use them.

Launches per month

GET/v1/launches/monthly
From Production2 credits

How many extensions were first published each month, with yearly totals.

Parameters
monthsinteger

Calendar months, ending with the current one (default 24).

1 to 36

categorystring

A category, by slug or name, such as productivity.

subcategorystring

A subcategory, by slug or name.

topicstring

A topic slug.

aiboolean

true keeps AI-powered listings only.

true, false

4 more parameters
languageone of

en keeps English listings.

en

users_mininteger

At least this many users.

rating_minnumber

Rating at least this.

makerone of

Indie developer or company.

indie, company

GET /v1/launches/monthly
curl -G "https://app.extwatch.com/api/v1/launches/monthly" \
  -d "category=productivity" \
  -d "months=12" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · launches_monthly
{
  "months": [{ "month": YYYY-MM, "count": number | null, "partial": boolean, "app_url" }],
  "years": [{ "year", "total", "months_counted", "partial" }]
}

Top risers

GET/v1/risers
From Production2 credits, or 1 per 10 rows when moreUp to 15 rows

Extensions gaining the most users or ratings over 30 or 90 days.

Parameters
basisone of

Rank by users gained or by ratings gained.

users, ratings

windowone of

Gains over 30 or 90 days.

d30, d90

categorystring

A category, by slug or name, such as productivity.

categorieslist

Several categories at once.

subcategorystring

A subcategory, by slug or name.

12 more parameters
topicstring

A topic slug.

users_mininteger

At least this many users.

users_maxinteger

At most this many users.

min_gaininteger

Smallest gain to include.

makerone of

Indie developer or company.

indie, company

aiboolean

true keeps AI-powered listings only.

true, false

languageone of

en keeps English listings.

en

rating_minnumber

Rating at least this.

rating_maxnumber

Rating below this (strict: 4 means under 4).

rating_count_mininteger

At least this many ratings.

publisher_sizeone of

How many listings the publisher has: 1, 2 to 5, or 6 or more.

solo, 2_5, 6_plus

limitinteger

How many rows to return (at most 15).

1 to 15

Third-party textnamepublisher_namereason
GET /v1/risers
curl -G "https://app.extwatch.com/api/v1/risers" \
  -d "window=d30" \
  -d "category=productivity" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · list
[{
  ...Extension,
  "rank": number | null,
  "reason"?: string | null,
  "score"?: number | null,
  "similarity"?: number | null,
  "users_gained"?: number | null,
  "published_on"?: YYYY-MM-DD | null,
  "paid"?: string | null
}, …]
// Optional fields come only from the endpoints that use them.

Similar

GET/v1/extensions/{id}/competitors
From Production1 creditUp to 10 rows

The listings most like one extension, with users, rating and how close each one is.

Parameters
idstringpathRequired

The 32-letter store id of the extension.

languageone of

en keeps English listings.

en

limitinteger

How many rows to return.

1 to 10

Third-party textnamepublisher_namereason
GET /v1/extensions/{id}/competitors
curl "https://app.extwatch.com/api/v1/extensions/efaidnbmnnnibpcajpcglclefindmkaj/competitors" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · list
[{
  ...Extension,
  "rank": number | null,
  "reason"?: string | null,
  "score"?: number | null,
  "similarity"?: number | null,
  "users_gained"?: number | null,
  "published_on"?: YYYY-MM-DD | null,
  "paid"?: string | null
}, …]
// Optional fields come only from the endpoints that use them.

Market stats by group

GET/v1/categories
From Production2 credits

Every category, subcategory or topic side by side: listings, users, or net user change.

Parameters
dimensionone of

Lists every group of this kind side by side.

category, subcategory, topic

parentstring

Keeps the groups inside this category.

metricone of

listings for the market numbers, growth for the net user change per group.

listings, growth

languageone of

en keeps English listings.

en

GET /v1/categories
curl "https://app.extwatch.com/api/v1/categories" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
200 OKExample response
{
  "object": "groups",
  "endpoint": "categories.list",
  "data": {
    "unit": "listings",
    "signed": false,
    "rows": [
      {
        "key": "tools",
        "label": "Tools",
        "value": 117884,
        "value_text": "117,884",
        "sub": "426M users",
        "app_url": "https://app.extwatch.com/explore/…"
      },
      {
        "key": "workflow-and-planning",
        "label": "Workflow & Planning",
        "value": 50583,
        "value_text": "50,583",
        "sub": "1.28B users",
        "app_url": "https://app.extwatch.com/explore/…"
      },
      {
        "key": "developer-tools",
        "label": "Developer Tools",
        "value": 31127,
        "value_text": "31,127",
        "sub": "146M users",
        "app_url": "https://app.extwatch.com/explore/…"
      },
      {
        "key": "education",
        "label": "Education",
        "value": 13194,
        "value_text": "13,194",
        "sub": "131M users",
        "app_url": "https://app.extwatch.com/explore/…"
      }
    ]
  },
  "basis": {
    "set": "Every category",
    "as_of": "2026-11-18",
    "source": "Ext Watch crawl of the Chrome Web Store"
  },
  "meta": {
    "request_id": "req_…",
    "data_as_of": "2026-11-18",
    "credits_charged": 1
  }
}
Values from today’s data, as of 2026-11-18. Trimmed.

Market stats for one group

GET/v1/categories/{slug}
From Production2 credits

One category, subcategory or topic: listings, users, top-10 share, size bands, update recency and leaders.

Parameters
slugstringpathRequired

A slug or name.

metricone of

listings for the market numbers, growth for the net user change per group.

listings, growth

languageone of

en keeps English listings.

en

GET /v1/categories/{slug}
curl "https://app.extwatch.com/api/v1/categories/productivity" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · groups
{
  "unit": string, "signed": boolean,
  "rows": [{ "key", "label", "value": number, "value_text", "sub", "app_url" }],
  "stats": [{ "label", "value", "value_text" }],
  "top": [Extension]
}

Intelligence

Opportunities and payment signs.

From Business

Opportunities

GET/v1/opportunities
From Business2 creditsUp to 10 rows

Gaps worth building, large listings with weak ratings, and popular listings with no recent update.

Parameters
tabone of

worth: gaps worth building. weak: large listings with weak ratings. abandoned: popular listings with no recent update.

worth, weak, abandoned

categorystring

A category, by slug or name, such as productivity.

subcategorystring

A subcategory, by slug or name.

users_mininteger

At least this many users.

sortone of

Order of the rows.

score, users

1 more parameters
limitinteger

How many rows to return.

1 to 10

Third-party textnamepublisher_namereason
GET /v1/opportunities
curl -G "https://app.extwatch.com/api/v1/opportunities" \
  -d "tab=weak" \
  -d "category=productivity" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · list
[{
  ...Extension,
  "rank": number | null,
  "reason"?: string | null,
  "score"?: number | null,
  "similarity"?: number | null,
  "users_gained"?: number | null,
  "published_on"?: YYYY-MM-DD | null,
  "paid"?: string | null
}, …]
// Optional fields come only from the endpoints that use them.

Payment signs

GET/v1/extensions/{id}/monetization
From Business1 credit

Whether an extension charges, from the signs in its listing and pages.

Parameters
idstringpathRequired

The 32-letter store id of the extension.

Third-party textnamepublisher_namereason
GET /v1/extensions/{id}/monetization
curl "https://app.extwatch.com/api/v1/extensions/efaidnbmnnnibpcajpcglclefindmkaj/monetization" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · list
[{
  ...Extension,
  "rank": number | null,
  "reason"?: string | null,
  "score"?: number | null,
  "similarity"?: number | null,
  "users_gained"?: number | null,
  "published_on"?: YYYY-MM-DD | null,
  "paid"?: string | null
}, …]
// Optional fields come only from the endpoints that use them.

Payment signs for several

GET/v1/monetization
From Business1 credit

Payment signs for up to ten extensions in one call.

Parameters
idslist

Store ids, comma-separated (up to 10).

up to 10

nameslist

Listing names, comma-separated.

Third-party textnamepublisher_namereason
GET /v1/monetization
curl -G "https://app.extwatch.com/api/v1/monetization" \
  -d "ids=efaidnbmnnnibpcajpcglclefindmkaj,lmjegmlicamnimmfhcmpkclmigmmcbeh" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · list
[{
  ...Extension,
  "rank": number | null,
  "reason"?: string | null,
  "score"?: number | null,
  "similarity"?: number | null,
  "users_gained"?: number | null,
  "published_on"?: YYYY-MM-DD | null,
  "paid"?: string | null
}, …]
// Optional fields come only from the endpoints that use them.

Account

Your usage and the data date.

Every plan

Usage

GET/v1/usage
Every planFree of credits

Your plan, credits used and left this period, calls, refusals and distinct extensions.

Parameters

None. Call it as it is.

GET /v1/usage
curl "https://app.extwatch.com/api/v1/usage" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · usage
{
  "plan": { "id", "name", "kind", "status", "interval" },
  "period": { "start", "end" },
  "credits": { "limit", "used", "left", "pack_left" },
  "calls": number, "refused": number,
  "distinct_extensions": { "used", "limit" },
  "days": [{ "day", "credits", "calls" }]
}

Meta

GET/v1/meta
Every planFree of credits

The data date, how far back data goes, and what your plan can reach.

Parameters

None. Call it as it is.

GET /v1/meta
curl "https://app.extwatch.com/api/v1/meta" \
  -H "Authorization: Bearer $EXTWATCH_API_KEY"
Shapedata · meta
{
  "data_as_of": YYYY-MM-DD, "plan_id": string,
  "groups": ["core", …], "history_days": number, "rows_call": number,
  "api_version": YYYY-MM-DD
}
Developer API

Ready to make a request?

Pick a plan, make a key, and call any endpoint above.