# Расчет Стоимости API-Запросов

Source: https://help.asodesk.com/ru/api-requests-cost-calculation/
Updated: 2025-12-02
Section: Интеграции › API

## Общая информация

Некоторые API-запросы могут иметь расширенную структуру, если при выполнении запроса используются дополнительные параметры. Такие параметры позволяют получать больше данных и делают ответ более информативным, но при этом усложняют обработку запроса на стороне сервера.

В этих случаях итоговая стоимость запроса рассчитывается на основе нескольких вызываемых эндпоинтов, а также объёма дополнительных данных, включённых в ответ. Если вы указываете дополнительные параметры, запрос может обращаться к нескольким источникам данных сразу, что увеличивает итоговую стоимость.

Ниже приведены примеры того, как меняется расчёт стоимости при использовании дополнительных опций.

## Запросы с параметром timestamp

Для всех запросов, которые поддерживают параметр `timestamp`, вы можете получить данные за любой указанный диапазон дат.

Обратите внимание, что запросы, содержащие timestamp, потребляют **в 3 раза больше API-кредитов** из-за необходимости дополнительной обработки.

### Пример 1: Application keywords rank movement

Этот запрос по умолчанию возвращает данные за последние 30 дней и стоит 50 кредитов.

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

![](https://help.asodesk.com/_astro/041ee81482b5.Dc-UR5RO_Z1OPKAV.webp)

Когда вы задаете свой диапазон дат с помощью параметров `since` и `till`, API возвращает данные за этот конкретный период.

Для такого запроса потребуется 150 кредитов.

`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/_astro/f781a8e50056.CGsFKxG4_Z1teNzf.webp)

### Пример 2: Top 100 search results by keyword

По умолчанию запрос возвращает список ID 100 самых популярных приложений, найденных в сторе на данный момент, отсортированных по позиции в поиске. Запрос стоит 5 кредитов.

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

![](https://help.asodesk.com/_astro/78008317e6e1.Cxc8O9O7_Z1JbweM.webp)

Если вы укажете `timestamp`, API предоставит данные за заданный вами период, и запрос будет стоить 15 кредитов.

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

![](https://help.asodesk.com/_astro/eedf78276ea8.zlTlvPjO_ZK5jd4.webp)

> [!TIP]
> По умолчанию время в ответах на запросы указывается по UTC, если в запросе не указан другой часовой пояс.

## Keyword Suggestions

Запрос возвращает поисковые подсказки сторов по ключевому слову. Требует 5 кредитов API без указания дополнительных параметров.

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

![](https://help.asodesk.com/_astro/9cd03da3cc48.DkFUparp_2j2nJd.webp)

**С дополнительным параметром** `with_stats=true`, ответ будет содержать данные о каждой подсказке по ключевому слову (популярность, топ-5 приложений и Daily Impressions).

Дополнительные кредиты будут списываться за каждое ключевое слово в результатах в соответствии со стоимостью запроса [Keyword stats](https://api.asodesk.com/static/docs/html/modules/chargeable/keyworddata/keyword_stats.html) (10 кредитов за ключевое слово).

Например, ответ содержит 10 ключевых слов и будет стоить 5 + 10 \* 10 = 105 кредитов.

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

![](https://help.asodesk.com/_astro/f12edbf550a1.67zBwZHT_hI7KF.webp)

**С дополнительным параметром** `with_top5_meta=true` (работает, только если указан параметр `with_stats=true`), Ответ будет содержать ID приложения, логотип, название, имя разработчика, рейтинг и цену каждого приложения, которое попало в список `top5_apps list`.

Дополнительные кредиты будут списываться за каждое приложение из списка `top5_apps list` в соответствии со стоимостью запроса [App meta](https://api.asodesk.com/static/docs/html/modules/chargeable/appdata/app_meta.html) (1 кредит).

Например, ответ включает 10 ключевых слов с топ-5 приложениями для каждого ключевого слова и будет стоить 5 + 10 \* 10 + 5 \* 10 = 155 кредитов.

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

![](https://help.asodesk.com/_astro/31b52ea961e6.Co04h_Fm_Z2v21ne.webp)

## Keyword Auto-Suggestions

По умолчанию запрос возвращает 100 самых популярных ключевых слов для 1 приложения, 1 страны и 1 магазина, отсортированных по Daily Impressions. Он использует 300 кредитов API без дополнительных параметров.

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

![](https://help.asodesk.com/_astro/9be7b317517e.BVaIihuT_wO0vc.webp)

**С дополнительным параметром** `with_stats=true`, ответ будет содержать данные о каждой подсказке по ключевому слову (популярность, топ-5 приложений и Daily Impressions).

Дополнительные кредиты будут списываться за каждое ключевое слово в результатах в соответствии со стоимостью запроса [Keyword stats](https://api.asodesk.com/static/docs/html/modules/chargeable/keyworddata/keyword_stats.html) (10 кредитов за ключевое слово).

Например, ответ содержит 100 ключевых слов и будет стоить 300 + 100 \* 10 = 1300 кредитов.

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

![](https://help.asodesk.com/_astro/d6f2eef9fe3b.CqQiiQoq_cIWiK.webp)

**С дополнительным параметром** `with_top5_meta=true` (работает, только если указан параметр `with_stats=true`), Ответ будет содержать ID приложения, логотип, название, имя разработчика, рейтинг и цену каждого приложения, которое попало в список `top5_apps list`.

Дополнительные кредиты будут списываться за каждое приложение из списка `top5_apps list` в соответствии со стоимостью запроса [App meta](https://api.asodesk.com/static/docs/html/modules/chargeable/appdata/app_meta.html) (1 кредит).

Например, ответ включает 100 ключевых слов с топ-5 приложениями для каждого ключевого слова и будет стоить 300 + 100 \* 10 + 5 \* 100 = 1800 кредитов.

`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/_astro/b53ecaee50bc.B-3iHquY_Z1gpfAJ.webp)

---

Хотите знать о наших продуктах и услугах больше или задать вопрос? Будем рады помочь!

Нажмите на значок поддержки в правом нижнем углу или напишите на [hello@asodesk.com](mailto:hello@asodesk.com)
