{ "openapi": "3.0.1", "info": { "title": "Internet Outage Alerts: Connectivity Drops by Country", "description": "Keyless global internet outage detection. Alerts when a country, region or individual network loses connectivity, with the operator name, how many addresses are affected, how far traffic fell against that network's own history, and how many independent measurement systems corroborate the event.", "version": "0.1", "x-build-id": "68Bgd4w6f1naS70sS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapemint~internet-outage-alerts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapemint-internet-outage-alerts", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapemint~internet-outage-alerts/runs": { "post": { "operationId": "runs-sync-scrapemint-internet-outage-alerts", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapemint~internet-outage-alerts/run-sync": { "post": { "operationId": "run-sync-scrapemint-internet-outage-alerts", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Mode", "enum": [ "alerts", "summary" ], "type": "string", "description": "alerts = one row per outage event with the networks affected. summary = one row per country or network with an outage score for the whole window.", "default": "alerts" }, "hoursBack": { "title": "Hours to look back", "minimum": 1, "maximum": 720, "type": "integer", "description": "How far back to search. A quiet day may return very little, which is the correct answer rather than a failure.", "default": 24 }, "entityType": { "title": "Level of detail", "enum": [ "all", "country", "region", "asn", "geoasn" ], "type": "string", "description": "country and region are national and subnational outages. asn is a single network operator. geoasn is one operator within one country.", "default": "all" }, "country": { "title": "Country codes (optional)", "type": "array", "description": "Two letter codes such as NG, IR, SD. Empty watches the whole world.", "default": [], "items": { "type": "string" } }, "onlyOutages": { "title": "Only outages", "type": "boolean", "description": "On by default. The raw feed mixes recoveries in with outages, and recoveries are the majority. Turn this off to see connectivity returning too.", "default": true }, "minDropPercent": { "title": "Minimum traffic drop percent", "minimum": 0, "maximum": 100, "type": "integer", "description": "Keep only events where traffic fell at least this far below the network's own normal level. 0 keeps everything.", "default": 0 }, "minSources": { "title": "Minimum corroborating sources", "minimum": 1, "maximum": 4, "type": "integer", "description": "How many independent measurement systems must have seen the event. Raising this to 2 is the simplest way to filter out measurement noise.", "default": 1 }, "groupEvents": { "title": "Group reports of the same event", "type": "boolean", "description": "On by default. Each measurement system reports separately, so without grouping one outage appears as several rows.", "default": true }, "maxResults": { "title": "Max rows per run", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Cap on rows returned. Controls total cost.", "default": 150 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }