Data

The /data routes return the reference data that other routes point to: categories, countries, languages, currencies, stores and SDKs. You don’t need a scope to use them.

Listing Supported Store Categories

Request

GET /data/categories

Example Response

// GET /data/categories

{
  "12": {
    "id": 12,
    "store": "apple",
    "device": "desktop",
    "subcategories": [
      "free",
      "paid",
      "topgrossing"
    ],
    "parent_id": null,
    "name": "Top Overall"
  },
  "102": {
    "id": 102,
    "store": "google_play",
    "device": "handheld",
    "subcategories": [
      "free",
      "paid",
      "topgrossing"
    ],
    "parent_id": null,
    "name": "Games"
  },
  "42": {
    "id": 42,
    "store": "google_play",
    "device": "handheld",
    "subcategories": [
      "free",
      "paid",
      "topgrossing"
    ],
    "parent_id": 102,
    "name": "Games/Arcade"
  },
 . . .
}

Listing All Supported Countries

Request

GET /data/countries

Example Response

// GET /data/countries

{
  "AD": {
    "iso": "AD",
    "name": "Andorra",
    "apple_store_no": ""
  },
  "AE": {
    "iso": "AE",
    "name": "UAE",
    "apple_store_no": "143481"
  },
  "AF": {
    "iso": "AF",
    "name": "Afghanistan",
    "apple_store_no": ""
  },
  . . .
}

Listing Countries Supported by Apple

Request

GET /data/countries/apple

Example Response

// GET /data/countries/apple

{
  "AE": {
    "iso": "AE",
    "name": "UAE",
    "apple_store_no": "143481"
  },
  "AG": {
    "iso": "AG",
    "name": "Antigua And Barbuda",
    "apple_store_no": "143540"
  },
  "AI": {
    "iso": "AI",
    "name": "Anguilla",
    "apple_store_no": "143538"
  },
  . . .
}

Listing Supported Languages for Review Translation

Request

GET /data/languages

Example Response

// GET /data/languages

{
  "gb": {
    "name": "English",
    "code": "en",
    "iso": "GB"
  },
  "us": {
    "name": "Bad English",
    "code": "bad-en",
    "iso": "US"
  },
  "es": {
    "name": "Spanish",
    "code": "es",
    "iso": "ES"
  },
  ...
}

Listing Supported Currencies

Request

GET /data/currencies

Example Response

This route returns an array, not an object.

// GET /data/currencies

[
      {
          "Currency": "AUD",
          "Symbol": "$"
      },
      {
          "Currency": "USD",
          "Symbol": "$"
      },
      ...
]

Listing Supported Stores

Request

GET /data/stores

Example Response

// GET /data/stores

{
  "apple": {
    "id": "apple",
    "code": 1,
    "name": "iTunes Connect",
    "short_name": "Apple",
    "type": "appstore",
    "supported_features": [
      "sales",
      "ads",
      "reviews",
      "reviews_count",
      "ranks",
      "featured"
    ],
    "storefronts": [
      {
        "id": "apple:ios",
        "name": "App Store",
        "short_name": "iOS",
        "type": "appstore"
      },
      {
        "id": "apple:mac",
        "name": "Mac Store",
        "short_name": "Mac",
        "type": "appstore"
      },
      ...
    ],
    "countries": [
      {
        "iso": "AE",
        "name": "UAE",
        "apple_store_no": "143481"
      },
      ...
    ]
  }
}

Listing Supported SDKs

Request

GET /data/sdks

Example Response

// GET /data/sdks

[
  {
    "id": "adcolony",
    "code": 1,
    "name": "AdColony",
    "tags": ["ads"],
    "active": true,
    "release_date": null,
    "started_tracking": "2016-08-02T18:35:36",
    "description": "Elevating mobile advertising by focusing on the highest quality consumer experiences that deliver outcomes for brands and publishers on today's primetime apps and sites.",
    "notes": null,
    "tracked_platforms": ["google_play","apple:ios"],
    "external_links": [{
      "type": "twitter",
      "value": "adcolony"
    }, {
      "type": "homepage",
      "value": "http://adcolony.com"
    }, {
      "type": "source_homepage",
      "value": "https://github.com/AdColony/AdColony-Android-SDK"
    }],
    "developer": {
      "name": "Opera Mediaworks",
      "links": []
    }
  },
  ...
]