Operating System Service

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

View all operating systems:
GET https://api.appnexus.com/operating-system

Search for operating systems with IDs or names containing certain characters:
GET https://api.appnexus.com/operating-system?search=SEARCH_TERM

View a specific operating system:
GET https://api.appnexus.com/operating-system?id=OPERATING_SYSTEM_ID

Find out which fields you can filter and sort by:
GET https://api.appnexus.com/operating-system/meta

JSON Fields

Field

Type

Description

id

int

The ID of the operating system.

name

string

The name of the operating system version.

platform_type

enum

The type of platform on which the operating system version runs. Possible values: "web", "mobile", or "both".

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 service to get information about operating system families.

last_modified

string

The date and time the operating system version entry was last modified.

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.

Examples

View all operating systems
{code}$ 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": {
      "instance": "29.bm-hbapi.prod.nym1",
      "slave_hit": true,
      "db": "141.bm-mysql.prod.nym1",
      "awesomesauce_cache_used": false,
      "count_cache_used": false,
      "warnings": [

      ],
      "time": 63.158988952637,
      "start_microtime": 1371584405.4796,
      "version": "1.13.43",
      "slave_lag": 0,
      "member_last_modified_age": 1371584405
    }
  }
}

{code}
View a specific operating system
{code}$ 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"
        }
    }
}

{code}