# NOAA Tides & Currents Stations Scraper (`compute-edge/noaa-tides-scraper`) Actor Extract NOAA Tides & Currents station metadata (3,400+ stations) with optional latest water-level readings. Filter by state and station type. - **URL**: https://apify.com/compute-edge/noaa-tides-scraper.md - **Developed by:** [Compute Edge](https://apify.com/compute-edge) (community) - **Categories:** Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## NOAA Tides & Currents Stations Scraper Extract metadata for **3,400+ NOAA Tides & Currents observation stations** across the United States and territories — including station ID, name, coordinates, state, station type, and timezone references. Optionally enrich each station with the **latest observed water level reading** (referenced to MLLW datum). This Actor wraps the public NOAA Tides & Currents MDAPI and Datagetter endpoints. Data is sourced from the [NOAA Center for Operational Oceanographic Products and Services (CO-OPS)](https://tidesandcurrents.noaa.gov/) and is updated continuously as new readings come in from physical stations along U.S. coastlines, the Great Lakes, and Pacific/Caribbean territories. ### Features - **All NOAA station types** — tide predictions, water levels, currents, current predictions - **State filtering** — narrow to one state (e.g. `FL`, `CA`, `WA`) - **Latest water levels** — optionally pull the most recent observed water level (feet, MLLW) per station - **Geocoded** — every record includes latitude/longitude for mapping - **Station page links** — direct deep-link to the official NOAA station page ### Output fields | Field | Description | |-------|-------------| | `stationId` | NOAA station identifier (e.g. `8454000`) | | `name` | Station name (e.g. `Providence`) | | `state` | Two-letter state code | | `type` | Station type (tide, water level, etc.) | | `latitude` / `longitude` | Geo-coordinates | | `referenceId` | Reference station ID for tide subordinates | | `timeMeridian` / `timeZoneCorr` | Local time references | | `latestWaterLevelFeet` | Latest observed water level (MLLW datum, ft) — when enabled | | `latestWaterLevelTimeGmt` | Timestamp of the latest reading (GMT) | | `stationPageUrl` | Link to the NOAA station home page | | `metadataUrl` | API URL to full station metadata | ### Use cases - **Maritime operations** — pull station inventories for port operators, dredging companies, USCG support contractors - **Climate research** — identify coastal monitoring sites by region for sea-level rise studies - **Tide-dependent businesses** — fishing charters, harbor pilots, coastal surveyors integrating real-time tide data - **Insurance & risk modeling** — flood-zone underwriting using authoritative tide gauge locations ### How to use 1. Set `stationType` to the dataset you want (default `tidepredictions`). 2. Optionally filter by `stateFilter` (two-letter code). 3. Toggle `includeLatestWaterLevel` to enrich each station with its newest observation. 4. Set `maxResults` to cap the run (default 1000, max 5000). ### Pricing Pay-per-result at **$0.003/record**. A nationwide tide-predictions pull (~3,400 records) costs around $10. Apify compute cost is minimal — most runs finish in under 2 minutes without water-level enrichment. ### FAQ **Where does the data come from?** The NOAA Center for Operational Oceanographic Products and Services (CO-OPS), a U.S. federal agency. Data is in the public domain. **Is real-time water level data available?** Yes — enable `includeLatestWaterLevel`. This adds one HTTPS call per station, so large pulls take longer. **Are predictions included?** This Actor returns station metadata. Tide *predictions* for specific dates are a separate NOAA endpoint; let us know if you need that variant. ### Legal NOAA data is in the public domain under U.S. federal policy. This Actor only accesses publicly published endpoints and stores no personal data. Use complies with NOAA Acceptable Use guidelines. # Actor input Schema ## `stationType` (type: `string`): Type of station to list: 'tidepredictions', 'waterlevels', 'currents', 'currentpredictions'. ## `stateFilter` (type: `string`): Two-letter state code to filter (e.g. 'CA', 'FL'). Leave blank for all states. ## `includeLatestWaterLevel` (type: `boolean`): If enabled, fetch the latest observed water level (MLLW, ft) for each station. Adds one request per station. ## `maxResults` (type: `integer`): Maximum number of stations to return. 0 = unlimited. ## Actor input object example ```json { "stationType": "tidepredictions", "stateFilter": "", "includeLatestWaterLevel": false, "maxResults": 1000 } ```` # Actor output Schema ## `dataset` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("compute-edge/noaa-tides-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("compute-edge/noaa-tides-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call compute-edge/noaa-tides-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=compute-edge/noaa-tides-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "NOAA Tides & Currents Stations Scraper", "description": "Extract NOAA Tides & Currents station metadata (3,400+ stations) with optional latest water-level readings. Filter by state and station type.", "version": "0.1", "x-build-id": "zL70U3MOISjEoL6Wj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/compute-edge~noaa-tides-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-compute-edge-noaa-tides-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/compute-edge~noaa-tides-scraper/runs": { "post": { "operationId": "runs-sync-compute-edge-noaa-tides-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/compute-edge~noaa-tides-scraper/run-sync": { "post": { "operationId": "run-sync-compute-edge-noaa-tides-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": { "stationType": { "title": "Station Type", "type": "string", "description": "Type of station to list: 'tidepredictions', 'waterlevels', 'currents', 'currentpredictions'.", "default": "tidepredictions" }, "stateFilter": { "title": "State Filter", "type": "string", "description": "Two-letter state code to filter (e.g. 'CA', 'FL'). Leave blank for all states.", "default": "" }, "includeLatestWaterLevel": { "title": "Include Latest Water Level", "type": "boolean", "description": "If enabled, fetch the latest observed water level (MLLW, ft) for each station. Adds one request per station.", "default": false }, "maxResults": { "title": "Max Results", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Maximum number of stations to return. 0 = unlimited.", "default": 1000 } } }, "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 } } } } } } } } } } ```