App Bid History

GET 100 Credits / Request /ios/applications/{APPLICATION_ID}/keywords/bid-history.json

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

App Bid History Request

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

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

The two letter country code (ISO Alpha-2) you want to fetch the application in.

Get the list of our country codes, here.

language: string en

The two letter language (ISO Alpha-2) you want to fetch the application in.

Get the list of our language codes, here.

GET /ios/applications/{APPLICATION_ID}/keywords/bid-history.json

Request example
GET /ios/applications/1453989822/keywords/bid-history.json?country=us&language=us
cURL example
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" "https://api.apptweak.com/ios/applications/1453989822/keywords/bid-history.json?country=us&language=us"

App Bid History Response

The response is a JSON object. An array of keywords we found that the given application had an ad running over the last year and the number of bids found for each

Object properties
word: string

The keyword.

count: number

the number of bids found for the related keyword.

Response Example

{
  "content": {
    "keywords": [
      {
        "word": "\"a\"",
        "count": 4
      },
      {
        "word": "\"lol\"",
        "count": 13
      },
      {
        "word": "#best",
        "count": 4
      },
      {
        "word": "$0",
        "count": 5
      },
      {
        "word": "$1",
        "count": 1
      },
      {
        "word": "'best'",
        "count": 2
      },
      {
        "word": "'center'",
        "count": 13
      },
      {
        "word": "'friend'",
        "count": 2
      },
      {
        "word": "'fun'",
        "count": 7
      },
      {
        "word": "'games for'",
        "count": 2
      },
      {
        "word": "'the best'",
        "count": 4
      },
      {
        "word": "'the game'",
        "count": 3
      },
      {
        "word": "++ best",
        "count": 1
      },
      {
        "word": "-best jumping",
        "count": 1
      },
      {
        "word": "-car",
        "count": 3
      },
      {
        "word": "-hd",
        "count": 2
      },
      {
        "word": ".io",
        "count": 20
      },
      {
        "word": ".io game",
        "count": 1
      },
      {
        "word": ".io games",
        "count": 1
      },
      {
        "word": ".iogames",
        "count": 3
      },
      {
        "word": "0 12",
        "count": 1
      },
      {
        "word": "000 stars",
        "count": 1
      },
      {
        "word": "1 racing",
        "count": 5
      },
      {
        "word": "1 v 4",
        "count": 3
      },
      {
        "word": "1/st bet - horse race betting",
        "count": 1
      },
      {
        "word": "10 gallon aquarium",
        "count": 2
      },
      {
        "word": "10 s",
        "count": 1
      },
      {
        "word": "10 year old games for girls",
        "count": 1
      },
      {
        "word": "100 free",
        "count": 1
      },
      {
        "word": "100 ways to die",
        "count": 2
      },
      {
        "word": "1000 ways to die",
        "count": 1
      }
    ]
  },
  "metadata": {
    "request": {
      "path": "/ios/applications/1453989822/keywords/bid-history.json",
      "store": "ios",
      "params": {
        "country": "us",
        "language": "us",
        "id": "1453989822",
        "format": "json"
      },
      "performed_at": "2020-08-07 12:38:43 UTC"
    },
    "content": {
    }
  }
}