Update:Remora API Docs: Difference between revisions
No edit summary |
No edit summary |
||
| Line 14: | Line 14: | ||
API calls are served via | API calls are served via | ||
https://services.addons.mozilla.org/api | |||
You may localize the returned content by adding a locale string to this URL as follows: | You may localize the returned content by adding a locale string to this URL as follows: | ||
https://services.addons.mozilla.org/[locale]/api | |||
for example | for example | ||
https://services.addons.mozilla.org/en-US/api | |||
https://services.addons.mozilla.org/de/api | |||
=== Available Methods === | === Available Methods === | ||
==== addon ==== | ==== addon ==== | ||
Invoke as: | Invoke as: | ||
https://services.addons.mozilla.org/api/addon/[id] | |||
Returns details of an addon | Returns details of an addon | ||
==== search ==== | ==== search ==== | ||
Invoke as: | Invoke as: | ||
https://services.addons.mozilla.org/api/search/[searchterm]/[optional:searchtype] | |||
Returns addons that match the searchterm. Uses the same search engine as | Returns addons that match the searchterm. Uses the same search engine as | ||
| Line 39: | Line 39: | ||
==== list ==== | ==== list ==== | ||
Invoke as: | Invoke as: | ||
https://services.addons.mozilla.org/api/list/[optional:listtype]/[optional:addontype]/[optional:number] | |||
Returns a [randomized] list of addons. | Returns a [randomized] list of addons. | ||
| Line 48: | Line 48: | ||
==== cumulative_downloads ==== | ==== cumulative_downloads ==== | ||
Invoke as: | Invoke as: | ||
https://services.addons.mozilla.org/api/cumulative_downloads/[id] | |||
Retrieves cumulative downloads for the specified addon. | Retrieves cumulative downloads for the specified addon. | ||
| Line 54: | Line 54: | ||
==== update_pings ==== | ==== update_pings ==== | ||
Invoke as: | Invoke as: | ||
https://services.addons.mozilla.org/api/update_pings/[id]/[optional:period]/[optional:querydate] | |||
Returns update pings for the specified addon. | Returns update pings for the specified addon. | ||
Period may be 'day', 'week', or 'month' and defaults to 'day'. | Period may be 'day', 'week', or 'month' and defaults to 'day'. | ||
Querydate will be the last date in the period you wish to query. Default is today. Date format is YYYY-MM-DD. Invalid dates will default to today. | Querydate will be the last date in the period you wish to query. Default is today. Date format is YYYY-MM-DD. Invalid dates will default to today. | ||
Revision as of 18:07, 7 March 2008
The AMO API allows you to get information about addons hosted on addons.mozilla.org. The API supports REST. At present, it is a read only API (GET only) although this is planned to change in later versions.
No developer id or authentication is currently required to use the AMO API.
Responses are returned in XML format.
For further information, you can read the original PRD for the API: [[1]]
Terms of Use
URL Format
API calls are served via
https://services.addons.mozilla.org/api
You may localize the returned content by adding a locale string to this URL as follows:
https://services.addons.mozilla.org/[locale]/api
for example
https://services.addons.mozilla.org/en-US/api https://services.addons.mozilla.org/de/api
Available Methods
addon
Invoke as: https://services.addons.mozilla.org/api/addon/[id] Returns details of an addon
search
Invoke as: https://services.addons.mozilla.org/api/search/[searchterm]/[optional:searchtype]
Returns addons that match the searchterm. Uses the same search engine as the rest of the site, so only exact match is supported. The searchtype may be one of 'extension', 'theme', 'plugin', 'dictionary', 'searchengine'. If no searchtype is entered extensions and themes will be returned.
list
Invoke as: https://services.addons.mozilla.org/api/list/[optional:listtype]/[optional:addontype]/[optional:number]
Returns a [randomized] list of addons. Listtype may be 'recommended' or 'new' - default is 'recommended'. Addontype may be 'all'/'extension'/'theme'/'plugin'/'dictionary'/'searchengine'.Default is 'all'. Number is the maximum number of results to return. Default is 3.
cumulative_downloads
Invoke as: https://services.addons.mozilla.org/api/cumulative_downloads/[id]
Retrieves cumulative downloads for the specified addon.
update_pings
Invoke as: https://services.addons.mozilla.org/api/update_pings/[id]/[optional:period]/[optional:querydate]
Returns update pings for the specified addon. Period may be 'day', 'week', or 'month' and defaults to 'day'. Querydate will be the last date in the period you wish to query. Default is today. Date format is YYYY-MM-DD. Invalid dates will default to today.