Search Ads Recommendation

GET 30 Credits / Request /ios/applications/{APPLICATION_ID}/keywords/recommended.json

Search Ads Recommendation are the recommendations Apple suggests in the Search Ads Campaign dashboard for the given app.

Search Ads Recommendation Request

This method returns the Apple Search Ads’ recommendations for the given app.

Header parameters
Your AppTweak API Key.
Query parameters
country: string us

The two letter country code (ISO Alpha-2) you want to fetch the app in. Passing a non-search ads country will result in a bad request.

Get the list of our country codes, here and the Apple Search ads countries.

term: string

A term to use as base for the recommendations. Without a term, Apple will recommend keywords considered related for your app. With a term, it will use that term as a base for the recommendations.

GET /ios/applications/{APPLICATION_ID}/keywords/recommended.json

Request example
GET /ios/applications/553834731/keywords/recommended.json?country=mx&term=nachos
cURL example
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" ""

Search Ads Recommendation Response

The response is a JSON object. The response will be an array of objects. Each object will contain a keyword and the associated volume for that keyword.

Object properties
keyword: string

The recommended keyword

volume: float [0..100]

A score between 0 and 100 indicating how popular the keyword is. Popular keywords are more likely to be searched on the App Store and tend to generate more downloads. It is therefore more interesting to be well ranked keywords with a high volume.

Response Example

  "content": [
      "volume": 49,
      "keyword": "pinterest gratis"
  "metadata": {
    "request": {
      "path": "/ios/applications/553834731/keywords/recommended.json",
      "store": "ios",
      "params": {
        "country": "mx",
        "language": "en",
        "device": "iphone",
        "id": "553834731",
        "format": "json"
      "performed_at": "2020-06-30 10:51:07 UTC"
    "content": {