Metadata allows you to fetch all the information that AppTweak has been able to gather about a specific app on the App 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.
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.
The two letter country code (ISO Alpha-2) you want to fetch the app in.
us. Get the list of our country codes, here.
The two letter language (ISO Alpha-2) you want to fetch the application in.
en. Get the list of our language codes, here.
The device you want to fetch the application for.
iphone or ipad
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 /ios/applications/454638411/metadata.json?country=gb&language=en&device=iphone&max-age=86400
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" "https://api.apptweak.com/ios/applications/454638411/metadata.json?country=gb&language=en&device=iphone&max-age=86400"The response to the 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.
The ID that Apple has given to the application.
A list of app ids that Apple advertises as alternatives for this app in the You May Also Like section on the application page view in App Store.
The app description as it appears on the App Store, in the chosen language.
Key/value pairs describing the developer.
The list of devices the app is available on. Can contain : ipad, ipod and iphone.
Key/boolean pairs describing if the App is compatible with passbook and the game center and if it has in app purchases.
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 0 is used to refer to the global rankings across all categories combined.
The URL of the icon as it appears on the App Store.
Price of the application as displayed in the App Store in the target country.
The Promotional Text should reflect the app’s new features, promotions or highlighted content.
Key/value pairs describing the average rating for the application.
The release date of the first version of the app on the App Store.
Key/value pairs describing the screenshot for each device. The keys are the device types recognized by apple: iphone, ipad, ipadPro, iphone5, iphone6, iphone6plus and appleWatch. The values are lists of screenshot entries. Each screenshot entry contains the screenshot id, a technical path_component and the complete screenshot url.
Key/value pairs describing the size of the app.
URL friendly version of the app name.
The subtitle explaining the purpose of the app (introduced in iOS 11).
The App name as it appears on the App Store, in the chosen language.
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.
Key/value pairs describing the videos for each device. The keys are the device types recognized by apple: iphone, ipad, ipadPro, iphone5, iphone6, iphone6plus and appleWatch. The values are lists of video entries.
Key/value pairs describing the developer.
{
"content": {
"versions": [
{
"version": "208.0",
"release_date": "2019-03-27 00:00:00 UTC",
"release_notes": "In this update, you can now see your friends' Messenger Stories right inside your chat thread, and they can see yours, too! Messenger wants you to build better, more meaningful conversations with your friends and family."
},
{
"version": "210.0",
"release_date": "2019-04-10 00:00:00 UTC",
"release_notes": "In this update, you can now see your friends' Messenger Stories right inside your chat thread, and they can see yours, too! Messenger wants you to build better, more meaningful conversations with your friends and family."
}
],
"icon": "https://is5-ssl.mzstatic.com/image/thumb/Purple123/v4/f2/e5/85/f2e58577-dcdd-0736-23a5-a80cb3b48e47/Icon-0-1x_U007emarketing-0-0-85-220-0-7.png/1024x1024bb.jpg",
"genres": [
6005,
6007
],
"title": "Messenger",
"slug": "messenger",
"description": "* SEND A MESSAGE -Skip exchanging phone numbers, just send a message. It's seamless across devices.\n* SHOW YOUR REACTION - Add a silly sticker, send a dancing GIF and use emojis to express yourself better.\n* SHARE PHOTOS AND VIDEOS - Capture the moment with the Messenger Camera, add a filter or doodle, then send to friends or share to Stories.\n* RALLY THE GROUP - Make plans to get together with polls, share your location, split the bill and more.\n* HOP ON A CALL OR VIDEO CHAT - Hang out anywhere, anytime by getting on call or a group video** chat — filters optional :) **Calls are free over Wi-Fi but otherwise standard data charges apply.\n* SEND A VOICE MESSAGE - When text just won't cut it, just hit record and send say, sing or shout it out loud.\n* SEND MONEY SECURELY AND EASILY (within US, UK and France only) - Send and receive money from friends in the app by adding your debit card or PayPal* account. *PayPal available in the US only.\n* SHARE YOUR LOCATION - Suggest a meeting spot or tell friends where you are by sharing your location with just a few taps.\n* CHAT WITH BUSINESSES - Easily connect with your favorite businesses to make reservations, get customer support, find deals and more.\n* PLAY GAMES WITH FRIENDS - Challenge friends, climb leaderboards, and discover your next gaming obsession.",
"features": {
"game_center": false,
"passbook": false,
"in_apps": false
},
"devices": [
"watch",
"iphone",
"ipad",
"ipod"
],
"price": "£0.00",
"screenshots": {
"iphone6": [
],
"iphone": [
],
"iphone6+": [
{
"id": "bd377d42-7724-a97a-2fca-6a7ea00d8204",
"path_component": "image/thumb/Purple113/v4",
"filename": "mzl.appetkeb.png/1242x2208bb.jpg",
"url": "https://is1-ssl.mzstatic.com/image/thumb/Purple113/v4/bd/37/7d/bd377d42-7724-a97a-2fca-6a7ea00d8204/mzl.appetkeb.png/1242x2208bb.jpg"
}
],
"iphone5": [
],
"ipad": [
],
"ipadPro": [
{
"id": "822708cc-58bc-1c89-fbc3-dac54b4147fa",
"path_component": "image/thumb/Purple123/v4",
"filename": "mzl.wsljetoy.png/2732x2048bb.jpg",
"url": "https://is1-ssl.mzstatic.com/image/thumb/Purple123/v4/82/27/08/822708cc-58bc-1c89-fbc3-dac54b4147fa/mzl.wsljetoy.png/2732x2048bb.jpg"
}
],
"iphone6plus": [
],
"appleWatch": [
]
},
"videos": {
},
"release_date": "2011-10-19 00:00:00 UTC",
"size": 126012416,
"subtitle": "Text and Video Chat",
"promotionalText": "Be together whenever with a simple way to text, video chat and rally the group.",
"rating": {
"average": 4.3
},
"customers_also_bought": [
"1165924249",
"579523206",
"400169658",
"310633997",
"336435697",
"304878510",
"362057947",
"514485964",
"539124565",
"1156192844",
"690046600",
"583274826",
"429047995",
"1271681086"
],
"id": 454638411,
"developer": {
"name": "Facebook, Inc.",
"id": 284882218
}
},
"metadata": {
"request": {
"path": "/applications/454638411/metadata.json",
"store": "ios",
"params": {
"country": "gb",
"language": "en",
"device": "iphone",
"max-age": 86400,
"id": "454638411",
"format": "json"
},
"performed_at": "2019-05-07 10:06:54 UTC"
},
"content": {
}
}
}