Sign in

v1

latestOpenAPI 3.1.02026-07-24450694.7 KB

App Paid Keywords

Get an app's all time paid keywords, and the number of bids found for each.

get/apps/keywords/bids.json

Query parameters

appsstring required

Comma separated list of app IDs. Max 5 apps are allowed. <br/> <a href="https://developers.apptweak.com/reference/how-to-find-app-ids" target="_blank">How to find App IDs?</a>

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

start_datestring

Start date of the period in format YYYY-MM-DD<br/><b>Default:</b> 30 days ago

end_datestring

End date of the period in format YYYY-MM-DD<br/><b>Default:</b> yesterday

aggregatedboolean

Aggregated count of ads grouped per keywords on the date-range <br/><b>Default:</b> False

Response

200

OR

Example response

{
  "result": {
    "585629514": {
      "bids": [
        {
          "date": "2022-11-24",
          "keyword": "linge de maison la redoute intérieurs"
        }
      ]
    }
  },
  "metadata": {
    "request": {
      "path": "/api/public/store/apps/keywords/bids.json",
      "params": {
        "device": "iphone",
        "country": "fr",
        "language": "fr",
        "start_date": "2022-11-24",
        "end_date": "2022-11-24",
        "apps": [
          "585629514"
        ]
      },
      "cost": 1001,
      "max_credit_cost": 1001,
      "status": 200
    }
  }
}