{ "openapi": "3.0.1", "info": { "title": "US Nonprofit Search — IRS Form 990 Financials", "description": "Search 1.8 million US tax-exempt organisations by name, state, cause area and 501(c) subsection, then pull the Form 990 financials the IRS holds for each one: revenue, expenses, assets, liabilities, contributions, officer pay, year by year. Free IRS data through ProPublica Nonprofit.", "version": "0.1", "x-build-id": "Rgck0xj1cOLzycKqM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dalbian~nonprofit-990-financials/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dalbian-nonprofit-990-financials", "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/dalbian~nonprofit-990-financials/runs": { "post": { "operationId": "runs-sync-dalbian-nonprofit-990-financials", "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/dalbian~nonprofit-990-financials/run-sync": { "post": { "operationId": "run-sync-dalbian-nonprofit-990-financials", "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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "One search per line — an organisation name, a cause, a city. 'food bank', 'humane society', 'community foundation'. Leave this empty and set a state or a cause area below to browse everything registered there instead of searching for words.", "default": [ "food bank" ], "items": { "type": "string" } }, "eins": { "title": "Or: EINs", "type": "array", "description": "Employer Identification Numbers to look up directly, one per line. Either form works: 53-0196605 or 530196605. Use this when you already know the organisation and want its filings rather than a search.", "items": { "type": "string" } }, "state": { "title": "State", "type": "string", "description": "Two-letter US Postal Service abbreviation — VT, CA, NY. The state on the IRS registration, which is where the organisation files, not necessarily where it operates." }, "nteeCategory": { "title": "Cause area", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10" ], "type": "string", "description": "NTEE major group, the IRS classification of what the organisation does. Human services is the largest group by far and covers food, housing, youth and emergency relief." }, "subsectionCode": { "title": "Tax-exempt subsection", "enum": [ "3", "4", "5", "6", "7", "8", "9", "10", "13", "19" ], "type": "string", "description": "Which part of section 501(c) the organisation is exempt under. 501(c)(3) is the one donations are deductible against; 501(c)(4) is the advocacy category where they are not." }, "minRevenue": { "title": "Minimum total revenue", "minimum": 0, "type": "integer", "description": "Drop organisations whose most recent filing reports less total revenue than this, in US dollars. Applied after the filing is fetched, so it filters the output rather than the search. Organisations with no filed financials at all are dropped when this is set." }, "includeFilings": { "title": "Include one row per filing year", "type": "boolean", "description": "Add a separate row for every year of financials, not just the latest. This is what you want for a trend — most organisations have ten to thirteen years on file. Off by default because it multiplies the row count.", "default": false }, "maxFilingsPerOrg": { "title": "Maximum filing years per organisation", "minimum": 1, "maximum": 30, "type": "integer", "description": "Cap on filing rows per organisation, most recent year first.", "default": 10 }, "maxResultsPerSearch": { "title": "Maximum results per search", "minimum": 1, "maximum": 6000, "type": "integer", "description": "How many organisations to return for each search term. Every result costs one extra request because the search itself carries no financials, so this is the setting that drives run time. The API stops at 10 000 results per query.", "default": 50 } } }, "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 } } } } } } } } } }