Revenue API

About Revenue API

As the world’s #1 in App revenue tracking accuracy, we want to share our tracking engine with external users. That is why we are excited to offer the Revenue API.

Revenue API – is an API made specially for enterprise games and apps, which lets you retrieve accurate proceeds value with all the fees and taxes deducted, and using Apple’s/ Google’s currency exchange rates. API is using the same core backend as Apphud does, but is deployed on the dedicated server. It works SDK-less and is available for use within the app, or Server-to-Server. As designed for high load, Revenue API may be useful not only for games or apps, but even for other SaaS services.

API Request

Get https://api.apphud.com/v3/revenues

Get accurate proceeds and tax information

Example:

https://api.apphud.com/v3/revenues?price=4.99&store=app_store&country_code=FR¤cy_code=EUR&fee=0.15&api_key=YOUR_API_KEY

Parameters

Query


api_key*	String	API Key obtained from Sales Manager
price*	Float	In-App Purchase Price (Gross)
country_code*	String	Product Locale's Country, ex. `GB`
currency_code*	String	Product Locale's Currency, ex. `GBP`
store*	String	Either `app_store` or `play_store`
purchase_date	Int64	Optional. Unix timestamp of the purchase, ex. `1663143775`. Current time will be used, if not passed.
fee	Float	Optional. Store fee, either `0.3` or `0.15`. Default is `0.3`

Responses: 200

{
  "data": {
    "price_usd": 8982000,
    "proceeds_usd": 1122750,
    "proceeds": 62375000,
    "tax": 83166667,
    "tax_usd": 1497000,
    "exchange_rate": 0.0166311,
    "valid_till": 1663200000,
    "exchange": "internal"
  }
}

Response Description


price_usd	Gross price converted to USD, in millicents
proceeds_usd	Developer Proceeds converted to USD, in millicents
proceeds	Developer Proceeds in local currency, in millicents
tax	Tax amount in local currency, in millicents
tax_usd	Tax amount converted to USD, in millicents
exchange_rate	Exchange rate that was used to convert price to USD
valid_till	The date until the given exchange rate is valid, in Unix timestamp
exchange	Possible values: "internal" or "openexchangerates". The second option will be used only as a fallback, if our system is unable to retrieve internal exchange rate. Any fallbacks are treated as a system failure and will be displayed in our Status Page.