# Weather Data Scraper (Cheap) (`data_api/weather-data-scraper-cheap`) Actor Extract comprehensive current weather conditions, 24-48h hourly forecasts, 8-15d daily forecasts, and EPA air quality indices from Weather.com by location name, zip code, or URL. Features premium proxy bypass. - **URL**: https://apify.com/data\_api/weather-data-scraper-cheap.md - **Developed by:** [Data API](https://apify.com/data_api) (community) - **Categories:** Developer tools, Automation, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.99 / 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. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Weather Data Scraper ![Weather Data Scraper](cover.jpg) Checking a forecast by hand is fine for one city. It falls apart the moment you need fifty, or you want the numbers in a spreadsheet instead of a webpage you have to read with your eyes. This scraper reads Weather.com for you: give it a place name, a Weather.com place code, or a forecast URL and it returns the live conditions, the air quality reading, an hour-by-hour outlook, and a ten-to-fifteen-day forecast as clean structured fields. Pass one place or a long list, anywhere on the map. ### What you get Every place you feed in comes back as one row with a steady shape, so loading the results into a sheet or database stays predictable. Each row carries: - **Location** — `queryInput`, `placeCode`, `sourceUrl`, `placeName`, `geoLat`, `geoLng`, and a `collectedAt` timestamp - **Live conditions** — temperature, feels-like, humidity, wind speed and direction, gusts, UV index, visibility, pressure, dew point, and a plain-language weather phrase, all under `liveConditions` - **Air quality** — the AQI value, its category, the lead pollutant, and any advisory text under `airQualityReport` - **Hourly outlook** — temperature, precipitation chance and type, humidity, wind, and UV for each upcoming hour under `hourlyOutlook` - **Daily outlook** — day and night highs, lows, rain chances, wind, humidity, sunrise, sunset, and moon phase under `dailyOutlook` ### Quick start 1. Click **Try for free** and open the input form. 2. Add your places: type city or region names into **Place names**, or paste **Place codes** or full **Forecast page URLs** if you already have them. 3. Set a **Results limit** to cap the run, and raise **Request timeout** if responses come back slow. 4. Press **Start**, then export the results as JSON, CSV, Excel, or XML once the run finishes. ![How it works](how-it-works.jpg) ### Use cases - **Logistics and field teams** — pull daily forecasts for every route or job site in one pass and plan around rain, heat, or wind - **Energy and demand modeling** — feed temperature and humidity readings into load forecasts - **Agriculture** — track precipitation chance, UV, and daily highs across several growing regions - **Travel and events** — compare hourly and daily outlooks for a handful of destinations side by side - **Air-quality monitoring** — watch AQI values and lead pollutants across a list of cities - **Research and dashboards** — collect a consistent weather feed for a set of locations without managing an API key ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `placeQueries` | array of strings | One of `placeQueries`, `placeCodes`, or `pageUrls` | City, county, or region names. The scraper resolves each to a Weather.com place on its own. Prefill: `Austin, TX`, `Reykjavik`. | | `placeCodes` | array of strings | One of `placeQueries`, `placeCodes`, or `pageUrls` | Raw Weather.com place IDs when you already have them. Skips the lookup step. | | `pageUrls` | array of strings | One of `placeQueries`, `placeCodes`, or `pageUrls` | Full Weather.com forecast URLs to read directly. | | `resultsLimit` | integer | No | Cap on how many places to read per run. Default `500`. | | `timeoutSeconds` | integer | No | Seconds to wait on each request before giving up. Default `45`. | #### Example input ```json { "placeQueries": ["Austin, TX", "Reykjavik"], "placeCodes": [], "pageUrls": [], "resultsLimit": 500, "timeoutSeconds": 45 } ```` ### Output Each place you supply produces one row. Nested fields hold the matching readings, and values that Weather.com does not publish for a given place come back as `null`, so your dataset stays rectangular. #### Example output ```json { "queryInput": "Austin, TX", "placeCode": "f370fc9f1e5d07401a72fab32be4e1abe8f8f9df412cbaef3110e44cbf45cc56", "sourceUrl": "https://weather.com/weather/today/l/f370fc9f1e5d07401a72fab32be4e1abe8f8f9df412cbaef3110e44cbf45cc56", "placeName": "Austin, TX", "geoLat": 30.27, "geoLng": -97.74, "collectedAt": "2026-06-30T14:00:00.000000Z", "liveConditions": { "temperature": 91, "feelsLike": 97, "temperatureMaxSinceMidnight": 93, "temperatureMinSinceMidnight": 74, "humidity": 48, "windSpeed": 9, "windGust": null, "windDirection": 160, "windDirectionCardinal": "SSE", "uvIndex": 8, "uvCategory": "Very High", "visibility": 10.0, "pressure": 29.92, "pressureTendency": "Falling", "dewPoint": 68, "weatherPhrase": "Partly Cloudy", "relativeHumidity": 48 }, "airQualityReport": { "aqiValue": 42, "aqiCategory": "Good", "primaryPollutant": "Ozone", "advisoryMessage": "Air quality is satisfactory and poses little or no risk." }, "hourlyOutlook": [ { "time": "2026-06-30T15:00:00-0500", "epochTime": 1782849600, "temperature": 92, "feelsLike": 98, "weatherPhrase": "Sunny", "precipChance": 5, "precipType": "rain", "humidity": 45, "windSpeed": 10, "windDirectionCardinal": "S", "uvIndex": 7 } ], "dailyOutlook": [ { "dayOfWeek": "Tuesday", "date": "2026-06-30T07:00:00-0500", "epochTime": 1782820800, "temperatureMax": 94, "temperatureMin": 73, "weatherPhraseDay": "Sunny", "weatherPhraseNight": "Clear", "precipChanceDay": 10, "precipChanceNight": 0, "windSpeedDay": 10, "windSpeedNight": 7, "humidityDay": 46, "humidityNight": 62, "sunrise": "2026-06-30T06:31:00-0500", "sunset": "2026-06-30T20:36:00-0500", "moonPhase": "Waxing Gibbous" } ] } ``` #### Output fields | Field | Type | Description | |-------|------|-------------| | `queryInput` | string | The place name, code, or URL you supplied for this row | | `placeCode` | string | Weather.com place ID resolved for the location | | `sourceUrl` | string | Weather.com forecast page that was read | | `placeName` | string | Display name of the resolved location | | `geoLat` | number | Latitude of the place | | `geoLng` | number | Longitude of the place | | `collectedAt` | string | ISO timestamp of when the row was captured | | `liveConditions` | object | Current readings: temperature, feels-like, humidity, wind, UV, visibility, pressure, dew point, and weather phrase | | `airQualityReport` | object | AQI value, category, lead pollutant, and advisory text | | `hourlyOutlook` | array | Per-hour forecast with temperature, precipitation, humidity, wind, and UV | | `dailyOutlook` | array | Per-day forecast with highs, lows, rain chance, wind, humidity, sunrise, sunset, and moon phase | ### Tips for best results - **Start with a couple of places.** Run two or three before a big batch so any URL-format or lookup issues show up early. - **Use place codes for exact matches.** A name like "Springfield" can resolve to the wrong city; a `placeCode` or `pageUrl` pins it down. - **Keep test runs small with `resultsLimit`.** Hold it low while you confirm the output fits your pipeline, then raise it for the full list. - **Raise `timeoutSeconds`** to around 60 if you see requests timing out on slower connections. - **Expect some `null` values.** Air quality, gusts, and parts of the long-range forecast are not published for every place, so those fields can be empty. ### How can I use Weather.com weather data? **How can I use the Weather Data Scraper to pull forecasts for many cities at once?** Drop a list of city names into `placeQueries` (or codes into `placeCodes`) and the scraper returns one row per place, each holding live conditions, air quality, and the hourly and daily outlooks. Export the whole set to CSV or Excel and you have a side-by-side weather table without copying anything from a webpage. **How can I get Weather.com data without signing up for a weather API?** Paste a forecast URL or a place name and run the actor. It reads the public Weather.com forecast page and hands back structured fields: temperature, humidity, wind, UV, AQI, and multi-day outlooks. You skip API keys, rate plans, and quota dashboards. Set `resultsLimit` to control how much you scrape and you pay only for the rows you collect. **How can I track air quality across several locations?** Feed in the places you care about and read the `airQualityReport` field on each row: the AQI value, its category, the main pollutant, and any advisory message. Re-run the actor on a schedule and you build a running air-quality log across every city on your list. **How can I add a weather feed to a dashboard or report?** Run the scraper for a fixed set of places and connect the dataset to your dashboard or BI tool. Because the field shape stays the same, temperature, precipitation chance, and conditions line up identically on every refresh, so your charts and tables keep working as the numbers update. ### Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses or private contact information. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). ### Support Questions, feature requests, or a field you'd like added? Reach out at and we'll get back to you. # Actor input Schema ## `locations` (type: `array`): List of cities, counties, or regions to search and extract weather data for (e.g., 'Dhaka', 'Marion County, FL', 'London'). ## `locationCodes` (type: `array`): List of raw Weather.com location codes (e.g., 'f370fc9f1e5d07401a72fab32be4e1abe8f8f9df412cbaef3110e44cbf45cc56'). Use this for precise mapping. ## `urls` (type: `array`): List of full Weather.com URLs (e.g., 'https://weather.com/weather/today/l/f370fc9f1e5d07401a72fab32be4e1abe8f8f9df412cbaef3110e44cbf45cc56'). ## `maxItems` (type: `integer`): Maximum number of weather profiles/locations to extract. ## `requestTimeoutSecs` (type: `integer`): The timeout in seconds for each HTTP request to the integrated proxy bypass network. ## Actor input object example ```json { "locations": [ "Dhaka", "Marion County, FL" ], "locationCodes": [], "urls": [], "maxItems": 1000, "requestTimeoutSecs": 30 } ``` # 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 = { "locations": [ "Dhaka", "Marion County, FL" ], "locationCodes": [], "urls": [] }; // Run the Actor and wait for it to finish const run = await client.actor("data_api/weather-data-scraper-cheap").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 = { "locations": [ "Dhaka", "Marion County, FL", ], "locationCodes": [], "urls": [], } # Run the Actor and wait for it to finish run = client.actor("data_api/weather-data-scraper-cheap").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 '{ "locations": [ "Dhaka", "Marion County, FL" ], "locationCodes": [], "urls": [] }' | apify call data_api/weather-data-scraper-cheap --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=data_api/weather-data-scraper-cheap", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Weather Data Scraper (Cheap)", "description": "Extract comprehensive current weather conditions, 24-48h hourly forecasts, 8-15d daily forecasts, and EPA air quality indices from Weather.com by location name, zip code, or URL. Features premium proxy bypass.", "version": "0.0", "x-build-id": "cdx8hQ3b2kSeNYdE5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_api~weather-data-scraper-cheap/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_api-weather-data-scraper-cheap", "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/data_api~weather-data-scraper-cheap/runs": { "post": { "operationId": "runs-sync-data_api-weather-data-scraper-cheap", "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/data_api~weather-data-scraper-cheap/run-sync": { "post": { "operationId": "run-sync-data_api-weather-data-scraper-cheap", "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": "Locations (City, County, Region Names)", "type": "array", "description": "List of cities, counties, or regions to search and extract weather data for (e.g., 'Dhaka', 'Marion County, FL', 'London').", "items": { "type": "string" } }, "locationCodes": { "title": "Location Codes", "type": "array", "description": "List of raw Weather.com location codes (e.g., 'f370fc9f1e5d07401a72fab32be4e1abe8f8f9df412cbaef3110e44cbf45cc56'). Use this for precise mapping.", "items": { "type": "string" } }, "urls": { "title": "Weather.com URLs", "type": "array", "description": "List of full Weather.com URLs (e.g., 'https://weather.com/weather/today/l/f370fc9f1e5d07401a72fab32be4e1abe8f8f9df412cbaef3110e44cbf45cc56').", "items": { "type": "string" } }, "maxItems": { "title": "Max Items", "minimum": 1, "type": "integer", "description": "Maximum number of weather profiles/locations to extract.", "default": 1000 }, "requestTimeoutSecs": { "title": "Request Timeout (Seconds)", "minimum": 5, "type": "integer", "description": "The timeout in seconds for each HTTP request to the integrated proxy bypass network.", "default": 30 } } }, "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 } } } } } } } } } } ```