# FDIC FFIEC Bank Institutions Scraper - US Banks Data (`parseforge/ffiec-bank-institutions-scraper`) Actor
Gather live and historical financial records from Ffiec Bank Institutions including symbol, price, change, volume, market cap and fundamentals when published. Loved by traders, analysts and quantitative research teams. Run on demand or on a recurring schedule and feed every row into your favourit.
- **URL**: https://apify.com/parseforge/ffiec-bank-institutions-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** News, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
Pay per usage
This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage
## 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
## ๐ฆ FFIEC Bank Institutions Scraper
> ๐ **Pull FFIEC Bank Institutions data in seconds.** Pull US bank institution records with name, city, state, cert number, asset size and regulatory class.
> ๐ **Last updated** 2026-05-27 ยท **๐ 12 fields** per record ยท **Public source** ยท **No login required**
The FFIEC Bank Institutions Scraper turns the public FFIEC feed into clean, structured rows you can route to a warehouse, dashboard or downstream pipeline. No login, no manual copy-paste.
It is built for analysts, researchers and product teams who need the same data the source publishes, only normalised and ready to query.
| ๐ฏ Target Audience | ๐ก Primary Use Cases |
|---|---|
| Researchers | Build longitudinal datasets for analysis |
| Compliance teams | Monitor regulated entities and filings |
| Journalists | Investigate public records at scale |
| Data analysts | Power BI dashboards and reports |
| Academic teams | Run quantitative studies on public data |
| Product teams | Embed live FFIEC records into apps |
### ๐ What the FFIEC Bank Institutions Scraper does
- Queries FFIEC for the latest records
- Supports targeted filtering via the input parameters
- Returns structured records with 12 fields, no scraping artifacts
- Handles pagination automatically up to your `maxItems` limit
- Cleans HTML entities and normalises dates and identifiers
- Delivers results to the Apify dataset, ready to query
> ๐ก **Why it matters** Public data sources rarely offer bulk access. This Actor turns the live source into a queryable dataset.
### ๐ฌ Full Demo
_๐ง Coming soon_
### โ๏ธ Input
Field
Type
Required
Description
maxItems
integer
No
Free users 10. Paid users optional, max 1,000,000.
**Example 1, default run (preview)**
````
{
"maxItems": 10
}
```
**Example 2, larger pull**
```
{
"maxItems": 100
}
````
> โ ๏ธ **Good to Know** Free users are limited to 10 items per run. Upgrade to a paid plan to unlock up to 1,000,000 items.
### ๐ Output
| Field | Type |
|---|---|
| name `name` | string |
| city `city` | string |
| state `state` | string |
| zip `zip` | string |
| cert `cert` | string |
| website `website` | string |
| bankClass `bankClass` | string |
| establishedDate `establishedDate` | string |
| asset `asset` | string |
| fdicRegion `fdicRegion` | string |
| ๐ Collected `scrapedAt` | string |
| โ Error `error` | string |
### โจ Why choose this Actor
| Feature | Detail |
|---|---|
| ๐ No login required | Public data only, no credentials needed |
| ๐ Targeted filtering | Search and filter via input parameters |
| ๐ 12 fields per record | Comprehensive coverage of FFIEC |
| ๐งน Clean output | Dates normalised, HTML stripped, arrays flattened |
| โก Fast | Direct source access without browser overhead |
| ๐ Auto-pagination | Retrieves results up to your maxItems |
| ๐ก๏ธ Retry logic | Multi-attempt retry with backoff for reliability |
### ๐ How it compares to alternatives
| Method | Speed | Scale | Structured Output | Free |
|---|---|---|---|---|
| **This Actor** | Fast | 1,000,000 records | Yes (12 fields) | 10 free, unlimited paid |
| Manual site search | Slow | Limited per session | No | Yes |
| Custom script | Variable | Unlimited | Requires dev work | Dev cost |
### ๐ How to use
1. **[Create a free Apify account](https://console.apify.com/sign-up?fpr=vmoqkp)**, includes $5 free credit
2. Open the **FFIEC Bank Institutions Scraper** actor page
3. Configure your input, set filters or leave defaults
4. Set `maxItems` (10 for a quick preview, higher for bulk pulls)
5. Click **Run** and wait for the dataset to populate
6. Review the dataset in the Apify console
### ๐ผ Business use cases
#### Compliance and Due Diligence
Teams use FFIEC data to verify entities, monitor regulatory status and feed downstream pipelines.
#### Market Research
Analysts map FFIEC records to understand market structure, competitive activity or regulatory trends.
#### Lead Generation
Sales teams enrich CRM records with FFIEC data to identify prospects and qualify leads.
#### Investigative Journalism
Reporters use bulk pulls to find patterns, anomalies and stories hidden in public records.
### ๐ Automating FFIEC Bank Institutions Scraper
Connect this Actor to your existing workflows using Apify integrations:
- **Make (Integromat)**, trigger a run on a schedule and push results to Google Sheets or a database
- **Zapier**, automatically send new records to Airtable, Notion or your CRM
- **Slack**, get notified when a monitored entity has new activity
- **Webhooks**, receive real-time notifications when a run completes
### ๐ Beyond business use cases
#### Academic Research
Study trends, behaviours and patterns in FFIEC records across time.
#### Civic Tech and Transparency
Civic-tech projects build dashboards on top of bulk pulls to surface public-interest insights.
#### Education
Educators use real FFIEC data to teach data analysis and domain knowledge.
#### Personal Research
Individuals, researchers, hobbyists, family historians, use bulk access to answer questions no single web search can.
### ๐ค Ask an AI assistant about this scraper
Paste a few sample records into ChatGPT, Claude or another AI assistant and ask it to summarise the dataset, explain fields, identify patterns or suggest filter combinations.
### โ Frequently Asked Questions
**๐ What does this Actor do?**
It pulls FFIEC records into a clean, queryable dataset.
**๐ How many records are available?**
The Actor reflects whatever the live source publishes at run time.
**๐ Do I need an account or API key?**
No. This Actor uses public sources that require no authentication.
**๐ How up-to-date is the data?**
The Actor queries the source live on every run.
**๐ Can I filter by specific fields?**
Yes, see the Input section above for all supported filters.
**โก How fast is the scraper?**
A typical 10-item preview completes in under 30 seconds.
**๐ Where do the results live?**
Records are stored in the Apify dataset attached to the run and can be queried via the Apify API.
**๐ Why are some fields null for certain records?**
Some fields are optional at the source. The Actor returns null rather than fabricating values.
**๐ Can I run this on a schedule?**
Yes, use the Apify scheduler or trigger via Make, Zapier or Webhooks.
**๐ฐ Is there a cost to use this Actor?**
Free users receive 10 records per run. [Create a paid account](https://console.apify.com/sign-up?fpr=vmoqkp) to unlock up to 1,000,000 records per run.
**๐ Does it cover the full source?**
Yes, see the coverage line above.
**๐ก๏ธ Is this Actor compliant?**
The Actor accesses only publicly available data, in line with the source's published terms of service.
### ๐ Integrate with any app
Send data from the Apify platform to:
**Spreadsheets and Databases**
Google Sheets, Airtable, Notion, PostgreSQL, MySQL, MongoDB
**Automation and Workflows**
Make (Integromat), Zapier, n8n, Pipedream, Activepieces
**Cloud Storage**
AWS S3, Google Cloud Storage, Azure Blob Storage, Dropbox
**APIs and Webhooks**
REST API, Webhooks, Apify API
### ๐ Recommended Actors
| Actor | Description |
|---|---|
| [OurAirports Global Airport Database Scraper](https://apify.com/parseforge/ourairports-scraper) | Pull worldwide airport data with ICAO and IATA codes |
| [FINRA BrokerCheck Scraper](https://apify.com/parseforge/finra-brokercheck-scraper) | Pull broker and firm registration data from FINRA |
| [Hacker News Stories Scraper](https://apify.com/parseforge/hackernews-stories-scraper) | Pull live Hacker News top stories with score and comments |
> ๐ก **Pro Tip** browse the complete [ParseForge collection](https://apify.com/parseforge) for more public-data scrapers.
**๐ Need Help?** [Open our contact form](https://tally.so/r/BzdKgA)
> **โ ๏ธ Disclaimer** Independent tool, not affiliated with FFIEC. Only publicly available data is collected.
# Actor input Schema
## `maxItems` (type: `integer`):
Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000
## `state` (type: `string`):
Filter by US state, e.g. CA, NY, TX. Leave blank for all states.
## `active` (type: `boolean`):
When true, return only active (non-closed) institutions.
## Actor input object example
```json
{
"maxItems": 10,
"active": true
}
````
# Actor output Schema
## `results` (type: `string`):
Scraped FFIEC Bank Institutions records
# 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/ffiec-bank-institutions-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/ffiec-bank-institutions-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/ffiec-bank-institutions-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=parseforge/ffiec-bank-institutions-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "FDIC FFIEC Bank Institutions Scraper - US Banks Data",
"description": "Gather live and historical financial records from Ffiec Bank Institutions including symbol, price, change, volume, market cap and fundamentals when published. Loved by traders, analysts and quantitative research teams. Run on demand or on a recurring schedule and feed every row into your favourit.",
"version": "0.1",
"x-build-id": "OfmctWwb7rvMPEqXb"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/parseforge~ffiec-bank-institutions-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-parseforge-ffiec-bank-institutions-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~ffiec-bank-institutions-scraper/runs": {
"post": {
"operationId": "runs-sync-parseforge-ffiec-bank-institutions-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~ffiec-bank-institutions-scraper/run-sync": {
"post": {
"operationId": "run-sync-parseforge-ffiec-bank-institutions-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": {
"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"
},
"state": {
"title": "State (2-letter abbr)",
"enum": [
"",
"AL",
"AK",
"AZ",
"AR",
"CA",
"CO",
"CT",
"DE",
"FL",
"GA",
"HI",
"ID",
"IL",
"IN",
"IA",
"KS",
"KY",
"LA",
"ME",
"MD",
"MA",
"MI",
"MN",
"MS",
"MO",
"MT",
"NE",
"NV",
"NH",
"NJ",
"NM",
"NY",
"NC",
"ND",
"OH",
"OK",
"OR",
"PA",
"RI",
"SC",
"SD",
"TN",
"TX",
"UT",
"VT",
"VA",
"WA",
"WV",
"WI",
"WY",
"DC",
"PR",
"GU",
"VI",
"AS",
"MP"
],
"type": "string",
"description": "Filter by US state, e.g. CA, NY, TX. Leave blank for all states."
},
"active": {
"title": "Only active banks",
"type": "boolean",
"description": "When true, return only active (non-closed) institutions.",
"default": true
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```