APIs

How to get ISO country code instead of country name

By default the Metrics API retruns 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,name

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 retruns max 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 the 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 programatic 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.

I’ve looked through all the relevant areas of the Support Center and read the FAQ, but still have questions.

Didn’t find what you were looking for? Check out the other options to get support.