# Mozilla Add-ons (Firefox Extensions) API > Live Firefox add-on stats from the official Mozilla Add-ons (AMO) API — no key, nothing stored. The adoption-and-reputation view of the Firefox ecosystem: how many users an extension or theme has, how it is rated and reviewed, and which add-ons are most popular, distinct from the other developer-ecosystem and package APIs in the catalogue. The addon endpoint returns a single add-on in full — its average daily users, weekly downloads, the star rating with review count, authors, version, type and categories. The search endpoint searches add-ons sortable by users, rating or relevance, each with its user count and rating. The top endpoint returns the most-used add-ons, optionally filtered to extensions or themes. Build extension-popularity dashboards, "is this add-on still maintained and trusted" widgets, competitor trackers and developer-portfolio tools on top of real Mozilla Add-ons data. Look up an add-on by its slug (ublock-origin, darkreader); average daily users is the headline popularity metric and the rating is the community reputation. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/mozillaaddons-api/..." ``` ## Pricing - **Free** (Free) — 24,000 calls/Mo, 3 req/s - **Starter** ($5/Mo) — 320,000 calls/Mo, 10 req/s - **Pro** ($14/Mo) — 1,350,000 calls/Mo, 25 req/s - **Scale** ($33/Mo) — 4,800,000 calls/Mo, 55 req/s ## Endpoints ### Addon #### `GET /v1/addon` — A single add-on in full **Parameters:** - `slug` (query, required, string) — Add-on slug Example: `ublock-origin` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/mozillaaddons-api/v1/addon?slug=ublock-origin" ``` **Response:** ```json { "data": { "url": "https://addons.mozilla.org/en-US/firefox/addon/ublock-origin/", "name": "uBlock Origin", "slug": "ublock-origin", "type": "extension", "rating": 4.8, "source": "Mozilla Add-ons", "authors": [ "Raymond Hill" ], "summary": "Finally, an efficient wide-spectrum content blocker. Easy on CPU and memory.", "version": "1.71.0", "categories": [ "privacy-security" ], "last_updated": "2026-06-11T15:01:16Z", "rating_count": 21816, "is_recommended": true, "weekly_downloads": 156163, "review_text_count": 5742, "star_distribution": null, "average_daily_users": 10691335 }, "meta": { "timestamp": "2026-06-12T01:42:19.123Z", "request_id": "a1560afc-ea7c-419b-aaac-555b479f6172" }, "status": "ok", "message": "Add-on retrieved successfully", "success": true } ``` ### Search #### `GET /v1/search` — Search add-ons **Parameters:** - `q` (query, required, string) — Search query Example: `adblock` - `sort` (query, optional, string) — users, rating or relevance (default relevance) Example: `users` - `type` (query, optional, string) — extension or theme Example: `extension` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/mozillaaddons-api/v1/search?q=adblock&sort=users&type=extension" ``` **Response:** ```json { "data": { "sort": "users", "count": 10, "query": "adblock", "total": 1841, "source": "Mozilla Add-ons", "results": [ { "name": "uBlock Origin", "slug": "ublock-origin", "type": "extension", "rating": 4.8, "rating_count": 21816, "weekly_downloads": 156163, "average_daily_users": 10691335 }, { "name": "Adblock Plus", "slug": "adblock-plus", "type": "extension", "rating": 4.38, "rating_count": 11385, "weekly_downloads": 27811, "average_daily_users": 2949614 }, { "name": "AdGuard AdBlocker", "slug": "adguard-adblocker", "type": "extension", "rating": 4.64, "rating_count": 6857, "weekly_downloads": 29936, "average_daily_users": 1698298 }, { "name": "AdBlock for Firefox", "slug": "adblock-for-firefox", "type": "extension", "rating": 4.22, "rating_count": 3524, "weekly_downloads": 21844, "average_daily_users": 1350970 }, { "name": "AdBlocker Ultimate", …(truncated, see openapi.json for full schema) ``` ### Top #### `GET /v1/top` — Most-used add-ons **Parameters:** - `type` (query, optional, string) — extension (default) or theme Example: `extension` - `limit` (query, optional, string) — Max rows (default 25, max 50) Example: `25` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/mozillaaddons-api/v1/top?type=extension&limit=25" ``` **Response:** ```json { "data": { "top": [ { "name": "uBlock Origin", "rank": 1, "slug": "ublock-origin", "type": "extension", "rating": 4.8, "rating_count": 21816, "weekly_downloads": 156163, "average_daily_users": 10691335 }, { "name": "Adblock Plus", "rank": 2, "slug": "adblock-plus", "type": "extension", "rating": 4.38, "rating_count": 11385, "weekly_downloads": 27811, "average_daily_users": 2949614 }, { "name": "Privacy Badger", "rank": 3, "slug": "privacy-badger17", "type": "extension", "rating": 4.81, "rating_count": 3081, "weekly_downloads": 14465, "average_daily_users": 1857373 }, { "name": "Video DownloadHelper", "rank": 4, "slug": "video-downloadhelper", "type": "extension", "rating": 4.3, "rating_count": 41834, "weekly_downloads": 36902, "average_daily_users": 1814497 }, { "name": "AdGuard AdBlocker", "rank": 5, "slug" …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/mozillaaddons-api/v1/meta" ``` **Response:** ```json { "data": { "note": "Look up an add-on by its slug (slug=ublock-origin, dark-reader). search accepts sort=users|rating|relevance and type=extension|theme. top defaults to extensions. Average daily users is the headline popularity metric.", "source": "Mozilla Add-ons public API (addons.mozilla.org/api/v5, live)", "service": "mozillaaddons-api", "endpoints": { "GET /v1/top": "Most-used add-ons (type=extension|theme, limit=25).", "GET /v1/meta": "This document.", "GET /v1/addon": "A single add-on in full — users, downloads, rating, star distribution (slug=ublock-origin).", "GET /v1/search": "Search add-ons (q=adblock, sort=users|rating|relevance, type=extension|theme)." }, "description": "Live Firefox add-on (extension & theme) stats from the official Mozilla Add-ons (AMO) API. The adoption-and-reputation view of the Firefox ecosystem. addon = a single add-on in full (average daily users, weekly downloads, star rating with review count and the 1-5 star distribution, authors, version, type, categories); search = search add-ons sortable by users, rating or relevance; top = the most-used add-ons, optionally filtered to extensions or themes. Live, no key, nothing stored. Distinct from the other developer-ecosystem and package APIs.", "upstream_status": "ok", "ublock_origin_daily_users": 10691335 }, "meta": { "timestamp": "2026-06-12T01:42:20.523Z", …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/mozillaaddons-api OpenAPI spec: https://www.oanor.com/api/mozillaaddons-api/openapi.json