Digital Platform API - Operating System service

  • Article

Note

To retrieve operating system versions (Android 3.x, Apple iOS 6, etc.), you should use the Operating System Extended Service instead of this service. To retrieve operating systems as a whole (Android, Windows, Linux, etc.), you should use the Operating System Family Service.

REST API

HTTP Method Endpoint Example
GET https://api.appnexus.com/operating-system View all operating systems.
GET https://api.appnexus.com/operating-system?search=SEARCH_TERM Search for operating systems with IDs or names containing certain characters.
GET https://api.appnexus.com/operating-system?id=OPERATING_SYSTEM_ID View a specific operating system.
GET https://api.appnexus.com/operating-system/meta Find out which fields you can filter and sort by.

JSON fields

Field Type Description
id int The ID of the operating system.
last_modified string The date and time the operating system version entry was last modified.
name string The name of the operating system version.
os_family_id int The ID of the operating system family to which the operating system version belongs. You can use the Operating System Family Service to get information about operating system families.
os_family_name string The name of the operating system family to which the operating system version belongs, e.g., "Android", "Apple iOS", "Apple Mac/OSX", etc.
platform_type enum The type of platform on which the operating system version runs. Possible values:
- "web"
- "mobile"
- "both"

Examples

View all operating systems

$ curl -b cookies -c cookies 'https://api.appnexus.com/operating-system'
{
  "response": {
    "status": "OK",
    "count": 15,
    "start_element": 0,
    "num_elements": 100,
    "operating-systems": [
      {
        "id": 0,
        "name": "Unknown",
        "platform_type": "web",
        "os_family_id": null,
        "last_modified": "2012-11-28 16:25:01",
        "os_family_name": null
      },
      {
        "id": 1,
        "name": "Windows 7",
        "platform_type": "web",
        "os_family_id": null,
        "last_modified": "2012-11-28 16:25:01",
        "os_family_name": null
      },
      {
        "id": 2,
        "name": "Windows Vista",
        "platform_type": "web",
        "os_family_id": null,
        "last_modified": "2012-11-28 16:25:01",
        "os_family_name": null
      },
      {
        "id": 3,
        "name": "Windows XP",
        "platform_type": "web",
        "os_family_id": null,
        "last_modified": "2012-11-28 16:25:01",
        "os_family_name": null
      },
      {
        "id": 4,
        "name": "Windows 2000",
        "platform_type": "web",
        "os_family_id": null,
        "last_modified": "2012-11-28 16:25:01",
        "os_family_name": null
      },
      {
        "id": 5,
        "name": "Windows (other versions)",
        "platform_type": "web",
        "os_family_id": null,
        "last_modified": "2012-11-28 16:25:01",
        "os_family_name": null
      },
      {
        "id": 6,
        "name": "Android",
        "platform_type": "mobile",
        "os_family_id": null,
        "last_modified": "2012-11-28 16:25:01",
        "os_family_name": null
      },
      {
        "id": 7,
        "name": "Linux",
        "platform_type": "web",
        "os_family_id": null,
        "last_modified": "2012-11-28 16:25:01",
        "os_family_name": null
      },
      {
        "id": 8,
        "name": "iPhone",
        "platform_type": "mobile",
        "os_family_id": null,
        "last_modified": "2012-11-28 16:25:01",
        "os_family_name": null
      },
      {
        "id": 9,
        "name": "iPod",
        "platform_type": "mobile",
        "os_family_id": null,
        "last_modified": "2012-11-28 16:25:01",
        "os_family_name": null
      },
      {
        "id": 10,
        "name": "iPad",
        "platform_type": "mobile",
        "os_family_id": null,
        "last_modified": "2012-11-28 16:25:01",
        "os_family_name": null
      },
      {
        "id": 11,
        "name": "Mac",
        "platform_type": "web",
        "os_family_id": null,
        "last_modified": "2012-11-28 16:25:01",
        "os_family_name": null
      },
      {
        "id": 12,
        "name": "Blackberry",
        "platform_type": "mobile",
        "os_family_id": null,
        "last_modified": "2012-11-28 16:25:01",
        "os_family_name": null
      },
      {
        "id": 13,
        "name": "Windows Phone 7",
        "platform_type": "mobile",
        "os_family_id": null,
        "last_modified": "2012-11-28 16:25:01",
        "os_family_name": null
      },
      {
        "id": 14,
        "name": "Windows 8",
        "platform_type": "web",
        "os_family_id": null,
        "last_modified": "2012-11-28 16:25:01",
        "os_family_name": null
      }
    ],
    "dbg_info": {
      ...
    }
  }
}

View a specific operating system

$ curl -b cookies -c cookies 'https://api.appnexus.com/operating-system?id=8'
{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": 0,
        "num_elements": 100,
        "operating-system": {
            "id": 8,
            "name": "iPhone - iOS (other versions)",
            "platform_type": "mobile",
            "os_family_id": 3,
            "last_modified": "2013-02-21 21:37:12",
            "os_family_name": "Apple iOS"
        }
    }
}