{
  "openapi": "3.0.1",
  "info": {
    "title": "Elevation & Terrain Data Scraper - Altitude by Coordinates",
    "description": "$0.5/1K 🔥 Elevation scraper! Terrain height for any coordinates, grid or route from 11 datasets. No key. JSON, CSV, Excel or API in seconds. Build hiking profiles & GIS pipelines ⚡",
    "version": "0.1",
    "x-build-id": "z1I9KqRufSN4bmfUC"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/ninhothedev~elevation-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-ninhothedev-elevation-scraper",
        "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/ninhothedev~elevation-scraper/runs": {
      "post": {
        "operationId": "runs-sync-ninhothedev-elevation-scraper",
        "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/ninhothedev~elevation-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-ninhothedev-elevation-scraper",
        "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": [
              "points",
              "grid",
              "path"
            ],
            "type": "string",
            "description": "How the coordinates to look up are produced. 'points' uses your explicit coordinate list, 'grid' generates a lat/lon grid inside a bounding box, 'path' interpolates your waypoints into an evenly spaced elevation profile.",
            "default": "points"
          },
          "coordinates": {
            "title": "Coordinates (lat,lon)",
            "type": "array",
            "description": "List of 'lat,lon' pairs, e.g. '52.5200,13.4050'. Used in points mode as the exact lookup list, and in path mode as the ordered waypoints of the route. Ignored in grid mode.",
            "items": {
              "type": "string"
            }
          },
          "dataset": {
            "title": "Elevation dataset",
            "enum": [
              "srtm30m",
              "srtm90m",
              "aster30m",
              "mapzen",
              "gebco2020",
              "etopo1",
              "eudem25m",
              "ned10m",
              "bkg200m",
              "nzdem8m",
              "emod2018"
            ],
            "type": "string",
            "description": "Which digital elevation model to query. Global datasets cover the whole planet; regional ones are far more precise but return null outside their region. Bathymetry datasets also give negative values for ocean depth.",
            "default": "srtm30m"
          },
          "bboxSouth": {
            "title": "Bounding box - south latitude",
            "type": "number",
            "description": "Grid mode only: southern edge of the bounding box, in decimal degrees (-90 to 90)."
          },
          "bboxNorth": {
            "title": "Bounding box - north latitude",
            "type": "number",
            "description": "Grid mode only: northern edge of the bounding box, in decimal degrees (-90 to 90)."
          },
          "bboxWest": {
            "title": "Bounding box - west longitude",
            "type": "number",
            "description": "Grid mode only: western edge of the bounding box, in decimal degrees (-180 to 180)."
          },
          "bboxEast": {
            "title": "Bounding box - east longitude",
            "type": "number",
            "description": "Grid mode only: eastern edge of the bounding box, in decimal degrees (-180 to 180)."
          },
          "gridStep": {
            "title": "Grid step",
            "type": "number",
            "description": "Grid mode only: spacing in degrees between generated grid points. 0.01 deg is roughly 1.1 km of latitude. Smaller steps mean far more points, so the grid is capped by maxItems before any request is sent.",
            "default": 0.01
          },
          "pathSamples": {
            "title": "Path samples",
            "minimum": 2,
            "maximum": 5000,
            "type": "integer",
            "description": "Path mode only: how many evenly spaced samples to interpolate along the route defined by your waypoints. More samples give a smoother elevation profile.",
            "default": 50
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Hard cap on how many elevation points this run produces. Also caps the generated grid or path before any API request is made.",
            "default": 500
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}