# FDIC Bank Finder - Institution Search & Financial Data (`jungle_synthesizer/fdic-bank-crawler`) Actor Extract FDIC-insured bank and thrift institution data from the FDIC BankFind Suite API. Search by state, asset size, charter class, regulator, and active status. Returns institution profile, financial summary data (assets, deposits, equity, net income), and branch office count. No API key required. - **URL**: https://apify.com/jungle\_synthesizer/fdic-bank-crawler.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Business, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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 ## FDIC Bank Finder Crawler Pull FDIC-insured bank and thrift institution data from the public [FDIC BankFind Suite API](https://banks.data.fdic.gov). Returns institution profile, financial summary (assets, deposits, equity, net income, ROA, ROE), branch office count, charter class, and primary regulator for 27,000+ US institutions — active and historical. No API key required. --- ### FDIC Bank Crawler Features - Extracts 25 fields per institution including FDIC certificate number, Fed RSSD ID, and holding-company name - Returns financial summary as of the last reporting period — assets, deposits, equity, net income, ROA, ROE - Filter by state, charter class (N, SM, NM, OI, SB, SA), primary regulator (OCC, FED, FDIC, OTS), and asset-size range - Optional `activeOnly` flag — include or exclude failed/closed institutions - Sort by total assets, name, certificate number, state, or established date - No API key required, no proxy — the FDIC API is open and stable --- ### Who Uses FDIC Bank Data? - **Fintech sales and BD teams** — Build outreach lists of community banks filtered by asset size and state - **Compliance and risk teams** — Verify counterparty status (active, failed, merged) against the authoritative FDIC register - **Financial researchers** — Track consolidation trends, branch counts, and capital ratios across charter classes - **Investment analysts** — Screen banking sector peers by ROA, ROE, and asset size before deeper modelling - **GovTech and journalism** — Build public-interest dashboards on bank failures, branch closures, and CRA performance --- ### How the FDIC Bank Crawler Works 1. **Configure filters** — Pick state, charter class, regulator, asset-size band, and active/historical scope. 2. **Hit the BankFind API** — The crawler queries `banks.data.fdic.gov/api/institutions` with your filters and the requested sort order. 3. **Paginate** — FDIC's API returns up to 10,000 records per query. The crawler pages through until it has `maxItems` records or the result set ends. 4. **Export** — Each institution lands as a flat JSON record with profile, address, financials, and a direct profile-page URL. --- ### Input #### All active national banks in California ```json { "activeOnly": true, "state": "CA", "charterClass": "N", "sortBy": "ASSET", "maxItems": 0 } ```` #### Banks above $1B in assets ```json { "activeOnly": true, "minAssets": 1000000, "sortBy": "ASSET", "maxItems": 500 } ``` #### Historical / failed institutions in Texas ```json { "activeOnly": false, "state": "TX", "sortBy": "ESTYMD", "maxItems": 1000 } ``` | Field | Type | Default | Description | |-------|------|---------|-------------| | activeOnly | boolean | `true` | When true, returns only currently active FDIC-insured institutions. | | state | string | — | Two-letter state code (e.g. `CA`, `NY`, `TX`). Empty = all states. | | charterClass | string | — | `N`, `SM`, `NM`, `OI`, `SB`, or `SA`. Empty = all. | | regulator | string | — | `OCC`, `FED`, `FDIC`, or `OTS`. Empty = all. | | minAssets | integer | 0 | Minimum total assets in thousands of dollars (e.g. `1000000` = $1B). | | maxAssets | integer | 0 | Maximum total assets in thousands. `0` disables the upper bound. | | sortBy | string | `ASSET` | `ASSET`, `NAME`, `CERT`, `STALP`, or `ESTYMD`. | | maxItems | integer | 10 | Cap on records. `0` = unlimited (up to 27,849). | *** ### FDIC Bank Crawler Output Fields ```json { "fdic_cert": 3511, "institution_name": "JPMorgan Chase Bank, National Association", "city": "Columbus", "state": "OH", "zip": "43240", "address": "1111 Polaris Parkway", "county": "Delaware", "established_date": "01/01/1824", "last_report_date": "12/31/2024", "active": true, "charter_class": "N", "regulator": "OCC", "insured_date": "01/01/1934", "total_assets_thousands": 3500000000, "total_deposits_thousands": 2500000000, "total_equity_thousands": 310000000, "net_income_thousands": 42000000, "return_on_assets": 1.21, "return_on_equity": 13.45, "number_of_offices": 4842, "website_url": "https://www.jpmorganchase.com", "fed_rssd_id": 852218, "holding_company": "JPMorgan Chase & Co", "specialization_group": 1, "fdic_profile_url": "https://banks.data.fdic.gov/explore/historical/?searchText=3511" } ``` | Field | Type | Description | |-------|------|-------------| | fdic\_cert | integer | FDIC Certificate Number — unique institution identifier | | institution\_name | string | Full legal name | | city | string | Main office city | | state | string | Two-letter state code | | zip | string | Main office ZIP | | address | string | Street address of the main office | | county | string | County | | established\_date | string | Date the institution was established (MM/DD/YYYY) | | last\_report\_date | string | Most recent financial report date | | active | boolean | Currently active and FDIC-insured | | charter\_class | string | `N`, `SM`, `NM`, `SB`, `SA`, `OI` | | regulator | string | Primary federal regulator | | insured\_date | string | Date FDIC insurance began | | total\_assets\_thousands | integer | Total assets, in thousands of dollars | | total\_deposits\_thousands | integer | Total deposits, in thousands of dollars | | total\_equity\_thousands | string | Total equity capital, in thousands of dollars | | net\_income\_thousands | integer | Net income for the most recent reporting period | | return\_on\_assets | number | ROA as a percentage | | return\_on\_equity | number | ROE as a percentage | | number\_of\_offices | integer | Total domestic offices/branches | | website\_url | string | Institution website URL | | fed\_rssd\_id | integer | Federal Reserve RSSD identifier | | holding\_company | string | Parent holding company, when applicable | | specialization\_group | integer | FDIC specialization group code | | fdic\_profile\_url | string | Direct URL to the institution's FDIC BankFind profile | *** ### FAQ #### How do I get FDIC bank data without an API key? FDIC Bank Crawler hits the public `banks.data.fdic.gov` API, which doesn't require authentication. Configure filters, set `maxItems`, and run. The actor handles pagination and assembles flat records. #### How much does this actor cost to run? FDIC Bank Crawler uses pay-per-event pricing on the `default_2603_basic` profile at a 1.0x coefficient. No proxy fees. Pulling all 4,000+ active US banks costs cents in platform fees. #### What does charter class mean? FDIC Bank Crawler returns charter class as a code: `N` (National Bank), `SM` (State Member Bank), `NM` (State Non-Member Bank), `SB` (State Savings Bank), `SA` (Savings Association), `OI` (OTS-Insured Institution). Filter by class with the `charterClass` input, or keep them all and segment downstream. #### Can I get failed or historical institutions? FDIC Bank Crawler accepts an `activeOnly` flag. Turn it off and you get historical and failed institutions alongside active ones. Useful for studying merger waves, bank failures during specific years, or building a full sector history. #### Does this actor need proxies? FDIC Bank Crawler runs proxy-free. The FDIC API is open and reliable; the actor paces requests within its published limits. *** ### Need More Features? Need branch-level office data, Call Report financial detail beyond the summary, or CRA performance ratings? [Open an issue](https://console.apify.com/actors/issues) or get in touch. ### Why Use FDIC Bank Crawler? - **Authoritative source** — Hits the FDIC BankFind Suite API directly. No middleman, no stale exports. - **Filter where it counts** — Asset-size band, charter class, regulator, and state all apply server-side, so you don't waste records you can't use. - **Joinable IDs** — Returns both FDIC certificate number and Federal Reserve RSSD ID per institution, which lets you join to Y-9C, Call Report, and other Fed datasets without fuzzy name matching. # Actor input Schema ## `sp_intended_usage` (type: `string`): Please describe how you plan to use the data extracted by this crawler. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): Provide your email address so we can get in touch with you. ## `activeOnly` (type: `boolean`): When enabled, only return currently active FDIC-insured institutions. Disable to include historical/failed banks. ## `state` (type: `string`): Filter by state abbreviation (e.g., 'CA', 'NY', 'TX'). Leave empty to return institutions from all states. ## `charterClass` (type: `string`): Filter by institution charter class. N=National Bank, SM=State Member Bank, NM=State Non-Member Bank, OI=OTS-Insured Institution, SB=State Savings Bank, SA=Savings Association. ## `regulator` (type: `string`): Filter by primary federal regulator. ## `minAssets` (type: `integer`): Filter to institutions with at least this many thousands of dollars in total assets. Example: 1000000 = $1 billion. ## `maxAssets` (type: `integer`): Filter to institutions with at most this many thousands of dollars in total assets. Leave at 0 to disable this filter. ## `sortBy` (type: `string`): Field to sort results by. ## `maxItems` (type: `integer`): Maximum number of institutions to return. The FDIC database contains 27,000+ total institutions (4,000+ active). Set to 0 for no limit. ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "activeOnly": true, "sortBy": "ASSET", "maxItems": 10 } ``` # Actor output Schema ## `results` (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 = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "activeOnly": true, "state": "", "charterClass": "", "regulator": "", "minAssets": 0, "maxAssets": 0, "sortBy": "ASSET", "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/fdic-bank-crawler").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 = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "activeOnly": True, "state": "", "charterClass": "", "regulator": "", "minAssets": 0, "maxAssets": 0, "sortBy": "ASSET", "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/fdic-bank-crawler").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 '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "activeOnly": true, "state": "", "charterClass": "", "regulator": "", "minAssets": 0, "maxAssets": 0, "sortBy": "ASSET", "maxItems": 10 }' | apify call jungle_synthesizer/fdic-bank-crawler --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/fdic-bank-crawler", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "FDIC Bank Finder - Institution Search & Financial Data", "description": "Extract FDIC-insured bank and thrift institution data from the FDIC BankFind Suite API. Search by state, asset size, charter class, regulator, and active status. Returns institution profile, financial summary data (assets, deposits, equity, net income), and branch office count. No API key required.", "version": "0.1", "x-build-id": "RAGoClARaAFQTpnjG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~fdic-bank-crawler/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-fdic-bank-crawler", "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/jungle_synthesizer~fdic-bank-crawler/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-fdic-bank-crawler", "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/jungle_synthesizer~fdic-bank-crawler/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-fdic-bank-crawler", "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", "required": [ "maxItems" ], "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact Email", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "activeOnly": { "title": "Active Institutions Only", "type": "boolean", "description": "When enabled, only return currently active FDIC-insured institutions. Disable to include historical/failed banks.", "default": true }, "state": { "title": "State", "type": "string", "description": "Filter by state abbreviation (e.g., 'CA', 'NY', 'TX'). Leave empty to return institutions from all states." }, "charterClass": { "title": "Charter Class", "enum": [ "", "N", "SM", "NM", "OI", "SB", "SA" ], "type": "string", "description": "Filter by institution charter class. N=National Bank, SM=State Member Bank, NM=State Non-Member Bank, OI=OTS-Insured Institution, SB=State Savings Bank, SA=Savings Association." }, "regulator": { "title": "Primary Regulator", "enum": [ "", "OCC", "FED", "FDIC", "OTS" ], "type": "string", "description": "Filter by primary federal regulator." }, "minAssets": { "title": "Minimum Total Assets (thousands)", "minimum": 0, "type": "integer", "description": "Filter to institutions with at least this many thousands of dollars in total assets. Example: 1000000 = $1 billion." }, "maxAssets": { "title": "Maximum Total Assets (thousands)", "minimum": 0, "type": "integer", "description": "Filter to institutions with at most this many thousands of dollars in total assets. Leave at 0 to disable this filter." }, "sortBy": { "title": "Sort By", "enum": [ "ASSET", "NAME", "CERT", "STALP", "ESTYMD" ], "type": "string", "description": "Field to sort results by.", "default": "ASSET" }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 27849, "type": "integer", "description": "Maximum number of institutions to return. The FDIC database contains 27,000+ total institutions (4,000+ active). Set to 0 for no limit.", "default": 10 } } }, "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 } } } } } } } } } } ```