{
"openapi": "3.0.1",
"info": {
"title": "Waze Real-time API",
"description": "Live Waze traffic data API: accidents, hazards, police, road closures and traffic jams in any map area, Waze driving directions with ETA, tolls and on-route alerts, venues by category and place autocomplete.",
"version": "1.0",
"x-build-id": "ZbyxmHorXs7ZMBvB7"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/parsebird~waze-api/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-parsebird-waze-api",
"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/parsebird~waze-api/runs": {
"post": {
"operationId": "runs-sync-parsebird-waze-api",
"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/parsebird~waze-api/run-sync": {
"post": {
"operationId": "run-sync-parsebird-waze-api",
"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",
"required": [
"operation"
],
"properties": {
"operation": {
"title": "Operation",
"enum": [
"alertsAndJams",
"drivingDirections",
"venues",
"autocomplete"
],
"type": "string",
"description": "Choose what to get from Waze. Each operation uses only its own fields below.",
"default": "alertsAndJams"
},
"bottomLeft": {
"title": "Bottom-left corner",
"type": "string",
"description": "South-west corner of the map area as latitude,longitude. Used by Alerts & Jams and Venues."
},
"topRight": {
"title": "Top-right corner",
"type": "string",
"description": "North-east corner of the map area as latitude,longitude. Used by Alerts & Jams and Venues."
},
"mapAreas": {
"title": "More map areas",
"type": "array",
"description": "Add more areas to run in the same run, one per line as bottomLeftLat,bottomLeftLng;topRightLat,topRightLng. Each area is a separate query.",
"items": {
"type": "string"
}
},
"maxAlerts": {
"title": "Max alerts",
"minimum": 0,
"maximum": 10000,
"type": "integer",
"description": "Maximum alerts (accidents, hazards, police, closures...) to return per map area. Waze sends up to 200 per request; above that the area is split into smaller tiles automatically. Set 0 to skip alerts.",
"default": 20
},
"maxJams": {
"title": "Max jams",
"minimum": 0,
"maximum": 10000,
"type": "integer",
"description": "Maximum traffic jams to return per map area, most severe first. Set 0 to skip jams.",
"default": 20
},
"alertTypes": {
"title": "Alert types",
"type": "string",
"description": "Only return these alert types, comma-separated: ACCIDENT, HAZARD, POLICE, ROAD_CLOSED, JAM. Leave empty for all."
},
"alertSubtypes": {
"title": "Alert subtypes",
"type": "string",
"description": "Only return these subtypes, comma-separated, e.g. HAZARD_ON_ROAD_CONSTRUCTION,HAZARD_ON_ROAD_POT_HOLE,ACCIDENT_MAJOR. Leave empty for all."
},
"sourceCoordinates": {
"title": "Start point",
"type": "string",
"description": "Where the drive starts, as latitude,longitude."
},
"destinationCoordinates": {
"title": "Destination",
"type": "string",
"description": "Where the drive ends, as latitude,longitude."
},
"routePairs": {
"title": "More routes",
"type": "array",
"description": "Add more start/destination pairs, one per line as startLat,startLng;endLat,endLng.",
"items": {
"type": "string"
}
},
"maxRoutes": {
"title": "Max routes per query",
"minimum": 1,
"maximum": 5,
"type": "integer",
"description": "How many alternative routes to request (1-5). Each route returned is charged.",
"default": 3
},
"returnRouteCoordinates": {
"title": "Include route coordinates",
"type": "boolean",
"description": "Add the full route polyline (and the polyline of each jam on the route). Makes each row much larger.",
"default": false
},
"arrivalTimestamp": {
"title": "Arrive by (Unix time)",
"minimum": 0,
"type": "integer",
"description": "Plan the route to arrive at this time, in Unix seconds (e.g. 1792512000). Leave empty to leave now."
},
"departureTimestamp": {
"title": "Depart at (Unix time)",
"minimum": 0,
"type": "integer",
"description": "Plan the route for a future departure time, in Unix seconds. Ignored when Arrive by is set."
},
"venueCategories": {
"title": "Venue categories",
"type": "string",
"description": "What to look for in the map area, comma-separated, e.g. gas station,parking,ev charging station. Leave empty for gas stations, parking, EV charging, restaurants, coffee shops and hotels."
},
"maxVenues": {
"title": "Max venues per area",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "Maximum venues to return per map area.",
"default": 100
},
"onlyInsideArea": {
"title": "Only venues inside the map area",
"type": "boolean",
"description": "Drop suggestions that Waze returns just outside the rectangle.",
"default": true
},
"autocompleteQuery": {
"title": "Autocomplete query",
"type": "string",
"description": "Text to search for, like you would type in the Waze search box (an address, a place name or a category)."
},
"autocompleteQueries": {
"title": "More queries",
"type": "array",
"description": "Add more search texts, one per line. Each is a separate query.",
"items": {
"type": "string"
}
},
"searchNear": {
"title": "Search near",
"type": "string",
"description": "Location to rank suggestions around, as latitude,longitude. If empty, the center of the map area above is used."
},
"maxResultsPerQuery": {
"title": "Max suggestions per query",
"minimum": 1,
"maximum": 50,
"type": "integer",
"description": "Maximum suggestions to keep per query.",
"default": 10
},
"language": {
"title": "Language",
"type": "string",
"description": "Language code for place names and addresses in Venues and Autocomplete, e.g. en, es, fr, he.",
"default": "en"
}
}
},
"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
},
"PROXY_UNBLOCKER_UNITS": {
"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
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}