Metadata

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

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.

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
X-AppTweak-Key:
Your AppTweak API Key.
Path parameters
APPLICATION_ID:
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.

device: string iphone

The device you want to fetch the application for.

iphone or ipad

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 /ios/applications/{APPLICATION_ID}/metadata.json

Request example
GET /ios/applications/454638411/metadata.json?country=gb&language=en&device=iphone&max-age=86400
cURL example
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"

Metadata Response

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.

Object properties
id: number

The ID that Apple has given to the application.

customers_also_bought: array

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.

description: string

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

developer: hash

Key/value pairs describing the developer.

device: array

The list of devices the app is available on. Can contain : ipad, ipod and iphone.

features: hash

Key/boolean pairs describing if the App is compatible with passbook and the game center and if it has in app purchases.

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 0 is used to refer to the global rankings across all categories combined.

icon: string

The URL of the icon as it appears on the App Store.

price: string

Price of the application as displayed in the App Store in the target country.

promotionalText: string

The Promotional Text should reflect the app’s new features, promotions or highlighted content.

rating: hash

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

release_date: datetime

The release date of the first version of the app on the App Store.

screenshots: hash

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.

size: hash

Key/value pairs describing the size of the app.

slug: string

URL friendly version of the app name.

subtitle: string

The subtitle explaining the purpose of the app (introduced in iOS 11).

title: string

The App name as it appears on the App 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: hash

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.

developer: hash

Key/value pairs describing the developer.

Response Example

{
  "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": {
    }
  }
}