Sign in

v1

latestOpenAPI 3.1.02026-07-24450694.7 KB

Keyword Live Search With Ads - Current

Returns the app results (including ads) of a live search on the store for a given keyword.

get/keywords/search-results/ads/current

Query parameters

keywordstring required

The keyword to search for. Only <b>one</b> keyword is allowed.

countrystring

Two letter <a href="https://apptweak.readme.io/reference/country-codes">country code</a>. <br/><b>Default:</b> us

languagestring

Two letter <a href="https://developers.apptweak.com/reference/languages" target="_blank">language code</a>. <br/><b>Default:</b> AppTweak <a href="https://developers.apptweak.com/reference/languages-overview#default-language" target="_blank">default language</a> of the country.

device'iphone' | 'ipad' | 'android'

Choose a device from iphone, ipad or android. <br/><b>Default:</b> iphone

Response

200

OR

Example response

{
  "result": [
    {
      "application_id": "1668983788",
      "is_ad": true
    }
  ],
  "metadata": {
    "request": {
      "path": "/api/public/store/keywords/search-results/ads/current",
      "params": {
        "device": "iphone",
        "country": "us",
        "language": "us",
        "keyword": "clash"
      },
      "cost": 51,
      "max_credit_cost": 51,
      "status": 200
    }
  }
}