Application Metadata

GET 1 Credits / Request /android/applications/{APPLICATION_ID}/metadata.json

Application Metadata allows you to fetch all the information that AppTweak has been able to gather about a specific app on the Google Play Store.

Please note that the example has been stripped of redundant data to keep the documentation as concise as possible. The API might return additional, undocumented fields in the JSON, which your App should not rely upon.

Application Metadata Request

In AppTweak, you always fetch an app, in a specific country, in a specific language, on a specific device. We reply with all the information we have for this app.

Header parameters
Your AppTweak API Key.
Path parameters
Application ID for which you want to get the metadata.
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.

max-age: number 94608000

Maximum age of the metadata, expressed in seconds. Lower max-age will give fresher results, but will slow down the request as we have a higher chance of having to refresh the data.

604800 seconds (one week)

GET /android/applications/{APPLICATION_ID}/metadata.json

Request example
GET /android/applications/com.espn.score_center/metadata.json?country=gb&language=en&max-age=86400
cURL example
curl -X GET -H "X-Apptweak-Key: ${API_KEY}"

Application Metadata Response

The response to the application metadata request is a deep JSON hash containing all necessary data to get an overview of the application state on the App Store in the last 30 days.

Object properties
content_rating: string

The ratings are intended to help consumers, especially parents, identify potentially objectionable content that exists within an app. App ratings are not meant to reflect the intended audience.

description: string

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

feature_graphic: string

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

genres: array

The list of category the app is listed on. See the supported categories list to match the category_id to it's human friendly name. The special category_id ALL is used to refer to the global rankings across all categories combined.

icon: string

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

price: string

The price of the app as displayed on the Google Play Store.

permissions: array

The list of permissions the app may try to access. Notably, the presence of the permission android.permission.BILLING indicates the presence of in-app purchases.

rating: hash

Key/value pairs describing the average rating for the application.

screenshots: array

List of application screenshot urls.

short_description: string

The short description explaining the purpose of the app.

size: hash

Key/value pairs describing the size of the app.

slug: string

URL friendly version of the app name.

title: string

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

versions: array

A list of version hash. Each version hash specifies the version number, the date on when it was released and the release notes in the chosen language.

videos: array

List of application videos urls.

Response Example

  "content": {
    "versions": [
        "version": "6.3.1",
        "release_notes": "- Want quicker access to ESPN+? Now you can set your default tab so it's the first thing you see when you open the app.
- Can’t get enough of the NBA? New support for G League scores, news, standings, and live streams.
- Resolved issues with live radio and podcast streams stopping intermittently.", "release_date": "2018-11-12 00:00:00 +0000" }, { "version": "5.3", "release_notes": "", "release_date": "2016-09-23 00:00:00 +0000" } ], "icon": "", "genres": [ "SPORTS", "SPORTS", "", "" ], "title": "ESPN", "description": "Stream live games, check the latest scores or watch the best highlights with the best brand in sports: ESPN. Pick your favorite teams and leagues to get started.

Highlights and scores from what you care about. Your feed will dynamically change based on what you need to know. From news about your favorite sports or favorite team playing right now, the home tab has you covered.

Fast access to scores for your favorite teams and leagues. We curate the top games of the day so you can keep up on the NBA playoffs or the MLB's latest rivalries. Want more scores from a particular team or league? Just add it as a favorite!

Stream events on ESPN networks, including MLB, NFL, College Football, NBA, College Basketball games and more. Watch on-demand shows like Get Up! or First Take. Log in with your TV Provider to get started! You can also subscribe to ESPN+ for even more content [...]", "price": "", "screenshots": [ "" ], "permissions": [ "android.permission.ACCESS_COARSE_LOCATION", "android.permission.ACCESS_NETWORK_STATE", "android.permission.ACCESS_WIFI_STATE", "android.permission.INTERNET", "android.permission.READ_EXTERNAL_STORAGE", "android.permission.READ_PHONE_STATE", "android.permission.RECEIVE_BOOT_COMPLETED", "android.permission.USE_FINGERPRINT", "android.permission.VIBRATE", "android.permission.WAKE_LOCK", "android.permission.WRITE_EXTERNAL_STORAGE", "", "com.espn.score_center.permission.C2D_MESSAGE", "", "" ], "videos": [ ], "short_description": "Get scores, news, alerts & watch live sports", "size": { "current": { "data": 23313714 } }, "feature_graphic": "", "content_rating": "Everyone 10+", "slug": "espn" }, "metadata": { "request": { "path": "/applications/com.espn.score_center/information.json", "store": "android", "params": { "country": "us", "language": "us", "max-age": 946000, "id": "com.espn.score_center", "format": "json" }, "performed_at": "2018-11-20 22:41:46 UTC" }, "content": { } } }