Live Search (Google Play Store)

GET 3 Credits / Request /android/applications/searches.json

Live Search allow you to query the Google Play Store for a term and get the ordered list of applications that would appear on a user device when he types that specific term on the Play Store search box. The first application is the one that would appear on top of the user result page. Additionaly the total number of applications responding to the search term.

Live Search Request

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 app in.

us. 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.

en. Get the list of our language codes, here.

term: string Required

Term to search for.

For instance: bug

num: string 10

Number of items you want to fetch

GET /android/applications/searches.json

Request example
GET /android/searches.json?country=de&language=de&term=angebote&num=10
cURL example
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" "https://api.apptweak.com/android/searches.json?country=de&language=de&term=angebote&num=10"

Live Search Response

The response for the Live Search request is a JSON hash containing a list of applications matching the given term in the selected country on the Google Play Store.

Object properties
id: number

The ID that Google has given to the application.

developer: string

Developer's name.

icon: string

The URL of the icon as it appears on the Google Play Store.

price: string

Price of the application as displayed in the Google Play Store in the target country.

rating: string

Value describing the average rating for the application.

title: string

The App name as it appears on the App Store, in the chosen language.

Response Example

{
  "content": [
    {
      "id": "com.marktguru.mg2.de",
      "title": "marktguru Prospekte & Angebote",
      "developer": "marktguru Deutschland GmbH",
      "price": "",
      "icon": "https://lh3.googleusercontent.com/tLsbsMZ5X1cGSS08iWvXfspRW0JFWPdBTNLTGntsLpQ0Z5a19c4OetEDSlOB9uP1Qw",
      "rating": 4.4424614906311035
    },
    {
      "id": "com.tippingcanoe.mydealz",
      "title": "mydealz – Gutscheine, Schnäppchen, Angebote, Sale",
      "developer": "Pepper",
      "price": "",
      "icon": "https://lh3.googleusercontent.com/qZOvwtFn_B-W7gXK5p2H7BGXmL3C6SJf3C6mW-gayYfC3nAelVMBeYRd7V5GLlbgmiLx",
      "rating": 4.5113677978515625
    }
  ],
  "metadata": {
    "request": {
      "path": "/searches.json",
      "store": "android",
      "params": {
        "country": "de",
        "language": "de",
        "term": "angebote",
        "num": 2,
        "format": "json"
      },
      "performed_at": "2018-11-27 01:42:52 UTC"
    },
    "content": {
    }
  }
}