API Requests Cost Calculation

Overview

Some API requests may become more complex when additional parameters are included. These parameters allow you to retrieve more detailed or extended data, making the response more useful, but they also increase the amount of processing required on the server side.

In such cases, the total cost of the request is calculated based on multiple endpoints being called, as well as the amount of extra data returned. When you add optional parameters, a single request may trigger several underlying data sources, which results in a higher overall cost.

Below, you’ll find examples demonstrating how request pricing changes when additional options are used.

Requests with timestamp

For all requests that support the timestamp parameter, you can retrieve data for any specified date range. Please note that requests containing a timestamp consume 3× more API credits due to the additional processing required.

Example 1: Application keywords rank movement

This request returns last 30 days by default and costs 50 credits.

https://api.asodesk.com/api/app-keywords-rank-movement?country=US&storeid=1077853625&storetype=appstore

When you define a custom date range using the since and till parameters, the API will return data for that specific period. This type of request requires 150 credits.

https://api.asodesk.com/api/app-keywords-rank-movement?country=US&storeid=1077853625&storetype=appstore&till=2025-05-16T15:53&since=2025-04-16T15:13

Example 2: Top 100 search results by keyword

By default, the request returns list of top 100 application IDs found on an app store at the moment, sorted by rank. The request costs 5 credits.

https://api.asodesk.com/api/search-results?country=US&storetype=appstore&query=flight

If you include a specific timestamp, the API will provide data for your chosen date, and the request will use 15 credits.

https://api.asodesk.com/api/search-results?country=US&storetype=appstore&query=flight&timestamp=2025-11-16T19:20%2B03:00

Keyword Suggestions

The request returns store suggestions by keyword. It requires 5 API credits without optional parameters.

https://api.asodesk.com/api/keyword-suggestions?country=US&storetype=appstore&query=maps

With additional parameter with_stats=true, the response will contain the data about each keyword suggestion (popularity, top-5 apps and Daily Impressions).

Additional credits will be withdrawn for each keyword in results set according to price of Keyword stats request (10 credits per keyword).

For example, the response includes 10 keywords and will cost 5 + 10 * 10 = 105 credits.

https://api.asodesk.com/api/keyword-suggestions?country=US&storetype=appstore&query=maps&with_stats=true

With additional parameter with_top5_meta=true (works only with with_stats=true), the response will contain store id, logo, name, developer, rating and price of each app included in top5_apps list.

For each application info included in top5_apps list, additional credits will be withdrawn according to price of App meta request (1 credit) .

For example, the response includes 10 keywords with top-5 apps for each keyword and will cost 5 + 10 * 10 + 5 * 10 = 155 credits.

https://api.asodesk.com/api/keyword-suggestions?country=US&storetype=appstore&query=maps&with_stats=true&with_top5_meta=true

Keyword Auto-Suggestions

By default, the request returns top 100 keywords for 1 app for 1 country for 1 store type sorted by Estimated Daily Impressions. It requires 300 API credits without optional parameters.

https://api.asodesk.com/api/keyword-auto-suggestions?country=US&storetype=appstore&storeid=284815942

With additional parameter with_stats=true, the response will contain the data about each keyword suggestion (popularity, top-5 apps and Daily Impressions).

Additional credits will be withdrawn for each keyword in results set according to price of Keyword stats request (10 credits per keyword).

For example, the response includes 100 keywords and will cost 300 + 100 * 10 = 1300 credits.

https://api.asodesk.com/api/keyword-auto-suggestions?country=US&storetype=appstore&storeid=284815942&with_stats=true

With additional parameter with_top5_meta=true (works only with with_stats=true), the response will contain store id, logo, name, developer, rating and price of each app included in top5_apps list.

For each application info included in top5_apps list, additional credits will be withdrawn according to price of App meta request (1 credit) .

For example, the response includes 100 keywords with top-5 apps for each keyword and will cost 300 + 100 * 10 + 5 * 100 = 1800 credits.

https://api.asodesk.com/api/keyword-auto-suggestions?country=US&storetype=appstore&storeid=284815942&with_stats=true&with_top5_meta=true