The Keyword Search endpoint returns the stores' search results (in the form of list of apps) for a given keyword. To perform live searches on the store you can use Keyword Live Search - Current. You can also access historical results using Keyword Live Search - History.

If you're interested in live searches with ads, use Keyword Live Search With Ads.

Keyword Live Search - Current

This endpoint enables you to run a live keyword search exactly as it would be on your phone on the App Store or Google Play. It returns the organic results.

1604 — Search for the keyword "auto" in the German App Store. On the left are the results on the phone. On the right, the same results that you would get through the API.

You can refer to the following table for the max number of results for both stores:

Current	iOS	Android
App results	Max 250	Max 250

Keyword Live Search With Ads - Current

This endpoint enables to fetch the app results for a live keyword search and includes the potential ads in the search.

Currently, only iOS ads are supported.

Keyword Live Search - History

You can also get historical results of keywords searches. Bear in mind that this will only return results if the keyword is tracked by AppTweak. To make sure it is, we recommend following the keyword in your AppTweak ASO account.

You can refer to the following table for the max number of results for both stores:

History	iOS	Android
App results	Max 500	Max 250

📘
I don't have 500 results for a keyword search, is it normal?
Yes, that can happen because the store has only fewer results than that.

📘
Can I use "Keyword Live Search - History" with today's date?
Yes, you can also use it with today's date. If the keyword is not tracked by AppTweak or if the AppTweak hasn't fetched the results yet for today, we will perform a live search and maximum 250 app results will be returned.