Zype Analytics API (V2)

Legacy V2 analytics surface — stream hours, player requests, engagement, site counts, consumers, subscriptions, subscription events, subscription revenue and transactions. 9 operations. Superseded by Analytics V3 with no published deprecation notice or sunset date. No dedicated reference category is published for V2 on docs.zype.com — the spec is still served from the ReadMe API registry but its docs pages have been removed, which is the clearest deprecation signal Zype gives.

Operations 9

GET /v2/stream_hours List Stream Hours (V2) #
GET /v2/player_requests List Player Requests #
GET /v2/engagement List Engagement Data #
GET /v2/site_counts List Site Counts Data #
GET /v2/consumers List Consumers #
GET /v2/subscriptions List New Subscriptions #
GET /v2/subscription_events List Subscription Events #
GET /v2/subscription_revenue List Subscription Revenue #
GET /v2/transactons List New Transactions #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/analytics"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

zype-analytics.json Raw ↑
{
  "openapi": "3.0.1",
  "info": {
    "title": "Analytics (V2)",
    "version": "1.0.0",
    "description": ""
  },
  "servers": [
    {
      "url": "https://analytics.zype.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "api_key": {
        "type": "apiKey",
        "name": "api_key",
        "in": "query"
      },
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "OAuth access token",
        "description": "OAuth access token of the consumer"
      }
    }
  },
  "security": [
    {
      "api_key": []
    }
  ],
  "paths": {
    "/v2/stream_hours": {
      "get": {
        "x-server-name": "analytics-api",
        "summary": "List Stream Hours (V2)",
        "description": "This endpoint will retrieve stream hour data for your property.",
        "tags": [
          "Stream Hours"
        ],
        "operationId": "streamHours",
        "parameters": [
          {
            "name": "filters[start_date_gt]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records created after the specified `start_date`.(filters[start_date_gte]=2018-11-01) If no `start_date` is specified, then data returned will date back two weeks ago."
          },
          {
            "name": "filters[start_date_gte]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records created on or after the specified `start_date`."
          },
          {
            "name": "filters[start_date_lt]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records created before the specified `start_date`."
          },
          {
            "name": "filters[start_date_lte]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records created on or before the specified `start_date`."
          },
          {
            "name": "filters[start_date_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records created on the specified `start_date`. Comparison is date and time specific. If no time values are submitted, 00:00:00 UTC is assumed."
          },
          {
            "name": "filters[device_name_eq]",
            "in": "query",
            "schema": {
              "type": "string",
              "nullable": true,
              "enum": [
                null,
                "Roku",
                "Chromecast",
                "Desktop",
                "iOS (Native)",
                "iOS (HTML5)",
                "Apple TV",
                "Windows Phone (HTML5)",
                "Xbox (HTML5)",
                "Android (Native)",
                "FireTV",
                "Xbox",
                "BlackBerry (HTML5)",
                "Android (HTML5)",
                "Metrological",
                "OperaTV",
                "Xumo",
                "SmartTV"
              ]
            },
            "description": "Filter by device name.  Device names are case sensitive - current options include `Roku`, `Chromecast`, `Desktop`, `iOS (Native)`, `iOS (HTML5)`, `Apple TV`, `Windows Phone (HTML5)`, `Xbox (HTML5)`, `Android (Native)`, `FireTV`, `Xbox`, `BlackBerry (HTML5)`, `Android (HTML5)`, `Metrological`, `OperaTV`, `Xumo`, `SmartTV`"
          },
          {
            "name": "filters[video_id_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter by the video ID."
          },
          {
            "name": "filters[stream_type_eq]",
            "in": "query",
            "schema": {
              "type": "string",
              "nullable": true,
              "enum": [
                null,
                "vod",
                "live",
                "download"
              ]
            },
            "description": "Filter by the type of stream. Options are `vod`, `live`, and `download`."
          },
          {
            "name": "filters[consumer_id_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter by the consumer ID."
          },
          {
            "name": "filters[consumer_email_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter by a specific consumer's email. (Example: filters[consumer_email_eq]=consumer@zype.com)"
          },
          {
            "name": "filters[monetized_option_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter by the type of monetization of the videos. Options are `free`, `paid` and `avod`."
          },
          {
            "name": "filters[country_eq]",
            "in": "query",
            "schema": {
              "type": "string",
              "nullable": true,
              "enum": [
                null,
                "AD",
                "AE",
                "AF",
                "AG",
                "AI",
                "AL",
                "AM",
                "AO",
                "AQ",
                "AR",
                "AS",
                "AT",
                "AU",
                "AW",
                "AX",
                "AZ",
                "BA",
                "BB",
                "BD",
                "BE",
                "BF",
                "BG",
                "BH",
                "BI",
                "BJ",
                "BL",
                "BM",
                "BN",
                "BO",
                "BQ",
                "BR",
                "BS",
                "BT",
                "BV",
                "BW",
                "BY",
                "BZ",
                "CA",
                "CC",
                "CD",
                "CF",
                "CG",
                "CH",
                "CI",
                "CK",
                "CL",
                "CM",
                "CN",
                "CO",
                "CR",
                "CU",
                "CV",
                "CW",
                "CX",
                "CY",
                "CZ",
                "DE",
                "DJ",
                "DK",
                "DM",
                "DO",
                "DZ",
                "EC",
                "EE",
                "EG",
                "EH",
                "ER",
                "ES",
                "ET",
                "FI",
                "FJ",
                "FK",
                "FM",
                "FO",
                "FR",
                "GA",
                "GB",
                "GD",
                "GE",
                "GF",
                "GG",
                "GH",
                "GI",
                "GL",
                "GM",
                "GN",
                "GP",
                "GQ",
                "GR",
                "GS",
                "GT",
                "GU",
                "GW",
                "GY",
                "HK",
                "HM",
                "HN",
                "HR",
                "HT",
                "HU",
                "ID",
                "IE",
                "IL",
                "IM",
                "IN",
                "IO",
                "IQ",
                "IR",
                "IS",
                "IT",
                "JE",
                "JM",
                "JO",
                "JP",
                "KE",
                "KG",
                "KH",
                "KI",
                "KM",
                "KN",
                "KP",
                "KR",
                "KW",
                "KY",
                "KZ",
                "LA",
                "LB",
                "LC",
                "LI",
                "LK",
                "LR",
                "LS",
                "LT",
                "LU",
                "LV",
                "LY",
                "MA",
                "MC",
                "MD",
                "ME",
                "MF",
                "MG",
                "MH",
                "MK",
                "ML",
                "MM",
                "MN",
                "MO",
                "MP",
                "MQ",
                "MR",
                "MS",
                "MT",
                "MU",
                "MV",
                "MW",
                "MX",
                "MY",
                "MZ",
                "NA",
                "NC",
                "NE",
                "NF",
                "NG",
                "NI",
                "NL",
                "NO",
                "NP",
                "NR",
                "NU",
                "NZ",
                "OM",
                "PA",
                "PE",
                "PF",
                "PG",
                "PH",
                "PK",
                "PL",
                "PM",
                "PN",
                "PR",
                "PS",
                "PT",
                "PW",
                "PY",
                "QA",
                "RE",
                "RO",
                "RS",
                "RU",
                "RW",
                "SA",
                "SB",
                "SC",
                "SD",
                "SE",
                "SG",
                "SH",
                "SI",
                "SJ",
                "SK",
                "SL",
                "SM",
                "SN",
                "SO",
                "SR",
                "SS",
                "ST",
                "SV",
                "SX",
                "SY",
                "SZ",
                "TC",
                "TD",
                "TF",
                "TG",
                "TH",
                "TJ",
                "TK",
                "TL",
                "TM",
                "TN",
                "TO",
                "TR",
                "TT",
                "TV",
                "TW",
                "TZ",
                "UA",
                "UG",
                "UM",
                "US",
                "UY",
                "UZ",
                "VA",
                "VC",
                "VE",
                "VG",
                "VI",
                "VN",
                "VU",
                "WF",
                "WS",
                "YE",
                "YT",
                "ZA",
                "ZM",
                "ZW"
              ]
            },
            "description": "Filter by the the request origin country's 2 letter ISO 3166-1 alpha-2 code (Example: `US`, `FR`, `GB`, `CA`)."
          },
          {
            "name": "group_by",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "nullable": true,
                "enum": [
                  null,
                  "start_date",
                  "device_name",
                  "video_title",
                  "video_id",
                  "stream_type",
                  "consumer_email",
                  "consumer_id",
                  "monetized_option",
                  "country"
                ]
              }
            },
            "description": "Group records by one or more properties of the data returned -- accepted values are: `start_date`, `device_name`, `video_title`, `video_id`, `stream_type`, `consumer_email`, `consumer_id`, `monetized_option`, `country`"
          },
          {
            "name": "sort_by",
            "in": "query",
            "schema": {
              "type": "string",
              "nullable": true,
              "enum": [
                null,
                "start_date_asc",
                "start_date_desc",
                "device_name_asc",
                "device_name_desc",
                "video_title_asc",
                "video_title_desc",
                "video_id_asc",
                "video_id_desc",
                "stream_type_asc",
                "stream_type_desc",
                "consumer_id_asc",
                "consumer_id_desc",
                "monetized_option_asc",
                "monetized_option_desc",
                "country_asc",
                "country_desc"
              ]
            },
            "description": "Sort results by value of a specific property + '_' + sort direction (Example - sort_by=start_date_asc, or sort_by=device_name_desc)"
          },
          {
            "name": "view_mode",
            "in": "query",
            "schema": {
              "type": "string",
              "nullable": true,
              "enum": [
                null,
                "detailed",
                "summary"
              ],
              "default": "summary"
            },
            "description": "Set view mode to detailed to return all available properties for all records."
          }
        ],
        "responses": {
          "200": {
            "description": "See below for example responses",
            "content": {
              "application/json": {
                "schema": {
                  "title": "StreamHoursResponse",
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "title": "Stream Hour",
                        "type": "object",
                        "properties": {
                          "player_request_id": {
                            "type": "string"
                          },
                          "consumer_id": {
                            "type": "string"
                          },
                          "country": {
                            "type": "string"
                          },
                          "consumer_email": {
                            "type": "string"
                          },
                          "device_name": {
                            "type": "string"
                          },
                          "monetized_option": {
                            "type": "string"
                          },
                          "video_id": {
                            "type": "string"
                          },
                          "stream_type": {
                            "type": "string"
                          },
                          "stream_hours": {
                            "type": "number"
                          },
                          "bytes_streamed": {
                            "type": "number"
                          },
                          "start_date": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable entity",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/paths/~1v2~1consumers/get/responses/422/content/application~1json/schema"
                }
              }
            }
          }
        }
      }
    },
    "/v2/player_requests": {
      "get": {
        "x-server-name": "analytics-api",
        "summary": "List Player Requests",
        "description": "This endpoint will return Player Request analytics data for your property.",
        "tags": [
          "Player Requests"
        ],
        "operationId": "player-requests",
        "parameters": [
          {
            "name": "filters[start_date_gt]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records created after the specified `start_date` (filters[start_date_gte]=2018-11-01). If no `start_date` is specified, then data returned will date back two weeks ago."
          },
          {
            "name": "filters[start_date_gte]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records created on or after the specified `start_date`."
          },
          {
            "name": "filters[start_date_lt]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records created before the specified `start_date`."
          },
          {
            "name": "filters[start_date_lte]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records created on or before the specified `start_date`."
          },
          {
            "name": "filters[start_date_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records created on the specified `start_date`. Comparison is date and time specific. If no time values are submitted, 00:00:00 UTC is assumed."
          },
          {
            "name": "filters[id_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records with specified `id`"
          },
          {
            "name": "filters[browser_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records with specified `browser`"
          },
          {
            "name": "filters[browser_version_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records with specified `browser_version`"
          },
          {
            "name": "filters[os_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records with specified `os`"
          },
          {
            "name": "filters[os_version_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records with specified `os_version`"
          },
          {
            "name": "filters[player_name_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records with specified `player_name`"
          },
          {
            "name": "filters[video_id_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records with specified `video_id`"
          },
          {
            "name": "filters[device_name_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records with specified `device_name`"
          },
          {
            "name": "filters[revenue_model_name_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records with specified `revenue_model_name`"
          },
          {
            "name": "filters[consumer_id_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records with specified `consumer_id`"
          },
          {
            "name": "filters[name_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records with specified consumer `name`"
          },
          {
            "name": "filters[consumer_email_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records with specified `consumer_email`"
          },
          {
            "name": "filters[country_eq]",
            "in": "query",
            "schema": {
              "type": "string",
              "nullable": true,
              "enum": [
                null,
                "AD",
                "AE",
                "AF",
                "AG",
                "AI",
                "AL",
                "AM",
                "AO",
                "AQ",
                "AR",
                "AS",
                "AT",
                "AU",
                "AW",
                "AX",
                "AZ",
                "BA",
                "BB",
                "BD",
                "BE",
                "BF",
                "BG",
                "BH",
                "BI",
                "BJ",
                "BL",
                "BM",
                "BN",
                "BO",
                "BQ",
                "BR",
                "BS",
                "BT",
                "BV",
                "BW",
                "BY",
                "BZ",
                "CA",
                "CC",
                "CD",
                "CF",
                "CG",
                "CH",
                "CI",
                "CK",
                "CL",
                "CM",
                "CN",
                "CO",
                "CR",
                "CU",
                "CV",
                "CW",
                "CX",
                "CY",
                "CZ",
                "DE",
                "DJ",
                "DK",
                "DM",
                "DO",
                "DZ",
                "EC",
                "EE",
                "EG",
                "EH",
                "ER",
                "ES",
                "ET",
                "FI",
                "FJ",
                "FK",
                "FM",
                "FO",
                "FR",
                "GA",
                "GB",
                "GD",
                "GE",
                "GF",
                "GG",
                "GH",
                "GI",
                "GL",
                "GM",
                "GN",
                "GP",
                "GQ",
                "GR",
                "GS",
                "GT",
                "GU",
                "GW",
                "GY",
                "HK",
                "HM",
                "HN",
                "HR",
                "HT",
                "HU",
                "ID",
                "IE",
                "IL",
                "IM",
                "IN",
                "IO",
                "IQ",
                "IR",
                "IS",
                "IT",
                "JE",
                "JM",
                "JO",
                "JP",
                "KE",
                "KG",
                "KH",
                "KI",
                "KM",
                "KN",
                "KP",
                "KR",
                "KW",
                "KY",
                "KZ",
                "LA",
                "LB",
                "LC",
                "LI",
                "LK",
                "LR",
                "LS",
                "LT",
                "LU",
                "LV",
                "LY",
                "MA",
                "MC",
                "MD",
                "ME",
                "MF",
                "MG",
                "MH",
                "MK",
                "ML",
                "MM",
                "MN",
                "MO",
                "MP",
                "MQ",
                "MR",
                "MS",
                "MT",
                "MU",
                "MV",
                "MW",
                "MX",
                "MY",
                "MZ",
                "NA",
                "NC",
                "NE",
                "NF",
                "NG",
                "NI",
                "NL",
                "NO",
                "NP",
                "NR",
                "NU",
                "NZ",
                "OM",
                "PA",
                "PE",
                "PF",
                "PG",
                "PH",
                "PK",
                "PL",
                "PM",
                "PN",
                "PR",
                "PS",
                "PT",
                "PW",
                "PY",
                "QA",
                "RE",
                "RO",
                "RS",
                "RU",
                "RW",
                "SA",
                "SB",
                "SC",
                "SD",
                "SE",
                "SG",
                "SH",
                "SI",
                "SJ",
                "SK",
                "SL",
                "SM",
                "SN",
                "SO",
                "SR",
                "SS",
                "ST",
                "SV",
                "SX",
                "SY",
                "SZ",
                "TC",
                "TD",
                "TF",
                "TG",
                "TH",
                "TJ",
                "TK",
                "TL",
                "TM",
                "TN",
                "TO",
                "TR",
                "TT",
                "TV",
                "TW",
                "TZ",
                "UA",
                "UG",
                "UM",
                "US",
                "UY",
                "UZ",
                "VA",
                "VC",
                "VE",
                "VG",
                "VI",
                "VN",
                "VU",
                "WF",
                "WS",
                "YE",
                "YT",
                "ZA",
                "ZM",
                "ZW"
              ]
            },
            "description": "Filter records with specified `country`"
          },
          {
            "name": "filters[domain_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records with specified `domain`"
          },
          {
            "name": "filters[tracking_code_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records with specified `tracking_code`"
          },
          {
            "name": "filters[tracking_partner_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records with specified `tracking_partner`"
          },
          {
            "name": "filters[video_title_eq]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter records with specified `video_title`"
          },
          {
            "name": "interval",
            "in": "query",
            "schema": {
              "type": "string",
              "nullable": true,
              "enum": [
                null,
                "day"
              ]
            },
            "description": "Shortcut method to group records by time intervals. Accepted values: `day`."
          },
          {
            "name": "group_by",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "nullable": true,
                "enum": [
                  null,
                  "browser",
                  "browser_version",
                  "os",
                  "os_version",
                  "player_name",
                  "video_id",
                  "device_name",
                  "revenue_model_name",
                  "consumer_id",
                  "name",
                  "consumer_email",
                  "country",
                  "domain",
                  "tracking_code",
                  "tracking_partner",
                  "video_title",
                  "start_date"
                ]
              }
            },
            "description": "Group records by one or more properties of the data returned -- accepted values are: `browser`, `browser_version`, `os`, `os_version`, `player_name`, `video_id`, `device_name`, `revenue_model_name`, `consumer_id`, `name`, `consumer_email`, `country`, `domain`, `tracking_code`, `tracking_partner`, `video_title`, `start_date`"
          },
          {
            "name": "counts",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "Return count of records per grouping. Using counts = [\"*\"] for generic count of all records in grouping, response will include `request_count`."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer"
            },
            "description": "Limit the number of records returned"
          },
          {
            "name": "sort_by",
            "in": "query",
            "schema": {
              "type": "string",
              "nullable": true,
              "enum": [
                null,
                "id_asc",
                "id_desc",
                "browser_asc",
                "browser_desc",
                "browser_version_asc",
                "browser_version_desc",
                "os_asc",
                "os_desc",
                "os_version_asc",
                "os_version_desc",
                "player_name_asc",
                "player_name_desc",
                "video_id_asc",
                "video_id_desc",
                "device_name_asc",
                "device_name_desc",
                "revenue_model_name_asc",
                "revenue_model_name_desc",
                "consumer_id_asc",
                "consumer_id_desc",
                "name_asc",
                "name_desc",
                "consumer_email_asc",
                "consumer_email_desc",
                "country_asc",
                "country_desc",
                "domain_asc",
                "domain_desc",
                "tracking_code_asc",
                "tracking_code_desc",
                "tracking_partner_asc",
                "tracking_partner_desc",
                "video_title_asc",
                "video_title_desc",
                "start_date_asc",
                "start_date_desc"
              ]
            },
            "description": "Sort results by value of a specific property + '_' + sort direction (Example - sort_by=start_date_asc, or sort_by=consumer_email_desc)"
          }
        ],
        "responses": {
          "200": {
            "description": "See below for example responses",
            "content": {
              "application/json": {
                "schema": {
                  "title": "PlayerRequestsResponse",
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "title": "PlayerRequest",
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "browser": {
                            "type": "string"
                          },
                          "browser_version": {
                            "type": "string"
                          },
                          "os": {
                            "type": "string"
                          },
                          "os_version": {
                            "type": "string"
                          },
                          "player_name": {
                            "type": "string"
                          },
                          "video_id": {
                            "type": "string"
                          },
                          "device_name": {
                            "type": "string"
                          },
                          "revenue_model_name": {
                            "type": "string"
                          },
                          "consumer_id": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
           

# --- truncated at 32 KB (95 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/zype/refs/heads/main/openapi/zype-analytics.json