# FEMA Disaster Declarations Scraper (`parseforge/fema-disaster-scraper`) Actor Scrape FEMA disaster declarations with 27 fields per record. Get declaration dates, incident types, affected areas, program eligibility, FIPS codes, and closeout dates. Filter by state, incident type, and fiscal year across 60,000+ declarations. - **URL**: https://apify.com/parseforge/fema-disaster-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Developer tools, Automation, Other - **Stats:** 3 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $6.50 / 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 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 ![ParseForge Banner](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg) ## πŸŒͺ️ FEMA Disaster Declarations Scraper > πŸš€ Collect federal disaster declarations from FEMA with incident types, program flags, affected areas, and FIPS codes. 60,000+ historical records dating back to 1953, delivered in under a minute. > πŸ•’ Last updated: 2026-04-23 FEMA Disaster Declarations Scraper pulls structured disaster declaration records from the Federal Emergency Management Agency. Each record includes the disaster number, declaration string, declaration type (Major Disaster, Emergency, Fire Management), incident type, declaration date, incident begin and end dates, affected areas, FIPS state and county codes, FEMA region number, and program activation flags for Individual Assistance, Public Assistance, and Hazard Mitigation. You can filter by state, incident type, and fiscal year. Insurance analysts use this to model risk by analyzing historical disaster frequency and severity per region. Journalists investigate response patterns and declaration trends. Construction firms assess natural disaster exposure for project sites. Government agencies track program activations across regions and time periods. Researchers study climate impacts through decades of standardized federal disaster data. | Target | FEMA Disaster Declarations (1953 to present) | |--------|-------------------------------| | Use Cases | Insurance risk modeling, disaster pattern analysis, construction site assessment, emergency response research | --- ### πŸ“‹ What it does - πŸ“‹ **Declaration records.** Disaster numbers, declaration strings, titles, and types for every federal disaster. - 🌊 **Incident details.** Types (hurricane, flood, fire, tornado, earthquake), begin dates, and end dates. - πŸ›οΈ **Program flags.** Which FEMA programs were activated: Individual Assistance, Public Assistance, Hazard Mitigation. - πŸ“ **Geographic data.** State codes, FIPS codes, county codes, designated areas, and FEMA regions. - πŸ” **Filtering.** Narrow results by state, incident type, or fiscal year. Each record captures a single disaster declaration with 25+ fields covering what happened, when, where, and which federal programs were activated in response. > πŸ’‘ **Why it matters:** FEMA's website stores 60,000+ historical disaster declarations. Browsing and downloading them manually through the portal is slow. This actor delivers the full dataset in structured format, filtered to your needs, in seconds. --- ### 🎬 Full Demo _🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset._ --- ### βš™οΈ Input
InputTypeDefaultBehavior
statestring-Filter by US state code (e.g. TX, CA, FL). Leave empty for all states.
incidentTypestring-Filter by incident type: Fire, Flood, Hurricane, Tornado, Severe Storm, Earthquake, Winter Storm, Drought, and more.
fiscalYearinteger-Filter by fiscal year of declaration (e.g. 2024).
maxItemsinteger10Maximum records to return. Free users are limited to 10. Paid users can set up to 1,000,000.
**Example: hurricane declarations in Texas.** ```json { "state": "TX", "incidentType": "Hurricane", "maxItems": 100 } ```` **Example: all earthquake declarations nationwide.** ```json { "incidentType": "Earthquake", "maxItems": 500 } ``` > ⚠️ **Good to Know:** FEMA's dataset goes back to 1953 and contains over 60,000 declarations. A full download of all historical records finishes in under a minute. Use filters to narrow results to specific states, incident types, or fiscal years. *** ### πŸ“Š Output Each record contains **25+ fields**. Download as CSV, Excel, JSON, or XML. #### 🧾 Schema | Field | Type | Example | |---|---|---| | πŸ“‹ femaDeclarationString | string | `"DR-4586-TX"` | | πŸ”’ disasterNumber | integer | `4586` | | πŸ—ΊοΈ state | string | `"TX"` | | πŸ“„ declarationType | string | `"DR"` | | πŸ“… declarationDate | string | `"2024-05-15T00:00:00.000Z"` | | 🌊 incidentType | string | `"Hurricane"` | | πŸ“ declarationTitle | string | `"HURRICANE BERYL"` | | βœ… ihProgramDeclared | boolean | true | | βœ… paProgramDeclared | boolean | true | | βœ… hmProgramDeclared | boolean | true | | πŸ“… incidentBeginDate | string | `"2024-07-05T00:00:00.000Z"` | | πŸ“ designatedArea | string | `"Harris County"` | | πŸ”’ fipsStateCode | string | `"048"` | | πŸ”’ fipsCountyCode | string | `"201"` | | 🌐 region | integer | `6` | #### πŸ“¦ Sample records
πŸŒ€ Hurricane declaration in Texas ```json { "femaDeclarationString": "DR-4586-TX", "disasterNumber": 4586, "state": "TX", "declarationType": "DR", "declarationDate": "2024-05-15T00:00:00.000Z", "fyDeclared": 2024, "incidentType": "Hurricane", "declarationTitle": "HURRICANE BERYL", "ihProgramDeclared": true, "iaProgramDeclared": true, "paProgramDeclared": true, "hmProgramDeclared": true, "incidentBeginDate": "2024-07-05T00:00:00.000Z", "incidentEndDate": "2024-07-15T00:00:00.000Z", "designatedArea": "Harris County", "fipsStateCode": "048", "fipsCountyCode": "201", "region": 6, "scrapedAt": "2026-04-17T12:00:00.000Z" } ```
🌊 Flood declaration in California ```json { "femaDeclarationString": "DR-4699-CA", "disasterNumber": 4699, "state": "CA", "declarationType": "DR", "declarationDate": "2023-01-14T00:00:00.000Z", "fyDeclared": 2023, "incidentType": "Flood", "declarationTitle": "SEVERE WINTER STORMS AND FLOODING", "ihProgramDeclared": true, "iaProgramDeclared": true, "paProgramDeclared": true, "hmProgramDeclared": true, "incidentBeginDate": "2022-12-27T00:00:00.000Z", "incidentEndDate": "2023-03-15T00:00:00.000Z", "designatedArea": "Sacramento County", "fipsStateCode": "006", "fipsCountyCode": "067", "region": 9, "scrapedAt": "2026-04-17T12:00:00.000Z" } ```
πŸ”₯ Fire management declaration in Oregon ```json { "femaDeclarationString": "FM-5527-OR", "disasterNumber": 5527, "state": "OR", "declarationType": "FM", "declarationDate": "2024-08-10T00:00:00.000Z", "fyDeclared": 2024, "incidentType": "Fire", "declarationTitle": "BOOTLEG FIRE", "ihProgramDeclared": false, "iaProgramDeclared": false, "paProgramDeclared": false, "hmProgramDeclared": false, "incidentBeginDate": "2024-08-06T00:00:00.000Z", "incidentEndDate": "2024-08-25T00:00:00.000Z", "designatedArea": "Klamath County", "fipsStateCode": "041", "fipsCountyCode": "035", "region": 10, "scrapedAt": "2026-04-17T12:00:00.000Z" } ```
*** ### ✨ Why choose this Actor | | Capability | |---|---| | πŸ“‹ | **25+ fields per record.** Declaration details, program flags, incident dates, and FIPS codes. | | πŸ“… | **70+ years of history.** Declarations dating back to 1953 in a single dataset. | | πŸ” | **Three filter dimensions.** State, incident type, and fiscal year. | | πŸ›οΈ | **Program activation flags.** Know which FEMA programs (IA, PA, HM) were activated. | | πŸ“ | **FIPS codes.** State and county FIPS codes for GIS mapping and database joins. | | ⚑ | **Fast.** 60,000+ records in under a minute. | | πŸ“Š | **Structured output.** Ready for spreadsheets, databases, or mapping applications. | > FEMA has issued over 60,000 disaster declarations since 1953, covering hurricanes, floods, fires, tornadoes, earthquakes, and dozens of other incident types across all U.S. states and territories. *** ### πŸ“ˆ How it compares to alternatives | Approach | Cost | Coverage | Refresh | Setup | |---|---|---|---|---| | **⭐ FEMA Disaster Scraper** *(this Actor)* | $5 free credit, then pay-per-use | 60,000+ records, 25+ fields | **Live per run** | ⚑ 2 min | | FEMA website portal | Free | Full, limited export tools | Manual | Slow navigation | | Bulk data downloads | Free | Full, large files | Periodic | Technical setup | | Third-party data providers | $300+/month | Varies | Monthly | Days | Pick this actor when you need filtered FEMA data without navigating the portal or processing bulk download files. *** ### πŸš€ How to use 1. πŸ“ **Sign up.** [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes). 2. 🌐 **Open the Actor.** Go to the FEMA Disaster Declarations Scraper page on the Apify Store. 3. 🎯 **Set input.** Choose state, incident type, fiscal year, and max items. 4. πŸš€ **Run it.** Click **Start** and let the Actor collect your data. 5. πŸ“₯ **Download.** Grab your results in the **Dataset** tab as CSV, Excel, JSON, or XML. > ⏱️ Total time from signup to downloaded dataset: **3-5 minutes.** No coding required. *** ### πŸ’Ό Business use cases
#### 🏦 Insurance and Risk - Model natural disaster risk by state and county - Analyze historical disaster frequency for underwriting - Track which regions have the most program activations - Build actuarial datasets from decades of declaration data #### πŸ—οΈ Construction and Real Estate - Assess natural disaster history for project sites - Check FIPS county codes for prior declarations - Evaluate flood, fire, and earthquake exposure by region - Support environmental impact assessments with federal data
#### πŸ“° Journalism and Advocacy - Investigate disaster response patterns and timelines - Compare declaration rates across states and incident types - Track program activation trends over fiscal years - Build data-driven stories about emergency management #### πŸŽ“ Research and Policy - Study climate change impacts through disaster frequency trends - Analyze federal emergency response policy effectiveness - Compare program activations across FEMA regions - Build longitudinal datasets for peer-reviewed studies
*** *** ### 🌟 Beyond business use cases Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.
#### πŸŽ“ Research and academia - Empirical datasets for papers, thesis work, and coursework - Longitudinal studies tracking changes across snapshots - Reproducible research with cited, versioned data pulls - Classroom exercises on data analysis and ethical scraping #### 🎨 Personal and creative - Side projects, portfolio demos, and indie app launches - Data visualizations, dashboards, and infographics - Content research for bloggers, YouTubers, and podcasters - Hobbyist collections and personal trackers
#### 🀝 Non-profit and civic - Transparency reporting and accountability projects - Advocacy campaigns backed by public-interest data - Community-run databases for local issues - Investigative journalism on public records #### πŸ§ͺ Experimentation - Prototype AI and machine-learning pipelines with real data - Validate product-market hypotheses before engineering spend - Train small domain-specific models on niche corpora - Test dashboard concepts with live input
### πŸ€– Ask an AI assistant about this scraper Open a ready-to-send prompt about this ParseForge actor in the AI of your choice: - πŸ’¬ [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20FEMA%20Disaster%20Declarations%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - 🧠 [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20FEMA%20Disaster%20Declarations%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - πŸ” [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20FEMA%20Disaster%20Declarations%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - πŸ…’ [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20FEMA%20Disaster%20Declarations%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) ### ❓ Frequently Asked Questions
πŸ’³ Do I need a paid Apify plan to run this actor? No. You can start right now on the free Apify plan, which includes **$5 in free monthly credit**. That is enough to run this actor several times and explore the output before committing to anything. Paid plans unlock higher limits, more concurrent runs, and larger datasets. [Create a free Apify account here](https://console.apify.com/sign-up?fpr=vmoqkp) to get started.
🚨 What happens if my run fails or returns no results? Failed runs are not charged. If the source site changes, proxies get rate-limited, or a specific input matches nothing, re-run the actor or open our [contact form](https://tally.so/r/BzdKgA) and we will investigate. You can also check the run log in the Apify console to see why the run stopped.
πŸ“ How many items can I scrape per run? Free users are limited to **10 items per run** so you can preview the output and confirm the actor works for your use case. Paid users can raise maxItems up to **1,000,000** per run. [Upgrade here](https://console.apify.com/sign-up?fpr=vmoqkp) if you need full scale.
πŸ•’ How fresh is the data? Every run fetches live data at the moment of execution. There is no cache or delay: the records you get reflect what the source returned at that moment. Schedule the actor to maintain a rolling snapshot of the data you need.
πŸ§‘β€πŸ’» Can I call this actor from my own code? Yes. Apify exposes every actor as a REST endpoint and ships first-class SDKs for [Node.js](https://docs.apify.com/sdk/js) and [Python](https://docs.apify.com/sdk/python). You can start a run, read the dataset, and handle webhooks from your own app in a few lines. All you need is your Apify API token.
πŸ“€ How do I export the data? Every Apify dataset can be downloaded in one click from the console as CSV, JSON, JSONL, Excel, HTML, XML, or RSS. You can also pull results programmatically via the [Apify API](https://docs.apify.com/api/v2) or stream them into BigQuery, S3, and other destinations through built-in integrations.
πŸ“… Can I schedule the actor to run automatically? Yes. Use the Apify scheduler to run the actor on any cadence, from hourly to monthly. Results are saved to your dataset and can be delivered to webhooks, email, Slack, cloud storage, or automation tools such as Zapier and Make. ***
### πŸ”Œ Automating FEMA Disaster Scraper Control the scraper programmatically for scheduled runs and pipeline integrations: - 🟒 **Node.js.** Install the apify-client NPM package. - 🐍 **Python.** Use the apify-client PyPI package. - πŸ“š See the [Apify API documentation](https://docs.apify.com/api/v2) for full details. The [Apify Schedules feature](https://docs.apify.com/platform/schedules) lets you trigger this Actor on any cron interval. Schedule weekly runs to monitor new disaster declarations as they are issued. ### πŸ”Œ Integrate with any app FEMA Disaster Scraper connects to any cloud service via [Apify integrations](https://apify.com/integrations): - [**Make**](https://docs.apify.com/platform/integrations/make) - Automate multi-step workflows - [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Connect with 5,000+ apps - [**Slack**](https://docs.apify.com/platform/integrations/slack) - Get run notifications - [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe data into your warehouse - [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits - [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export datasets straight to Sheets You can also use webhooks to trigger downstream actions when a run finishes. *** ### πŸ”— Recommended Actors - [**🌿 EPA TRI Scraper**](https://apify.com/parseforge/epa-tri-scraper) - Toxic release inventory data from the EPA - [**⚠️ CPSC Recalls Scraper**](https://apify.com/parseforge/cpsc-recalls-scraper) - Consumer product recall data - [**πŸ’° Grants.gov Scraper**](https://apify.com/parseforge/grants-gov-scraper) - Federal grant opportunities - [**πŸ“‹ GSA eLibrary Scraper**](https://apify.com/parseforge/gsa-elibrary-scraper) - Government contract and schedule data - [**✈️ FAA Aircraft Registry Scraper**](https://apify.com/parseforge/faa-aircraft-registry-scraper) - Aircraft registration lookup by N-number > πŸ’‘ **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more data scrapers and tools. *** **πŸ†˜ Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) to request a new scraper, propose a custom data project, or report an issue. *** > **⚠️ Disclaimer:** this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by FEMA, the U.S. Department of Homeland Security, or any federal agency. All trademarks mentioned are the property of their respective owners. Only publicly available data is collected. # Actor input Schema ## `state` (type: `string`): Filter by US state code (e.g. TX, CA, FL) ## `incidentType` (type: `string`): Filter by incident type ## `fiscalYear` (type: `integer`): Filter by fiscal year of declaration (e.g. 2024) ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## Actor input object example ```json { "maxItems": 10 } ``` # Actor output Schema ## `overview` (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 = { "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/fema-disaster-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 = { "maxItems": 10 } # Run the Actor and wait for it to finish run = client.actor("parseforge/fema-disaster-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 '{ "maxItems": 10 }' | apify call parseforge/fema-disaster-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/fema-disaster-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "FEMA Disaster Declarations Scraper", "description": "Scrape FEMA disaster declarations with 27 fields per record. Get declaration dates, incident types, affected areas, program eligibility, FIPS codes, and closeout dates. Filter by state, incident type, and fiscal year across 60,000+ declarations.", "version": "0.0", "x-build-id": "g2ZWwS3dX24zrSD7h" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~fema-disaster-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-fema-disaster-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/parseforge~fema-disaster-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-fema-disaster-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/parseforge~fema-disaster-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-fema-disaster-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": { "state": { "title": "State", "type": "string", "description": "Filter by US state code (e.g. TX, CA, FL)" }, "incidentType": { "title": "Incident Type", "enum": [ "Fire", "Flood", "Hurricane", "Tornado", "Severe Storm", "Earthquake", "Winter Storm", "Drought", "Coastal Storm", "Typhoon", "Snowstorm" ], "type": "string", "description": "Filter by incident type" }, "fiscalYear": { "title": "Fiscal Year", "type": "integer", "description": "Filter by fiscal year of declaration (e.g. 2024)" }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" } } }, "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 } } } } } } } } } } ```