Tip: Check out the Marketplace REST API! (How to get the total number of users, installs, and downloads of your Atlassian Marketplace app)

Hey there,

Today, I asked a few others Marketplace Partners about a certain endpoint in the Marketplace REST API. Specifically about the /addons/{addonKey}/distribution endpoint. It turns out some of them hadn’t heard about this endpoint before and were quite happy to learn about it. I therefore decided to create a thread on here to share this information more broadly and hopefully make this somewhat findable on Google/CDAC as well.

The mentioned endpoint essentially gives you this information for a specific appKey:

  "bundled": false,
  "bundledCloud": false,
  "downloads": 28874,
  "totalInstalls": 1279,
  "totalUsers": 1559158

This can be particularly useful to track the growth of your app and also others for comparison. For example, check out the live numbers for some popular apps here:

But this is by far not the only useful endpoint there is. You can also track the pricing of other apps and learn how other Marketplace Partners adjust their pricing over time, as well as the content in their app listings. You can also use it to build your own reporting on your sales and license data or for building a mechanism that automatically deploys new versions of your app to the Marketplace. We have for example used the products endpoint to build a small Slack app that let’s us know whenever there’s a new release of Confluence, Jira, or Bitbucket:

There’s a lot more to explore, so, definitely go ahead and browse the docs a bit: https://developer.atlassian.com/platform/marketplace/rest

Also, if you want to hear more about what you can do with the Marketplace REST API, there’s a great AtlasCamp talk about it from @joes : https://www.youtube.com/watch?v=DPgx4_rjue8

Are you using the Marketplace REST API? What have you built on it? :smiley:



I have some serverless scripts that sync the API data into my own postgresql database.
Then on top of that I run https://www.metabase.com/ to visualize the data in custom dashboards. (There is also a world map widget to visualize per country, even though custom mapping of country codes was a bit tricky)

Did not know about that particular user number :slight_smile: thanks a lot :slight_smile:


We use this in a similar fashion, some serverless cron jobs polling a few of the apis and pushing alerts to slack about user counts changes, new licenses, etc.

1 Like