Расчет Стоимости 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

Когда вы задаете свой диапазон дат с помощью параметров 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

 

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

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

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

 

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

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

Keyword Suggestions

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

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

 

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

Дополнительные кредиты будут списываться за каждое ключевое слово в результатах в соответствии со стоимостью запроса Keyword stats (10 кредитов за ключевое слово).

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

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

 

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

Дополнительные кредиты будут списываться за каждое приложение из списка top5_apps list в соответствии со стоимостью запроса App meta (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

 

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

 

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

Дополнительные кредиты будут списываться за каждое ключевое слово в результатах в соответствии со стоимостью запроса Keyword stats (10 кредитов за ключевое слово).

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

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

 

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

Дополнительные кредиты будут списываться за каждое приложение из списка top5_apps list в соответствии со стоимостью запроса App meta (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

     

---