APIs

How to get ISO country code instead of country name

By default the Metrics API returns the country|name if country is the requested dimension. If you are looking to get country ISO code add the following param to the query: ;show=iso or ;show=iso,name to return both the country name and ISO code.

Request:

https://api-metrics.flurry.com/public/v1/data/appUsage/day/app/country;show=iso?metrics=sessions,activeDevices&dateTime=2017-05-01/2017-05-02

Maximum number of rows reached

Our API returns a max of 50,000 rows in the response. If you receive this error:

{"status":500,"statusName":"Internal Server Error","reason":"Internal Server Error","description":"{\"error\":\"Maximum number of rows [50000] reached\"}"}

modify your query to request a smaller scope. For instance, select a smaller time range, or request data for one app at a time.

What is the rate limit for the Flurry APIs?

The API only allows each user to have a certain number of data requests being processed at any one time. If you try to make another request that would put you above the allowed limit, you will be given an error response with an HTTP response status code of 429.

  • The following headers will be returned with a 429 response:
    • X-RateLimit-Limit. The maximum number of credits that the consumer is permitted to charge. All requests consume at least 1 credit but can cost more depending on the resources consumed.

    • X-RateLimit-Remaining. The number of credits remaining. This number can go negative.

    • X-RateLimit-RefillPerMinute. The rate (credits/minute) at which credits are refilled.

How do I enable API access?

You need to acquire the programmatic token to enable the API access.

What formats are supported for the data returned by the APIs?

The Flurry RESTful APIs can return data in JSON or CSV format. To retrieve data in your desired format, just set the format parameter with either &format=json or &format=csv .