{ "openapi": "3.0.1", "info": { "title": "NOAA Tides API - Tide Predictions, High Tide & Low Tide Times", "description": "High and low tide times and heights from the official NOAA CO-OPS API for all 3,499 US tide prediction stations. Give a station id or a lat,lon point and it finds the nearest station. Rows carry local time, a UTC timestamp with the offset that applied, feet and meters, and the range to the next.", "version": "0.1", "x-build-id": "50wzdBXae0L48dm5y" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~noaa-tide-predictions-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-noaa-tide-predictions-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/neverempty~noaa-tide-predictions-api/runs": { "post": { "operationId": "runs-sync-neverempty-noaa-tide-predictions-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/neverempty~noaa-tide-predictions-api/run-sync": { "post": { "operationId": "run-sync-neverempty-noaa-tide-predictions-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", "properties": { "locations": { "title": "Stations or points", "type": "array", "description": "NOAA station ids such as \"8443970\" (Boston) or \"TEC1603\", and/or points written as \"lat,lon\" such as \"37.81,-122.47\". A point is resolved to the nearest of the 3,499 official tide prediction stations and the distance in km is returned with every row. If none of the values are usable the run fails instead of quietly returning a default station.", "default": [ "8443970" ], "items": { "type": "string" } }, "days": { "title": "Days ahead", "minimum": 1, "maximum": 365, "type": "integer", "description": "How many days of tides to return, counted from the moment the run starts. Only tides still in the future are returned. Ignored when you set a start and end date below. A station has about 4 tides a day, so 7 days is about 28 rows per station.", "default": 7 }, "beginDate": { "title": "Start date (optional)", "type": "string", "description": "First day of a fixed window, as \"2026-09-01\". Dates are the station's own local calendar days, the same as a printed tide table. Past dates work. Leave empty to use \"Days ahead\" instead.", "default": "" }, "endDate": { "title": "End date (optional)", "type": "string", "description": "Last day of the fixed window, as \"2026-09-30\". Must be given together with the start date. At most 365 days in one run, so a mistyped year cannot run up a bill.", "default": "" }, "datum": { "title": "Tidal datum", "enum": [ "MLLW", "MLW", "MSL", "MTL", "MHW", "MHHW", "NAVD", "STND" ], "type": "string", "description": "The zero the heights are measured from. MLLW (mean lower low water) is what US tide tables and nautical charts use. Not every station publishes every datum: NOAA rejects the ones it does not have, and this Actor reports that instead of returning an empty result.", "default": "MLLW" }, "maxRetries": { "title": "Retries", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many times to retry when the NOAA API does not answer or returns a server error. Bad requests, such as a datum a station does not publish, are not retried.", "default": 4 } } }, "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 } } } } } } } } } }