{"openapi":"3.1.0","info":{"title":"Mozilla Add-ons (Firefox Extensions) API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/mozillaaddons-api","description":"oanor gateway"}],"tags":[{"name":"Addon"},{"name":"Search"},{"name":"Top"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/addon":{"get":{"operationId":"get_v1_addon","tags":["Addon"],"summary":"A single add-on in full","description":"","parameters":[{"name":"slug","in":"query","required":true,"description":"Add-on slug","schema":{"type":"string"},"example":"ublock-origin"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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,"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Search"],"summary":"Search add-ons","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search query","schema":{"type":"string"},"example":"adblock"},{"name":"sort","in":"query","required":false,"description":"users, rating or relevance (default relevance)","schema":{"type":"string"},"example":"users"},{"name":"type","in":"query","required":false,"description":"extension or theme","schema":{"type":"string"},"example":"extension"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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","slug":"adblocker-ultimate","type":"extension","rating":4.77,"rating_count":27143,"weekly_downloads":4975,"average_daily_users":1129570},{"name":"Ghostery – Privacy Ad Blocker","slug":"ghostery","type":"extension","rating":4.42,"rating_count":5582,"weekly_downloads":11748,"average_daily_users":1012449},{"name":"SponsorBlock - Skip Sponsorships on YouTube","slug":"sponsorblock","type":"extension","rating":4.81,"rating_count":3127,"weekly_downloads":11163,"average_daily_users":745467},{"name":"AdBlocker for YouTube™","slug":"adblock-for-youtube","type":"extension","rating":3.85,"rating_count":1370,"weekly_downloads":12902,"average_daily_users":492643},{"name":"PayPal Honey: Automated Coupons & Rewards","slug":"honey","type":"extension","rating":2.86,"rating_count":8160,"weekly_downloads":521,"average_daily_users":323120},{"name":"LeechBlock NG","slug":"leechblock-ng","type":"extension","rating":4.83,"rating_count":1990,"weekly_downloads":1692,"average_daily_users":111409}]},"meta":{"timestamp":"2026-06-12T01:42:19.789Z","request_id":"dc585252-fada-4a84-adcb-d97594e218d4"},"status":"ok","message":"Search retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/top":{"get":{"operationId":"get_v1_top","tags":["Top"],"summary":"Most-used add-ons","description":"","parameters":[{"name":"type","in":"query","required":false,"description":"extension (default) or theme","schema":{"type":"string"},"example":"extension"},{"name":"limit","in":"query","required":false,"description":"Max rows (default 25, max 50)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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":"adguard-adblocker","type":"extension","rating":4.64,"rating_count":6857,"weekly_downloads":29936,"average_daily_users":1698298},{"name":"AdBlock for Firefox","rank":6,"slug":"adblock-for-firefox","type":"extension","rating":4.22,"rating_count":3524,"weekly_downloads":21844,"average_daily_users":1350970},{"name":"Easy Screenshot","rank":7,"slug":"easyscreenshot","type":"extension","rating":3.85,"rating_count":760,"weekly_downloads":1017,"average_daily_users":1331485},{"name":"Dark Reader","rank":8,"slug":"darkreader","type":"extension","rating":4.49,"rating_count":6848,"weekly_downloads":18411,"average_daily_users":1303371},{"name":"AdBlocker Ultimate","rank":9,"slug":"adblocker-ultimate","type":"extension","rating":4.77,"rating_count":27143,"weekly_downloads":4975,"average_daily_users":1129570},{"name":"DuckDuckGo Search & Tracker Protection","rank":10,"slug":"duckduckgo-for-firefox","type":"extension","rating":4.34,"rating_count":2359,"weekly_downloads":3971,"average_daily_users":1125927},{"name":"Ghostery – Privacy Ad Blocker","rank":11,"slug":"ghostery","type":"extension","rating":4.42,"rating_count":5582,"weekly_downloads":11748,"average_daily_users":1012449},{"name":"Bitwarden Password Manager","rank":12,"slug":"bitwarden-password-manager","type":"extension","rating":4.6,"rating_count":9271,"weekly_downloads":20486,"average_daily_users":972656},{"name":"Return YouTube Dislike","rank":13,"slug":"return-youtube-dislikes","type":"extension","rating":4.65,"rating_count":4884,"weekly_downloads":9362,"average_daily_users":915697},{"name":"Facebook Container","rank":14,"slug":"facebook-container","type":"extension","rating":4.45,"rating_count":4114,"weekly_downloads":1301,"average_daily_users":793299},{"name":"Tampermonkey","rank":15,"slug":"tampermonkey","type":"extension","rating":4.7,"rating_count":5275,"weekly_downloads":14408,"average_daily_users":774981},{"name":"SponsorBlock - Skip Sponsorships on YouTube","rank":16,"slug":"sponsorblock","type":"extension","rating":4.81,"rating_count":3127,"weekly_downloads":11163,"average_daily_users":745467},{"name":"To Google Translate","rank":17,"slug":"to-google-translate","type":"extension","rating":4.06,"rating_count":3633,"weekly_downloads":5527,"average_daily_users":671969},{"name":"IDM Integration Module","rank":18,"slug":"tonec-idm-integration-module","type":"extension","rating":4.55,"rating_count":3828,"weekly_downloads":37026,"average_daily_users":572925},{"name":"TWP - Translate Web Pages","rank":19,"slug":"traduzir-paginas-web","type":"extension","rating":4.76,"rating_count":3732,"weekly_downloads":6793,"average_daily_users":566931},{"name":"Grammarly: AI Writing and Grammar Checker App","rank":20,"slug":"grammarly-1","type":"extension","rating":4.09,"rating_count":3205,"weekly_downloads":1894,"average_daily_users":558113},{"name":"ClearURLs","rank":21,"slug":"clearurls","type":"extension","rating":4.28,"rating_count":1082,"weekly_downloads":2501,"average_daily_users":530285},{"name":"Cisco Webex Extension","rank":22,"slug":"cisco-webex-extension","type":"extension","rating":2.89,"rating_count":317,"weekly_downloads":34,"average_daily_users":513076},{"name":"Enhancer for YouTube™","rank":23,"slug":"enhancer-for-youtube","type":"extension","rating":4.66,"rating_count":12312,"weekly_downloads":3395,"average_daily_users":509809},{"name":"Capital One Shopping: Save Now","rank":24,"slug":"wikibuy-for-firefox","type":"extension","rating":4.33,"rating_count":817,"weekly_downloads":322,"average_daily_users":496399},{"name":"AdBlocker for YouTube™","rank":25,"slug":"adblock-for-youtube","type":"extension","rating":3.85,"rating_count":1370,"weekly_downloads":12902,"average_daily_users":492643}],"type":"extension","count":25,"total":88497,"source":"Mozilla Add-ons"},"meta":{"timestamp":"2026-06-12T01:42:20.411Z","request_id":"12b3d778-795e-47dc-a253-74061a550c5c"},"status":"ok","message":"Top retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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","request_id":"4ed690a5-004a-4976-97fb-b870f6a41992"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":24000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":480,"monthly_call_quota":320000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1440,"monthly_call_quota":1350000,"rps_limit":25,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":3320,"monthly_call_quota":4800000,"rps_limit":55,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/mozillaaddons-api"}