---
title: API Requests Cost Calculation
description: API Requests Cost Calculation
---

[Skip to content](https://help.asodesk.com/api-requests-cost-calculation#main-content)

- [English](https://help.asodesk.com/api-requests-cost-calculation)
- [Русский](https://help.asodesk.com/ru/api-requests-cost-calculation)

English

Show submenu for translations

![Asodesk logo.svg](https://help.asodesk.com/hubfs/Asodesk%20logo.svg)

Open main navigation

Close main navigation

- - [English](https://help.asodesk.com/api-requests-cost-calculation)
    - [Русский](https://help.asodesk.com/ru/api-requests-cost-calculation)

  English
  
  Show submenu for translations
- [Go to Dashboard](https://hq.asodesk.com/)

[Go to Dashboard](https://hq.asodesk.com/)

 Advice and answers from the Asodesk team

- There are no suggestions because the search field is empty.

1. [Help Center](https://help.asodesk.com/?hsLang=en)
2. [Integrations](https://help.asodesk.com/integrations?hsLang=en)
3. [API](https://help.asodesk.com/integrations?hsLang=en#api)

# API Requests Cost Calculation

| **In this article:** [Overview](https://help.asodesk.com/api-requests-cost-calculation#overview) [Requests with timestamp](https://help.asodesk.com/api-requests-cost-calculation#timestamp) - [Example 1: Application keywords rank movement](https://help.asodesk.com/api-requests-cost-calculation#ex1) - [Example 2: Top 100 search results by keyword](https://help.asodesk.com/api-requests-cost-calculation#ex2) [Keyword Suggestions](https://help.asodesk.com/api-requests-cost-calculation#suggestions) [Keyword Auto-Suggestions](https://help.asodesk.com/api-requests-cost-calculation#auto-suggestions) |
| --- |

 

### 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`

![](https://help.asodesk.com/hs-fs/hubfs/image-png-Nov-25-2025-02-15-52-5377-PM.png?width=670&height=619&name=image-png-Nov-25-2025-02-15-52-5377-PM.png)

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`

![](https://help.asodesk.com/hs-fs/hubfs/image-png-Nov-25-2025-02-18-05-6541-PM.png?width=670&height=470&name=image-png-Nov-25-2025-02-18-05-6541-PM.png)

 

#### 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`

![](https://help.asodesk.com/hs-fs/hubfs/image-png-Nov-25-2025-02-23-08-7766-PM.png?width=670&height=703&name=image-png-Nov-25-2025-02-23-08-7766-PM.png)

 

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`

![](https://help.asodesk.com/hs-fs/hubfs/image-png-Nov-25-2025-02-26-52-2261-PM.png?width=670&height=524&name=image-png-Nov-25-2025-02-26-52-2261-PM.png)

By default, all response timestamps are provided in UTC, unless you specify a different time zone in your request.

### 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`

![](https://help.asodesk.com/hs-fs/hubfs/image-png-Nov-25-2025-02-39-36-2501-PM.png?width=670&height=575&name=image-png-Nov-25-2025-02-39-36-2501-PM.png)

 

**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](https://api.asodesk.com/static/docs/html/modules/chargeable/keyworddata/keyword_stats.html) 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`

![](https://help.asodesk.com/hs-fs/hubfs/image-png-Nov-25-2025-02-46-21-5747-PM.png?width=670&height=635&name=image-png-Nov-25-2025-02-46-21-5747-PM.png)

 

**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](https://api.asodesk.com/static/docs/html/modules/chargeable/appdata/app_meta.html) 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`

![](https://help.asodesk.com/hs-fs/hubfs/image-png-Nov-25-2025-03-00-05-8924-PM.png?width=670&height=412&name=image-png-Nov-25-2025-03-00-05-8924-PM.png)

### 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`

![](https://help.asodesk.com/hs-fs/hubfs/image-png-Nov-25-2025-03-04-58-1078-PM.png?width=670&height=419&name=image-png-Nov-25-2025-03-04-58-1078-PM.png)

 

**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](https://api.asodesk.com/static/docs/html/modules/chargeable/keyworddata/keyword_stats.html) 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`

![](https://help.asodesk.com/hs-fs/hubfs/image-png-Nov-25-2025-03-15-25-6650-PM.png?width=670&height=578&name=image-png-Nov-25-2025-03-15-25-6650-PM.png)

 

**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](https://api.asodesk.com/static/docs/html/modules/chargeable/appdata/app_meta.html) 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`

![](https://help.asodesk.com/hs-fs/hubfs/image-png-Nov-25-2025-03-17-25-0311-PM.png?width=670&height=418&name=image-png-Nov-25-2025-03-17-25-0311-PM.png)

     

---

 

Need help understanding our products or services? Have a question? Let us know!  
Click the support icon in the bottom right corner or write on [hello@asodesk.com](mailto:hello@asodesk.com)

 

- [Getting Started](https://help.asodesk.com/getting-started?hsLang=en#main-content)

    - [Trial Access](https://help.asodesk.com/getting-started?hsLang=en#trial-access)
    - [Account](https://help.asodesk.com/getting-started?hsLang=en#account)
    - [Teammates](https://help.asodesk.com/getting-started?hsLang=en#teammates)
- [ASO Tools](https://help.asodesk.com/aso-tools?hsLang=en#main-content)

    - [Getting Started](https://help.asodesk.com/aso-tools?hsLang=en#getting-started)
    - [ASO Analytics](https://help.asodesk.com/aso-tools?hsLang=en#aso-analytics)
    - [Keywords](https://help.asodesk.com/aso-tools?hsLang=en#keywords)
    - [Stores Analytics](https://help.asodesk.com/aso-tools?hsLang=en#stores-analytics)
    - [Competitors](https://help.asodesk.com/aso-tools?hsLang=en#competitors)
    - [Page Builder](https://help.asodesk.com/aso-tools?hsLang=en#page-builder)
- [Reviews & Ratings](https://help.asodesk.com/reviews-ratings?hsLang=en#main-content)

    - [Reviews & Replies Board](https://help.asodesk.com/reviews-ratings?hsLang=en#reviews-replies-board)
    - [Analytics](https://help.asodesk.com/reviews-ratings?hsLang=en#analytics)
    - [Automation](https://help.asodesk.com/reviews-ratings?hsLang=en#automation)
- [Stores](https://help.asodesk.com/stores?hsLang=en#main-content)

    - [App Store](https://help.asodesk.com/stores?hsLang=en#app-store)
    - [Google Play](https://help.asodesk.com/stores?hsLang=en#google-play)
    - [Huawei AppGallery](https://help.asodesk.com/stores?hsLang=en#huawei-appgallery)
    - [Samsung Galaxy Store](https://help.asodesk.com/stores?hsLang=en#samsung-galaxy-store)
- [Integrations](https://help.asodesk.com/integrations?hsLang=en#main-content)

    - [General Info](https://help.asodesk.com/integrations?hsLang=en#general-info)
    - [Reply-to-Reviews Integrations](https://help.asodesk.com/integrations?hsLang=en#reply-to-reviews-integrations)
    - [Reports & Alerts: Slack, Telegram, Email](https://help.asodesk.com/integrations?hsLang=en#reports-alerts-slack-telegram-email)
    - [Setting up Reports & Alerts](https://help.asodesk.com/integrations?hsLang=en#setting-up-reports-alerts)
    - [API](https://help.asodesk.com/integrations?hsLang=en#api)
    - [Exports](https://help.asodesk.com/integrations?hsLang=en#exports)
- [Pricing and Payment](https://help.asodesk.com/pricing-and-payment?hsLang=en#main-content)

    - [Payment](https://help.asodesk.com/pricing-and-payment?hsLang=en#payment)
    - [Subscriptions](https://help.asodesk.com/pricing-and-payment?hsLang=en#subscriptions)
- [Keyword Boost](https://help.asodesk.com/keyword-boost?hsLang=en)
- [More Resources](https://help.asodesk.com/more-resources?hsLang=en)
- [Tips & Use Cases](https://help.asodesk.com/tips-use-cases?hsLang=en)

[![Chill listening crop-3](https://help.asodesk.com/hubfs/Asodesk%20logo-1.svg "Chill listening crop-3")](http://asodesk.com?hsLang=en)

<https://facebook.com/asodesk> <https://linkedin.com/company/asodeskinc/> <https://twitter.com/Asodesk>

Copyright © 2026, asodesk.com