What’s new in v1.1?
In short:
v1.1 uses appFigures-assigned product ids instead of Apple ids and is also a bit cleaner.
Explained:
v1.0 uses apple ids as the unique identifier for all products. We’ve recently started supporting the Android Market and in the future plan to support several other app stores, so using apple ids is no longer an option. Starting with v1.1, all products are now assigned a unique product id. All routes now take product ids as the id and so the API can be used to retrieve data for non Apple apps from your account.
In addition, some deprecated properties from v1.0 were removed and other confusing property names were updated. Scroll down for a more detailed overview of the changes.
What are products?
Apps are products, so are books, and other types of content we’re currently supporting or planning to support. We started calling apps products because it’s a much more fitting name for the type of content tracked by our platform.
What about Apple ids?
Apple ids are now referred to as ref_no, which is a new property that’s been added to all products.
Additionally, products from app stores that do not have a numeric id but rather a string identifier (such as the Android Market) will have that string as the sku of the app.
In addition to ref_no, two additional properties have been added to each product:
store_id The id of the app store this product is being sold on.
store_name The name of the app store this product is being sold on.
Matching a product id to an Apple id
The easiest way to match an appFigures’ product id to an apple id is by listing all of your apps using the /users/{email} resource, iterating through the resulting list, and comparing the ref_no.
Route Changes
/users/{email}/itc_accounts → /users/{email}/external_accounts/
/sales/apps/{start}/{end}/ → /sales/products/{start}/{end}/
/sales/dates+apps/{start}/{end}/ → /sales/dates+products/{start}/{end}/
/sales/apps+dates/{start}/{end}/ → /sales/products+dates/{start}/{end}/
New Routes
/users/sales/products+countries/{start}/{end}/
/users/sales/countries+products/{start}/{end}/
Non Product ID Response Changes
The response object for all sales routes has been cleaned up.
The following (deprecated) properties have been removed:
- app_downloads
- in_app_downloads
- app_updates
- in_app_updates
- app_sales_revenue
The following properties have been renamed:
- total_downloads → downloads
- total_updates → updates
A new property has been added:
- net_downloads
Is v1.0 going away?
No. Version 1.0 of the API will be online, and actively supported until Jan. 31 2012.
