The generic AMO API

URL Format

API calls are served by accessing https://services.addons.mozilla.org/api/.

You may localize the returned content by adding a locale string to this URL as follows:

http://services.addons.mozilla.org/[locale]/api

For example:

https://services.addons.mozilla.org/en-US/api
https://services.addons.mozilla.org/de/api

Note: The API of ja locale has been served from addons.mozilla.jp. It's not intended for general use and doesn't support all methods described below.

The API is versioned. For all calls, the first parameter is the API version. This is optional, and if it's not supplied, the version defaults to 0. This is maintained for compatibility with older versions of Firefox, but may give you some unexpected behavior, so be sure to specify the current API version. The current API version is 1.5.

All API calls only return public add-ons at present.

Available Methods

addon

Returns details of a particular add-on.

Prototype

https://services.addons.mozilla.org/api/[version]/addon/[id]

Parameters

id
The id of the desired add-on, as per AMO.

Example

Requesting https://services.addons.mozilla.org/en-US/firefox/api/1.5/addon/1865 returns the information for addon 1865, Adblock Plus.

See the output from this request.

Returns add-ons that match a specified search term. This uses the same search engine as the rest of the site, so only exact matches are supported. The returned searchresults element has up to 10 addon elements describing each individual search result.

Prototype

https://services.addons.mozilla.org/api/[version]/search/[searchterm]/[optional:searchtype]/[optional:maxresults]/[optional:search_os /[optional:search_version]

Parameters

searchterm
The term to match.
searchtype
The type of results to return. The default, all, requests that only matching extensions and themes be considered. You may also specify extension, theme, plugin, dictionary, or searchengine.
maxresults
The maximum number of results to return. This is pegged to no more than 30; specifying a larger number will still return no more than 30 results. The total number of available results will be returned in the total_results attribute of the searchresults element. For example:
<searchresults total_results="196">
search_os
Specifies the operating system for which to return results; only add-ons compatible with the specified operating system will be returned. The default value is all; other possible values are winnt, darwin, and linux.
search_version
Specifies the application version with which the returned add-ons must be compatible.

Examples

https://services.addons.mozilla.org/en-US/firefox/api/1.5/search/popup

Searches for add-ons matching "popup". See the output from this request.

https://services.addons.mozilla.org/en-US/firefox/api/1.5/search/nasa/theme

Searches for themes matching "nasa". See the output from this request.

https://services.addons.mozilla.org/en-US/firefox/api/1.5/search/blue/all/10/WINNT/3

Searches for add-ons of any type that match "blue", returning no more than 10 results. Only add-ons that are compatible with the Windows version of Firefox 3 are considered.

See the output from this request.

list

Returns a randomly ordered and selected list of add-ons.

Prototype

https://services.addons.mozilla.org/api/[version]/list/[optional:listtype]/[optional:addontype]/[optional:number]/[optional:list_os]/[optional:list_version]

Parameters

listtype
The type of list to return. The default is recommended; the only other possible value is new. Recommended add-ons are those recommended by AMO editors, while new add-ons are those posted in the last ten days.
addontype
The types of add-on to return. The default value is all, but you may specify extension, theme, plugin, directory, or searchengine.
number
The maximum number of results to return; the default value is 3. This value is capped at 10; if you specify a higher value than 10, no more than ten results are returned.
list_os
The operating system for which compatible add-ons should be returned. By default, this is all. You may also specify winnt, darwin, or linux.
list_version
The application version with which the returned add-ons must be compatible.

Example

https://services.addons.mozilla.org/en-US/firefox/api/1.5/list/new/

Returns a list of new add-ons. See the output from this request.

cumulative_downloads

This API call is currently disabled.

update_pings

This API call is currently disabled.

Document Tags and Contributors

Contributors to this page: Sheppy, terrorbox, bibhas, evold, darktrojan, Clouserw, Kohei, laurathomson
Last updated by: Sheppy,