iTunes Connect API

Question

Does iTunes Connect has an API? How do some applications download financial and sale reports to computer? Are there some C/Objective-C API wrappers?

score 129 · Accepted Answer · edited Jun 20 '20 at 09:12

129

Update 11/02/2018

On November/18, Apple finally released the Appstore Connect REST API. Referencing the Apple description:

TestFlight. Manage beta builds of your app, testers, and groups.

Users and Access. Send invitations for users to join your team. Adjust their level of access or remove users.

Reporting. Download sales and financial reports.

Update 10/03/2018

Good news on this one: on 2018 WWDC, Apple announced the Appstore Connect API - where you'll be able to access almost everything related to your Appstore Connect management. You can see two related talks here and here.

The only curious thing is that its release date was supposed to be late this summer - so it's probably delayed. Nonetheless we should be able to see a release soon.

Update 8/18/2016

Official Reporter tool from Apple

https://help.apple.com/itc/appsreporterguide/#/

iTunes finally released an auto download tool as noted in the PDF

http://www.apple.com/itunesnews/docs/AppStoreReportingInstructions.pdf

Here is the class file

http://www.apple.com/itunesnews/docs/Autoingestion.class.zip

edited Jun 20 '20 at 09:12

Community

1
1

answered Nov 02 '11 at 20:16

gavi

2,104
2
16
9

2

This is the most modern answer but unfortunately it is buried down here. – RealCasually Mar 20 '12 at 05:14
This should really be the accepted answer. – pojo Mar 28 '12 at 11:58
Yes, it isn't that the API Apple uses in the Autoingestion.class is hard to understand. – Helge Becker Aug 15 '12 at 19:20
2

This doesn't seem to work to download financial reports, or am I mistaken? – Jean-Philippe Pellet Apr 27 '13 at 17:52
1

No... it does *not* download financial reports. Which are far more useful for currency conversions... and I also need! – Randy James Jul 31 '13 at 18:19
2

An objc variant: https://github.com/Cocoanetics/DTITCReportDownloader/ – gustaf Nov 26 '13 at 11:01
How can i parse downloaded file ? – yatanadam Jul 31 '14 at 06:47
This link is no longer valid. Got an alternative? – DrMickeyLauer Mar 08 '17 at 13:53

score 23 · Answer 2 · answered Oct 25 '09 at 01:52

There's no API for iTunes connect, the only way you can access the information is through the web or with a program that scrapes the web pages. If you want to create something in Objective-C, download AppSales from github, it's an iPhone app which downloads financial reports from ITC (or maybe itts). You can download it and install it on your iPhone if you have an Apple developer account. You can look through their code and see how they scrape the daily and weekly reports (hint: it's ugly).

http://github.com/omz/AppSales-Mobile

Note that if you try to create an iPhone app to do this, Apple will reject it. It breaks the rule about "No public API". Other people have tried this and been rejected.

If you're just looking for software to do this on your computer, I'd highly recommend AppViz

http://www.ideaswarm.com/products/appviz/

Here's a nice post which compares these and more apps:

http://www.markj.net/sales-stats-tools-for-iphone-apps/

We have been using all of the above but were not quite happy with the results. Especially that we have apps in Apple App Store and Google Play, etc we switched to using [Distimo](http://www.distimo.com/). It is free in terms of money but you pay by providing them with free app store data obviously. — vinzenzweber, May 15 '12 at 07:53
We (appFigures) have a pretty strict privacy policy. If that's important to you give us a try ;) — Ariel, May 25 '12 at 00:47
Also, I think Apple is against 'scraping' of iTunes websites, at least, but if you only use this functionality for development, it should be OK... — Nicolas Miari, Jul 17 '12 at 16:39

KrauseFx · Answer 3 · 2016-09-02T17:13:15.973

15

For everything non-sales related, you might want to check out the unoffical documentation of the iTunes Connect JSON API: https://github.com/fastlane/itc-api-docs

Update: There is now a Ruby implementation of both the iTunes Connect API and the Apple Developer API available: https://github.com/fastlane/fastlane/tree/master/spaceship

edited Sep 02 '16 at 17:13

answered Apr 06 '15 at 09:51

KrauseFx

11,551
7
46
53

Yes, that's brilliant and more relevant for today. Thanks for link! Switched connect answer. – totocaster Apr 07 '15 at 00:04
Just trialling this. Why 'non sales related'? Would say, getting download stats (units) on a free app be related to sales? (Which is what I'm looking at polling daily programmatically). – square_eyes Oct 12 '15 at 03:42
Not sure why this is marked as correct. `spaceship`, as great a tool as it is, is not capable of downloading "financial and sale reports" as requested, unless I am mistaken. – funkybro Sep 01 '16 at 09:37

score 8 · Answer 4 · answered Jan 30 '12 at 12:59

Following up on gavi's answer: if you download & decompile the Autoingestion class you can see the API that Apple use for sales downloads.

It consists of a POST to https://reportingitc.apple.com/autoingestion.tft with the form values: USERNAME, PASSWORD, VNDNUMBER, TYPEOFREPORT, DATETYPE, REPORTTYPE, REPORTDATE. Refer to the PDF for details of the parameters

The response will contain the header 'ERRORMSG' if there's an error, and the header 'filename' if there's a body (presumably Apple developers don't know about Content-Disposition or 4xx/5xx status codes). The body of the response contains the file data.

score 5 · Answer 5 · answered Oct 25 '09 at 00:53

5

Here is a small project that may be helpful to you in automating the download of piano reports from iTunes Connect. It's a python script to automate the login / download of daily sales files and I use it daily in conjunction with some other scripts to parse that data. Hook it up to a cron job with some error checking (the reports never seem to be generated at the same time) and you'll be good to go.

http://code.google.com/p/appdailysales/

answered Oct 25 '09 at 00:53

prairiedogg

6,323
8
44
52

This is the only recent one that I could find that would work for grabbing the actual data so I could do with it what I wanted, and yet it still needed some modifications because of recent Apple changes. – lilbyrdie Oct 29 '10 at 23:46

score 1 · Answer 6 · answered Oct 24 '09 at 21:28

No, no formal API (or if there is one, it's well hidden even from iPhone developer users of iTunes connect). However, the sales & financial reports are downloadable as tab delimited plaintext (gzip compressed), though to make the request you'll have to login (which is cookie based). One could probably wrap this process up with a little bit of screen scraping, and thus get access to the TSV files.

score 1 · Answer 7 · edited Apr 13 '20 at 17:30

To can use the AutoIngestion Tool the vendorId is needed. To find it, with the last update on iTunes Connect, in the Sales and Trends section, pressing on the top right menu that shows "Top Content" can access to the Reports entry (direct link).

There you can see the "Vendor" selector, pressing on it you can see the Details of the vendor with the following format:

VendorName - VendorId

Hope it helps.

score 1 · Answer 8 · answered Mar 17 '10 at 15:11

1

Take a look at http://www.itunesapis.com. This is the missing iTunes and iTunes Connect API.

answered Mar 17 '10 at 15:11

user295760

51
1
1

8

Do you think service is safe? I mean some of their parameters requier email, password, and App ID. That's a whole lot of information that Im not willing to share, especially over the wire. – AlvinfromDiaspar Aug 23 '10 at 21:07
6

I would never give the needed Apple ID information to such a 3rd party site. Even if they promise not to abuse the data they have access to, you can't be sure their servers are always safe. Also, it might be a violation of the App Store contracts to reveal password data to such 3rd parties. – Ortwin Gentz Jan 03 '11 at 21:25
At this time the link redirects to a page generated by a domain parking service. – Rubén Jan 08 '18 at 17:05
1

That link looks malicious to me! – Kai Jan 30 '19 at 12:52

score 1 · Answer 9 · edited Apr 06 '14 at 20:23

1

Shameless plug for my own perl5 module...

http://metacpan.org/pod/WWW::iTunesConnect

Although, given yesterday's announcement of an official Apple app, there might be an API in the works.

edited Apr 06 '14 at 20:23

szabgab

6,202
11
50
64

answered Jun 11 '10 at 08:25

Brandon Fosdick

15,673
4
21
20

score 1 · Answer 10 · answered Aug 23 '15 at 03:50

1

The most popular one on GitHub is spaceship

It is a Ruby library. You can NSTask to call ruby code.

answered Aug 23 '15 at 03:50

Tyler Liu

19,552
11
100
84

score 1 · Answer 11 · answered Nov 23 '16 at 18:43

after looking everywhere I did not find a PHP version of the reports API so made my own.

You can check it out on https://github.com/Finnb8r/itunes-connect-sales-api-php .

I realize that this is not an Objective-C wrapper but this link comes out on top when generally looking for an API.

Ariel · Answer 12 · 2009-12-31T03:27:18.917

0

There's no formal API but several open source and commercial products available that bring some/most/all info together (such as the ones mentioned in previous answers).

Another such solution is www.appfigures.com which combines sales reports, app reviews, and hourly rank updates. Unlike the other apps appfigures can automatically import your reports and email you a nicely formatted report by email every day/week.

edited Dec 31 '09 at 03:27

answered Dec 16 '09 at 22:02

Ariel

4,502
2
21
23

Have you implemented appFigures API??? If yes, please provide some code. – Apple May 21 '12 at 08:42
I'm on the appFigures team so yes :) If you contact us directly we'll guide you through and can also help with code samples. Or, there are a few client libs on github other developers have posted. – Ariel May 25 '12 at 00:43
So, Please provide some Sample code. because we have no idea about how to integrate appFigure API. – Apple May 25 '12 at 06:28

score 0 · Answer 13 · answered Sep 28 '10 at 15:54

0

There is ITunes Store Search API:

http://www.apple.com/itunes/affiliates/resources/blog/introduction---search-api.html

It is part of Apple affiliate program.

Hope this will help you.

answered Sep 28 '10 at 15:54

UBIK LOAD PACK

33,980
5
71
116

iTunes Connect API

13 Answers13

Update 11/02/2018

Update 10/03/2018

Update 8/18/2016

Linked

Related