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?

Was it helpful?

Solution

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

OTHER TIPS

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/

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

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.

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/

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.

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.

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

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.

To can use the AutoIngestion Tool the vendorId is needed. To find it, with the last update on iTunnes 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.

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.

There is ITunes Store Search API:

It is part of Apple affiliate program.

Hope this will help you.

The most popular one on GitHub is spaceship

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

Licensed under: CC-BY-SA with attribution
Not affiliated with StackOverflow
scroll top