{"id":8974,"date":"2021-02-01T08:05:58","date_gmt":"2021-02-01T16:05:58","guid":{"rendered":"http:\/\/blog.mozilla.org\/addons\/?p=8974"},"modified":"2021-01-29T10:06:45","modified_gmt":"2021-01-29T18:06:45","slug":"addons-mozilla-org-api-v3-deprecation","status":"publish","type":"post","link":"https:\/\/blog.mozilla.org\/addons\/2021\/02\/01\/addons-mozilla-org-api-v3-deprecation\/","title":{"rendered":"addons.mozilla.org API v3 Deprecation"},"content":{"rendered":"<p>The <a href=\"https:\/\/addons.mozilla.org?utm_source=blog.mozilla.org&amp;utm_medium=post&amp;utm_content=amo-api-v3-deprecation\">addons.mozilla.org<\/a> (AMO) <a href=\"https:\/\/addons-server.readthedocs.io\/en\/latest\/topics\/api\/index.html\">external API<\/a> can be used by users and developers to get information about add-ons available on AMO, and to submit new add-on versions for signing.\u00a0 It\u2019s also used by Firefox for recommendations, among other things, by the <a href=\"https:\/\/github.com\/mozilla\/web-ext\/\">web-ext<\/a> tool, and internally within the addons.mozilla.org website.<\/p>\n<p>We plan to shut down <a href=\"https:\/\/addons-server.readthedocs.io\/en\/latest\/topics\/api\/v3_legacy\/index.html\">Version 3<\/a> (v3) of the AMO API on December 31, 2021. If you have any personal scripts that rely on v3 of the API, or if you interact with the API through other means, we recommend that you switch to the stable <a href=\"https:\/\/addons-server.readthedocs.io\/en\/latest\/topics\/api\/v4_frozen\/index.html#v4-api-index\">v4<\/a>. You don\u2019t need to take any action if you don\u2019t use the AMO API directly. The AMO API v3 is <b>entirely unconnected<\/b> to <a href=\"https:\/\/blog.mozilla.org\/addons\/2019\/09\/03\/mozillas-manifest-v3-faq\/\">manifest v3 for the WebExtensions <\/a>API, which is the umbrella project for major changes to the extensions platform itself.<\/p>\n<p>Roughly five years ago, we introduced v3 of the AMO API for add-on signing. Since then, we have continued developing additional versions of the API to fulfill new requirements, but have maintained v3 to preserve backwards compatibility. However, having to maintain multiple different versions has become a burden. This is why we\u2019re planning to update dependent projects to use v4 of the API soon and shut down v3 at the end of the year.<\/p>\n<p>You can find more information about <a href=\"https:\/\/addons-server.readthedocs.io\/en\/latest\/topics\/api\/v3_legacy\/index.html\">v3<\/a> and <a href=\"https:\/\/addons-server.readthedocs.io\/en\/latest\/topics\/api\/v4_frozen\/index.html#v4-api-index\">v4<\/a> on our <a href=\"https:\/\/addons-server.readthedocs.io\/en\/latest\/topics\/api\/overview.html#api-versions\">API documentation site<\/a>.\u00a0 When updating your scripts, we suggest just making the change from \u201c\/v3\/\u201d to \u201c\/v4\u201d and seeing if everything still works &#8211; in most cases it will.<\/p>\n<p>Feel free to <a href=\"https:\/\/wiki.mozilla.org\/Add-ons#Get_in_touch\">contact us<\/a> if you have any difficulties.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The addons.mozilla.org (AMO) external API can be used by users and developers to get information about add-ons available on AMO, and to submit new add-on versions for signing.\u00a0 It\u2019s also &hellip; <a class=\"go\" href=\"https:\/\/blog.mozilla.org\/addons\/2021\/02\/01\/addons-mozilla-org-api-v3-deprecation\/\">Read more<\/a><\/p>\n","protected":false},"author":1304,"featured_media":8108,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[44,121],"tags":[17],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v22.5 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>addons.mozilla.org API v3 Deprecation - Mozilla Add-ons Community Blog<\/title>\n<meta name=\"description\" content=\"The AMO API v3 is deprecated and will be shut down by the end of 2021. We recommend updating to the stable v4.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/blog.mozilla.org\/addons\/2021\/02\/01\/addons-mozilla-org-api-v3-deprecation\/\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Andrew Williamson\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/blog.mozilla.org\/addons\/2021\/02\/01\/addons-mozilla-org-api-v3-deprecation\/\",\"url\":\"https:\/\/blog.mozilla.org\/addons\/2021\/02\/01\/addons-mozilla-org-api-v3-deprecation\/\",\"name\":\"addons.mozilla.org API v3 Deprecation - Mozilla Add-ons Community Blog\",\"isPartOf\":{\"@id\":\"https:\/\/blog.mozilla.org\/addons\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/blog.mozilla.org\/addons\/2021\/02\/01\/addons-mozilla-org-api-v3-deprecation\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/blog.mozilla.org\/addons\/2021\/02\/01\/addons-mozilla-org-api-v3-deprecation\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/blog.mozilla.org\/addons\/files\/2017\/03\/addons-puzzle-fox.png\",\"datePublished\":\"2021-02-01T16:05:58+00:00\",\"dateModified\":\"2021-01-29T18:06:45+00:00\",\"author\":{\"@id\":\"https:\/\/blog.mozilla.org\/addons\/#\/schema\/person\/10f4605b8fa84a12bc216d95c415d3dd\"},\"description\":\"The AMO API v3 is deprecated and will be shut down by the end of 2021. We recommend updating to the stable v4.\",\"breadcrumb\":{\"@id\":\"https:\/\/blog.mozilla.org\/addons\/2021\/02\/01\/addons-mozilla-org-api-v3-deprecation\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/blog.mozilla.org\/addons\/2021\/02\/01\/addons-mozilla-org-api-v3-deprecation\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/blog.mozilla.org\/addons\/2021\/02\/01\/addons-mozilla-org-api-v3-deprecation\/#primaryimage\",\"url\":\"https:\/\/blog.mozilla.org\/addons\/files\/2017\/03\/addons-puzzle-fox.png\",\"contentUrl\":\"https:\/\/blog.mozilla.org\/addons\/files\/2017\/03\/addons-puzzle-fox.png\",\"width\":220,\"height\":220,\"caption\":\"Add-ons logo\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/blog.mozilla.org\/addons\/2021\/02\/01\/addons-mozilla-org-api-v3-deprecation\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/blog.mozilla.org\/addons\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"addons.mozilla.org API v3 Deprecation\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/blog.mozilla.org\/addons\/#website\",\"url\":\"https:\/\/blog.mozilla.org\/addons\/\",\"name\":\"Mozilla Add-ons Community Blog\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/blog.mozilla.org\/addons\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/blog.mozilla.org\/addons\/#\/schema\/person\/10f4605b8fa84a12bc216d95c415d3dd\",\"name\":\"Andrew Williamson\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/blog.mozilla.org\/addons\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/6b19e02916b6a9f236d054f78f0abd95?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/6b19e02916b6a9f236d054f78f0abd95?s=96&d=mm&r=g\",\"caption\":\"Andrew Williamson\"},\"url\":\"https:\/\/blog.mozilla.org\/addons\/author\/awilliamsonmozilla-com\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"addons.mozilla.org API v3 Deprecation - Mozilla Add-ons Community Blog","description":"The AMO API v3 is deprecated and will be shut down by the end of 2021. We recommend updating to the stable v4.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/blog.mozilla.org\/addons\/2021\/02\/01\/addons-mozilla-org-api-v3-deprecation\/","twitter_misc":{"Written by":"Andrew Williamson","Est. reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/blog.mozilla.org\/addons\/2021\/02\/01\/addons-mozilla-org-api-v3-deprecation\/","url":"https:\/\/blog.mozilla.org\/addons\/2021\/02\/01\/addons-mozilla-org-api-v3-deprecation\/","name":"addons.mozilla.org API v3 Deprecation - Mozilla Add-ons Community Blog","isPartOf":{"@id":"https:\/\/blog.mozilla.org\/addons\/#website"},"primaryImageOfPage":{"@id":"https:\/\/blog.mozilla.org\/addons\/2021\/02\/01\/addons-mozilla-org-api-v3-deprecation\/#primaryimage"},"image":{"@id":"https:\/\/blog.mozilla.org\/addons\/2021\/02\/01\/addons-mozilla-org-api-v3-deprecation\/#primaryimage"},"thumbnailUrl":"https:\/\/blog.mozilla.org\/addons\/files\/2017\/03\/addons-puzzle-fox.png","datePublished":"2021-02-01T16:05:58+00:00","dateModified":"2021-01-29T18:06:45+00:00","author":{"@id":"https:\/\/blog.mozilla.org\/addons\/#\/schema\/person\/10f4605b8fa84a12bc216d95c415d3dd"},"description":"The AMO API v3 is deprecated and will be shut down by the end of 2021. We recommend updating to the stable v4.","breadcrumb":{"@id":"https:\/\/blog.mozilla.org\/addons\/2021\/02\/01\/addons-mozilla-org-api-v3-deprecation\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/blog.mozilla.org\/addons\/2021\/02\/01\/addons-mozilla-org-api-v3-deprecation\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/blog.mozilla.org\/addons\/2021\/02\/01\/addons-mozilla-org-api-v3-deprecation\/#primaryimage","url":"https:\/\/blog.mozilla.org\/addons\/files\/2017\/03\/addons-puzzle-fox.png","contentUrl":"https:\/\/blog.mozilla.org\/addons\/files\/2017\/03\/addons-puzzle-fox.png","width":220,"height":220,"caption":"Add-ons logo"},{"@type":"BreadcrumbList","@id":"https:\/\/blog.mozilla.org\/addons\/2021\/02\/01\/addons-mozilla-org-api-v3-deprecation\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/blog.mozilla.org\/addons\/"},{"@type":"ListItem","position":2,"name":"addons.mozilla.org API v3 Deprecation"}]},{"@type":"WebSite","@id":"https:\/\/blog.mozilla.org\/addons\/#website","url":"https:\/\/blog.mozilla.org\/addons\/","name":"Mozilla Add-ons Community Blog","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/blog.mozilla.org\/addons\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/blog.mozilla.org\/addons\/#\/schema\/person\/10f4605b8fa84a12bc216d95c415d3dd","name":"Andrew Williamson","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/blog.mozilla.org\/addons\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/6b19e02916b6a9f236d054f78f0abd95?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/6b19e02916b6a9f236d054f78f0abd95?s=96&d=mm&r=g","caption":"Andrew Williamson"},"url":"https:\/\/blog.mozilla.org\/addons\/author\/awilliamsonmozilla-com\/"}]}},"_links":{"self":[{"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/posts\/8974"}],"collection":[{"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/users\/1304"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/comments?post=8974"}],"version-history":[{"count":0,"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/posts\/8974\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/media\/8108"}],"wp:attachment":[{"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/media?parent=8974"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/categories?post=8974"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/tags?post=8974"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}