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

Marketplace General Discussion
1

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:

Marketplace_Clarity___Slack
Marketplace_Clarity___Slack1386×202 35.5 KB

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 : Leveraging the Marketplace API - YouTube

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

Cheers,
Sven

11 Likes
2

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:

2 Likes
3

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.

32
321274×702 83.7 KB

2 Likes
4

Hi there,
there seem to be a limitation in the number of apps you can get with this API: https://marketplace.atlassian.com/rest/2/addons

300 it seems? Any idea how to get them all in one call?

Thanks!

5

Hi @ConstanceHua ,

As far as I know, you cannot get them all at once. You’ll need to call again with ?offset=300 to get the next 300, then ?offset=600 and so forth.

They also provide some attribute like _links.next that has the relative URL to call for the next n apps.

6

If it’s anything like transactions then the _links.next doesn’t appear. I had to say if the number of records equals the limit I asked for then increase the offset and and ask for the next lot

7

Hi @paul ,

I guess it’s different from the transactions endpoint. At least for me, the addons endpoint always worked well.
As for the transactions, I hit the transactions/export endpoint daily with a startdate a few days in the past. So far I never had the case where it did not return all transactions available.

8

Hi Sven,
can this be used to automate the sending of trial users/evaluator info(email, company etc.) directly to our CRM(Salesforce) or Marketing App (Hubspot)? Any advice would be greatly appreciated.

Kind Regards

9

Yes, it can! There are several existing community efforts for implementing this.

https://bitbucket.org/jexoio/atlassian-marketplace-aws-lambda

1 Like
10

Thanks for the link Remie, we’ll look into this :wink: