Mozilla Firefox Add-ons Scraper

Scrape the Mozilla Firefox Add-ons (AMO) directory using the official public API. Search thousands of extensions, themes, language packs, and dictionaries — or fetch specific add-ons by slug. No authentication required.

What does it do?

This actor extracts full metadata for Firefox add-ons from addons.mozilla.org, including:

• Add-on name, type, summary, and description
• Ratings (average, count, text reviews)
• Weekly download numbers
• Current version info (version number, license, release notes, file size)
• Author details (name, profile URL)
• Screenshots and icon URLs
• Category classifications
• Recommendation status
• Homepage and support URLs
• Creation and last-updated timestamps

Output example

{
  "guid": "{d10d0bf8-f5b5-c8b4-a8b2-2b9879e08c5d}",
  "slug": "ublock-origin",
  "addonId": 607454,
  "name": "uBlock Origin",
  "summary": "Finally, an efficient wide-spectrum content blocker.",
  "addonType": "extension",
  "status": "public",
  "categories": ["privacy-security"],
  "authors": [
    {
      "name": "Raymond Hill",
      "url": "https://addons.mozilla.org/en-US/firefox/user/11423598/",
      "username": "gorhill"
    }
  ],
  "ratingsAverage": 4.8,
  "ratingsCount": 18000,
  "ratingsTextCount": 3000,
  "weeklyDownloads": 10654198,
  "isRecommended": true,
  "promoted": ["recommended"],
  "currentVersion": {
    "version": "1.71.0",
    "releaseNotes": "Bug fixes and performance improvements.",
    "license": {
      "name": "GNU General Public License v3.0 only",
      "slug": "GPL-3.0-only",
      "url": "https://spdx.org/licenses/GPL-3.0-only.html"
    },
    "file": {
      "url": "https://addons.mozilla.org/firefox/downloads/file/4814095/ublock_origin-1.71.0.xpi",
      "size": 4504632
    }
  },
  "iconUrl": "https://addons.cdn.mozilla.net/user-media/addon_icons/607/607454-128.png",
  "screenshots": [
    {
      "url": "https://addons.cdn.mozilla.net/user-media/previews/full/123/screenshot.png",
      "caption": "Main interface"
    }
  ],
  "reviewUrl": "https://addons.mozilla.org/en-US/firefox/addon/ublock-origin/reviews/",
  "homepage": "https://github.com/gorhill/uBlock",
  "sourceUrl": "https://addons.mozilla.org/en-US/firefox/addon/ublock-origin/",
  "createdAt": "2015-04-25T07:26:22Z",
  "updatedAt": "2026-05-20T12:37:51Z",
  "recordType": "addon",
  "scrapedAt": "2026-05-30T12:00:00+00:00"
}

Input

Field	Type	Required	Description
mode	select	Yes	search — search the directory; getBySlug — fetch by slug/GUID
query	text	No	Search query (mode=search). Example: "ublock", "dark theme"
addonType	select	No	Filter by type: extension, statictheme, theme, language, dict
category	text	No	Category slug. Examples: privacy-security, bookmarks, tabs, web-development
sort	select	No	Sort: recommended, relevance, rating, users, created, updated, name, trending
slugs	list	No	Slugs or GUIDs for getBySlug mode. Example: ["ublock-origin", "dark-reader"]
maxItems	integer	No	Max records to return (1–10000, default 100)

Modes

Search mode

Search the Firefox add-ons directory. Supports text search, type filtering, category filtering, and sort order.

{
  "mode": "search",
  "query": "password manager",
  "addonType": "extension",
  "sort": "users",
  "maxItems": 50
}

Fetch by slug (getBySlug mode)

Fetch specific add-ons by their AMO slug or GUID.

{
  "mode": "getBySlug",
  "slugs": ["ublock-origin", "dark-reader", "bitwarden-password-manager"]
}

Use cases

• Browser extension research — compile competitive analysis of popular Firefox extensions
• Security auditing — find privacy and security tools in the Firefox ecosystem
• Developer monitoring — track your add-on's ratings, downloads, and review count over time
• Content moderation research — analyze categories and types of browser extensions
• Market research — understand which add-ons users download most in specific categories

FAQ

Does this require API keys or authentication? No. The Mozilla AMO API is fully public. No API key, login, or proxy needed.

How many add-ons can I scrape? AMO has thousands of add-ons. Set maxItems up to 10,000. Search results are paginated automatically.

What add-on types are available? Extensions (extension), Static Themes (statictheme), Legacy Themes (theme), Language Packs (language), and Dictionaries (dict).

What categories can I filter by? Common categories include: alerts-updates, bookmarks, download-management, feeds-news-blogging, games-entertainment, language-support, photos-music-videos, privacy-security, search-tools, shopping, social-communication, tabs, web-development, other.

Is the data real-time? Yes, data is fetched live from addons.mozilla.org when you run the actor.

Can I fetch a specific add-on? Yes — use getBySlug mode with the add-on's slug (e.g., ublock-origin) or GUID (e.g., {d10d0bf8-f5b5-c8b4-a8b2-2b9879e08c5d}).