{ "openapi": "3.0.1", "info": { "title": "NOAA Tide Predictions Scraper", "description": "Get official NOAA CO-OPS tide predictions for one or more stations or geographic points. Choose high and low events or hourly water levels, then receive structured rows with station, time, level, time zone, and NOAA source links.", "version": "0.0", "x-build-id": "PgqxbVbIseRlH7L0x" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~noaa-tide-predictions/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-noaa-tide-predictions", "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/maximedupre~noaa-tide-predictions/runs": { "post": { "operationId": "runs-sync-maximedupre-noaa-tide-predictions", "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/maximedupre~noaa-tide-predictions/run-sync": { "post": { "operationId": "run-sync-maximedupre-noaa-tide-predictions", "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": [ "resultType", "discoveryMethod", "startDate", "endDate" ], "properties": { "resultType": { "title": "Result type", "enum": [ "highLow", "hourly" ], "type": "string", "description": "Choose the row family returned by this run. High and low tide events return turning points. Hourly predicted water levels return one prediction for each hour." }, "discoveryMethod": { "title": "Find predictions by", "enum": [ "stationIds", "coordinates" ], "type": "string", "description": "Choose one input type for this run. All submitted station IDs or points use the same result type, date range, units, and time zone." }, "stationIds": { "title": "Station IDs", "minItems": 1, "type": "array", "description": "Enter one or more official NOAA CO-OPS station IDs. Each ID uses the shared result type, date range, units, and time zone. Example: 9414290.", "items": { "type": "string" } }, "coordinates": { "title": "Geographic points", "minItems": 1, "type": "array", "description": "Enter one or more points as latitude and longitude in decimal degrees. Each point is matched to the nearest official NOAA prediction station, and the result includes that station and distance. Example: {\"latitude\":37.8063,\"longitude\":-122.4659}.", "items": { "type": "object", "properties": { "latitude": { "title": "Latitude", "type": "number", "description": "Latitude in decimal degrees, from -90 to 90.", "minimum": -90, "maximum": 90 }, "longitude": { "title": "Longitude", "type": "number", "description": "Longitude in decimal degrees, from -180 to 180.", "minimum": -180, "maximum": 180 } }, "required": [ "latitude", "longitude" ] } }, "startDate": { "title": "Start date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "First date in the prediction window, in YYYY-MM-DD format. It can be in the past or future." }, "endDate": { "title": "End date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Last date in the prediction window, in YYYY-MM-DD format. Use the same date or a date after the start date." }, "units": { "title": "Level units", "enum": [ "feet", "meters" ], "type": "string", "description": "Choose the unit for predicted levels. Results also keep feet and meter values when NOAA provides both.", "default": "feet" }, "datum": { "title": "Vertical datum", "type": "string", "description": "Enter the vertical datum for predicted levels. Use a supported NOAA station datum, such as MLLW.", "default": "MLLW" }, "timezone": { "title": "Prediction time zone", "enum": [ "local", "gmt" ], "type": "string", "description": "Choose station local time or GMT / UTC for prediction timestamps. Results include the station time zone and applied UTC offset.", "default": "local" }, "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Optional positive limit on returned prediction records across the run. Leave it empty to return all available results until the source is exhausted." } } }, "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 } } } } } } } } } }