# FDIC BankFind Scraper for Financial Data (`maximedupre/fdic-bankfind`) Actor

Retrieve current FDIC BankFind records for U.S. banks and thrifts in one run. Choose institution searches, certificate or quarterly financial records, failures, branches, structure events, or industry summaries. Get normalized rows with financial data and an FDIC source URL.

- **URL**: https://apify.com/maximedupre/fdic-bankfind.md
- **Developed by:** [Maxime Dupré](https://apify.com/maximedupre) (community)
- **Categories:** Business, Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.90 / 1,000 institution profiles

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/actors/running/actors-in-store.md#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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

### 🏦 Find FDIC BankFind Records

For analysts, compliance teams, researchers, and developers who need public U.S. bank data, this Actor retrieves current FDIC BankFind records and saves normalized institution, financial, failure, branch, structure, and industry rows with source links. Choose one target and the filters you need for research, due diligence, and data workflows.

**Use cases**

- Use [**FDIC Industry Summaries**](https://apify.com/maximedupre/fdic-bankfind/examples/fdic-industry-summaries) to review aggregate bank data for a reporting period, state or territory, and charter class.
- Find branch addresses, coordinates, and services with [**FDIC Branch Locations**](https://apify.com/maximedupre/fdic-bankfind/examples/fdic-branch-locations).
- Review dates, resolution details, and estimated costs with [**FDIC Bank Failures**](https://apify.com/maximedupre/fdic-bankfind/examples/fdic-bank-failures).
- Pull quarter-end assets, deposits, equity, income, ROA, and ROE with [**FDIC Quarterly Financial Records**](https://apify.com/maximedupre/fdic-bankfind/examples/fdic-quarterly-financial-records).
- Look up one institution and its available history with [**FDIC Certificate Lookup**](https://apify.com/maximedupre/fdic-bankfind/examples/fdic-certificate-lookup).
- Filter and sort institution profiles with [**FDIC Bank Search**](https://apify.com/maximedupre/fdic-bankfind/examples/fdic-bank-search).
- Build a filtered [**List of National Banks**](https://apify.com/maximedupre/fdic-bankfind/examples/list-of-national-banks) from institution records.
- Review aggregate deposits by the available FDIC summary filters with [**FDIC Summary of Deposits**](https://apify.com/maximedupre/fdic-bankfind/examples/fdic-summary-of-deposits).
- Sort institution results by total assets to make a [**Top 20 Banks in USA**](https://apify.com/maximedupre/fdic-bankfind/examples/top-20-banks-in-usa) list.

#### 📊 Normalized FDIC BankFind data

**What it returns**

Each dataset row is one normalized FDIC record for the target selected in the run. Depending on that target, a row can describe an institution, a quarterly financial report, a bank failure, a branch, a structure event, or an industry summary. The row keeps a usable FDIC `sourceUrl`, and unavailable source values are returned as `null` instead of being invented.

The Actor reads the public FDIC source at run time. It covers FDIC-insured U.S. banks and thrifts, not credit unions or other non-FDIC datasets.

#### ▶️ Choose one FDIC target

**How to run**

1. Choose one target: Institution search, Certificate lookup, Quarterly financial records, Bank failures, Branch locations, Institution structure history, or Industry summaries.
2. Add only the filters that apply to that target. Fields for other targets are ignored.
3. Set `maxItems` when you want a limit. Leave it empty to get all available results until the source is exhausted.
4. Start the Actor and open the default dataset when the run finishes.

Each run uses one target and one filter configuration; it does not combine several independent searches.

#### ⚙️ Input

Choose one target per run. `maxItems` is the Actor Work Limit: leaving it empty returns all available results until the source is exhausted.

**Input fields**

| Field | Type | What it does |
| --- | --- | --- |
| `target` | string | Chooses the FDIC data target for this run: Institution search, Certificate lookup, Quarterly financial records, Bank failures, Branch locations, Institution structure history, or Industry summaries. |
| `institutionName` | string | For Institution search, enters all or part of an institution name. |
| `activeOnly` | boolean | For Institution search, keeps active institutions only when on. Turn it off to include inactive and historical institutions. |
| `minimumAssets` | number | For Institution search, keeps institutions with total assets at or above this amount in USD. |
| `maximumAssets` | number | For Institution search, keeps institutions with total assets at or below this amount in USD. |
| `primaryRegulators` | string\[] | For Institution search, keeps institutions with one or more of these primary regulator names. |
| `resultOrder` | string | For Institution search, sorts results by institution name, total assets, total deposits, net income, return on assets, or return on equity. |
| `certificateId` | integer | For Certificate lookup and Quarterly financial records, selects one FDIC certificate ID. |
| `reportingPeriod` | date string | For Quarterly financial records and Industry summaries, selects a reporting date such as `2024-12-31`. |
| `statesOrTerritories` | string\[] | For Institution search, Bank failures, Branch locations, and Industry summaries, keeps one or more U.S. states or territories. Other targets ignore this field. |
| `charterClasses` | string\[] | For Institution search and Industry summaries, keeps one or more charter classifications. Other targets ignore this field. |
| `maxItems` | integer | Stops after this many returned items. For Certificate lookup, it also limits quarterly financial periods. Leave it empty to get all available results until the source is exhausted. |

**Example input**

This is the public input from a successful run:

```json
{
  "target": "institutionSearch",
  "activeOnly": true,
  "resultOrder": "institutionName",
  "maxItems": 100
}
```

#### 🧾 Output

The default dataset contains normalized rows. The selected target determines the row shape. Nested paths use `.`; `[]` means each member of an array. A value can be `null` when the FDIC source does not publish it.

**Output link**

| Field | Type | What it does |
| --- | --- | --- |
| `dataset` | URL string | Links to the normalized rows from the selected FDIC target in the default dataset. |

**Institution record**

| Field | Type | What it does |
| --- | --- | --- |
| `recordType` | string | Identifies this row as `institution`. |
| `institutionName` | string | Gives the FDIC-insured institution name. |
| `fdicCertificateId` | integer or null | Gives the institution's FDIC certificate ID. |
| `institutionType` | string or null | Gives the FDIC source classification. |
| `location` | object or null | Holds the published institution location. |
| `location.addressLine1` | string or null | Gives the first street address line. |
| `location.addressLine2` | string or null | Gives the second street address line when published. |
| `location.city` | string or null | Gives the city. |
| `location.stateOrTerritory` | string or null | Gives the U.S. state or territory. |
| `location.postalCode` | string or null | Gives the postal code. |
| `status` | string or null | Gives the current or historical status reported by the FDIC. |
| `establishedDate` | date string or null | Gives the institution's established date when published. |
| `websiteUrl` | URL string or null | Links to the institution website when published. |
| `charterClass` | string or null | Gives the institution charter classification. |
| `primaryRegulator` | string or null | Gives the primary regulator reported by the FDIC. |
| `specialization` | string or null | Gives the institution specialization. |
| `holdingCompany` | string or null | Gives the holding company name when reported. |
| `officeCount` | integer or null | Gives the number of offices reported for the institution. |
| `latestFinancialSummary` | object or null | Holds the latest available financial summary. |
| `latestFinancialSummary.reportingPeriod` | date string or null | Gives the quarter-end date for the summary. |
| `latestFinancialSummary.totalAssets` | number or null | Gives total assets in USD for the period. |
| `latestFinancialSummary.totalDeposits` | number or null | Gives total deposits in USD for the period. |
| `latestFinancialSummary.totalEquity` | number or null | Gives total equity in USD for the period. |
| `latestFinancialSummary.netIncome` | number or null | Gives net income in USD for the period. |
| `latestFinancialSummary.returnOnAssets` | number or null | Gives return on assets as a percent for the period. |
| `latestFinancialSummary.returnOnEquity` | number or null | Gives return on equity as a percent for the period. |
| `quarterlyFinancials` | array of objects | Lists quarterly financial summaries returned for the institution. |
| `quarterlyFinancials[].reportingPeriod` | date string or null | Gives the quarter-end date for one quarterly summary. |
| `quarterlyFinancials[].totalAssets` | number or null | Gives total assets in USD for one quarterly summary. |
| `quarterlyFinancials[].totalDeposits` | number or null | Gives total deposits in USD for one quarterly summary. |
| `quarterlyFinancials[].totalEquity` | number or null | Gives total equity in USD for one quarterly summary. |
| `quarterlyFinancials[].netIncome` | number or null | Gives net income in USD for one quarterly summary. |
| `quarterlyFinancials[].returnOnAssets` | number or null | Gives return on assets as a percent for one quarterly summary. |
| `quarterlyFinancials[].returnOnEquity` | number or null | Gives return on equity as a percent for one quarterly summary. |
| `sourceUrl` | URL string | Links to the FDIC source used for the row. |

**Example institution row**

This genuine row shows an institution profile with its latest financial summary and one quarterly financial value:

```json
{
  "recordType": "institution",
  "institutionName": "JPMorgan Chase Bank, National Association",
  "fdicCertificateId": 628,
  "institutionType": "OCC",
  "location": {
    "addressLine1": "1111 Polaris Pkwy",
    "addressLine2": null,
    "city": "Columbus",
    "stateOrTerritory": "Ohio",
    "postalCode": "43240"
  },
  "status": "active",
  "establishedDate": "1824-01-01",
  "websiteUrl": "https://www.jpmorganchase.com",
  "charterClass": "N",
  "primaryRegulator": "OCC",
  "specialization": "International Specialization",
  "holdingCompany": "JPMORGAN CHASE&CO",
  "officeCount": 5377,
  "latestFinancialSummary": {
    "reportingPeriod": "2026-03-31",
    "totalAssets": 4016571000,
    "totalDeposits": 2787994000,
    "totalEquity": 335931000,
    "netIncome": 13974000,
    "returnOnAssets": 1.438906517541693,
    "returnOnEquity": 16.64
  },
  "quarterlyFinancials": [
    {
      "reportingPeriod": "2026-03-31",
      "totalAssets": 4016571000,
      "totalDeposits": 2787994000,
      "totalEquity": 335931000,
      "netIncome": 13974000,
      "returnOnAssets": 1.438906517541693,
      "returnOnEquity": 16.64
    }
  ],
  "sourceUrl": "https://api.fdic.gov/banks/institutions?filters=CERT%3A628&fields=NAME%2CCERT%2CBKCLASS%2CCHRTAGNT%2CADDRESS%2CADDRESS2%2CCITY%2CSTNAME%2CSTALP%2CZIP%2CACTIVE%2CESTYMD%2CWEBADDR%2CREGAGNT%2CREGAGENT2%2CSPECGRP%2CSPECGRPN%2CNAMEHCR%2COFFICES%2CASSET%2CDEP%2CEQ%2CNETINC%2CROA%2CROE%2CREPDTE%2CID&limit=1&offset=0"
}
```

**Quarterly financial record**

| Field | Type | What it does |
| --- | --- | --- |
| `recordType` | string | Identifies this row as `financialReport`. |
| `institutionName` | string or null | Gives the institution name in the financial record. |
| `fdicCertificateId` | integer or null | Gives the institution FDIC certificate ID. |
| `reportingPeriod` | date string or null | Gives the quarter-end date for the values. |
| `totalAssets` | number or null | Gives total assets in USD for the period. |
| `totalDeposits` | number or null | Gives total deposits in USD for the period. |
| `totalEquity` | number or null | Gives total equity in USD for the period. |
| `netIncome` | number or null | Gives net income in USD for the period. |
| `returnOnAssets` | number or null | Gives return on assets as a percent for the period. |
| `returnOnEquity` | number or null | Gives return on equity as a percent for the period. |
| `sourceUrl` | URL string | Links to the FDIC source used for the row. |

**Example quarterly financial row**

This genuine row comes from a certificate-filtered quarterly financial run:

```json
{
  "recordType": "financialReport",
  "institutionName": "JPMORGAN CHASE BANK NA",
  "fdicCertificateId": 628,
  "reportingPeriod": "2026-03-31",
  "totalAssets": 4016571000,
  "totalDeposits": 2787994000,
  "totalEquity": 335931000,
  "netIncome": 13974000,
  "returnOnAssets": 1.438906517541693,
  "returnOnEquity": 16.64,
  "sourceUrl": "https://api.fdic.gov/banks/financials?filters=CERT%3A628+AND+REPDTE%3A20260331&fields=CERT%2CNAME%2CREPDTE%2CASSET%2CDEP%2CEQ%2CNETINC%2CROA%2CROE&sort_by=REPDTE&sort_order=DESC&limit=1&offset=0"
}
```

**Bank failure record**

| Field | Type | What it does |
| --- | --- | --- |
| `recordType` | string | Identifies this row as `bankFailure`. |
| `institutionName` | string or null | Gives the name of the failed institution. |
| `fdicCertificateId` | integer or null | Gives the failed institution FDIC certificate ID. |
| `failureDate` | date string or null | Gives the date the institution failed. |
| `resolution` | object or null | Holds the available FDIC resolution details. |
| `resolution.resolutionType` | string or null | Gives the reported resolution type. |
| `resolution.acquiringInstitutionName` | string or null | Gives the acquiring institution when published. |
| `estimatedCost` | number or null | Gives the estimated failure cost in USD when published. |
| `sourceUrl` | URL string | Links to the FDIC source used for the row. |

**Example bank failure row**

This genuine row shows a Texas failure and its published resolution details:

```json
{
  "recordType": "bankFailure",
  "institutionName": "SANTA ANNA NATIONAL BANK",
  "fdicCertificateId": 5520,
  "failureDate": "2025-06-27",
  "resolution": {
    "resolutionType": "PI",
    "acquiringInstitutionName": "COLEMAN COUNTY STATE BANK"
  },
  "estimatedCost": 23460,
  "sourceUrl": "https://api.fdic.gov/banks/failures?filters=PSTALP%3A%22TX%22&fields=NAME%2CCERT%2CFAILDATE%2CRESTYPE%2CRESTYPE1%2CBIDNAME%2CCOST%2CCITYST%2CPSTALP%2CID&sort_by=FAILDATE&sort_order=DESC&limit=1&offset=0"
}
```

**Branch record**

| Field | Type | What it does |
| --- | --- | --- |
| `recordType` | string | Identifies this row as `branch`. |
| `institutionName` | string or null | Gives the institution that operates the branch. |
| `fdicCertificateId` | integer or null | Gives the branch institution FDIC certificate ID. |
| `branchId` | string or null | Gives the source branch identifier when published. |
| `branchName` | string or null | Gives the branch name when published. |
| `address` | object or null | Holds the published branch address. |
| `address.addressLine1` | string or null | Gives the first street address line. |
| `address.addressLine2` | string or null | Gives the second street address line when published. |
| `address.city` | string or null | Gives the branch city. |
| `address.stateOrTerritory` | string or null | Gives the branch state or territory. |
| `address.postalCode` | string or null | Gives the branch postal code. |
| `coordinates` | object or null | Holds the published branch coordinates. |
| `coordinates.latitude` | number or null | Gives the branch latitude in decimal degrees. |
| `coordinates.longitude` | number or null | Gives the branch longitude in decimal degrees. |
| `services` | string\[] | Lists services published for the branch. |
| `sourceUrl` | URL string | Links to the FDIC source used for the row. |

**Example branch row**

This genuine row shows a Texas branch address, coordinates, and service:

```json
{
  "recordType": "branch",
  "institutionName": "Agility Bank, National Association",
  "fdicCertificateId": 59239,
  "branchId": "622786",
  "branchName": "Agility Bank, National Association",
  "address": {
    "addressLine1": "2401 N Shepherd Dr",
    "addressLine2": "Ste 140",
    "city": "Houston",
    "stateOrTerritory": "Texas",
    "postalCode": "77008"
  },
  "coordinates": {
    "latitude": 29.8081399825439,
    "longitude": -95.4107610301165
  },
  "services": [
    "Full Service - Brick and Mortar"
  ],
  "sourceUrl": "https://api.fdic.gov/banks/locations?filters=STNAME%3A%22Texas%22&fields=NAME%2CCERT%2CUNINUM%2COFFNUM%2COFFNAME%2CADDRESS%2CADDRESS2%2CCITY%2CSTNAME%2CZIP%2CLATITUDE%2CLONGITUDE%2CSERVTYPE_DESC&sort_by=NAME&sort_order=ASC&limit=1&offset=0"
}
```

**Institution structure event**

| Field | Type | What it does |
| --- | --- | --- |
| `recordType` | string | Identifies this row as `structureEvent`. |
| `institutionName` | string or null | Gives the institution named in the event. |
| `fdicCertificateId` | integer or null | Gives the institution FDIC certificate ID. |
| `eventDate` | date string or null | Gives the date of the structure event. |
| `eventType` | string | Gives `merger`, `nameChange`, or `charterChange`. |
| `previousInstitutionName` | string or null | Gives the earlier institution name when published. |
| `relatedInstitutionName` | string or null | Gives the other institution named in the event when published. |
| `previousCharterClass` | string or null | Gives the earlier charter classification when published. |
| `newCharterClass` | string or null | Gives the later charter classification when published. |
| `sourceUrl` | URL string | Links to the FDIC source used for the row. |

**Example structure-event row**

This genuine row shows a published institution name change:

```json
{
  "recordType": "structureEvent",
  "institutionName": "2unifi Bank",
  "fdicCertificateId": 23826,
  "eventDate": "2026-07-31",
  "eventType": "nameChange",
  "previousInstitutionName": "Bank Of Jackson Hole Trust",
  "relatedInstitutionName": null,
  "previousCharterClass": "SM",
  "newCharterClass": "SM",
  "sourceUrl": "https://api.fdic.gov/banks/history?filters=CHANGECODE%3A213+OR+CHANGECODE%3A221+OR+CHANGECODE%3A222+OR+CHANGECODE%3A223+OR+CHANGECODE%3A224+OR+CHANGECODE%3A225+OR+CHANGECODE%3A420+OR+CHANGECODE%3A430+OR+CHANGECODE%3A440+OR+CHANGECODE%3A510+OR+CHANGECODE%3A713+OR+CHANGECODE%3A810+OR+CHANGECODE%3A811+OR+CHANGECODE%3A812&fields=INSTNAME%2CCERT%2CEFFDATE%2CCHANGECODE%2CCHANGECODE_DESC%2COUT_INSTNAME%2CACQ_INSTNAME%2CSUR_INSTNAME%2CFRM_INSTNAME%2CFRM_CLASS%2CCLASS%2CREGAGENT%2CID&sort_by=EFFDATE&sort_order=DESC&limit=1&offset=1"
}
```

**Industry summary**

| Field | Type | What it does |
| --- | --- | --- |
| `recordType` | string | Identifies this row as `industrySummary`. |
| `reportingPeriod` | date string or null | Gives the quarter-end date for the summary. |
| `stateOrTerritory` | string or null | Gives the state or territory covered by the summary. |
| `charterClass` | string or null | Gives the charter classification covered by the summary. |
| `institutionCount` | integer or null | Gives the number of institutions in the summary. |
| `totalAssets` | number or null | Gives total institution assets in USD for the period. |
| `totalDeposits` | number or null | Gives total institution deposits in USD for the period. |
| `totalEquity` | number or null | Gives total institution equity in USD for the period. |
| `netIncome` | number or null | Gives total institution net income in USD for the period. |
| `returnOnAssets` | number or null | Gives return on assets as a percent for the period. |
| `returnOnEquity` | number or null | Gives return on equity as a percent for the period. |
| `sourceUrl` | URL string | Links to the FDIC source used for the row. |

**Example industry-summary row**

This genuine row shows a Texas community-bank summary for one reporting period:

```json
{
  "recordType": "industrySummary",
  "reportingPeriod": "2025-12-31",
  "stateOrTerritory": "Texas",
  "charterClass": "CB",
  "institutionCount": 327,
  "totalAssets": 564911476,
  "totalDeposits": 472778536,
  "totalEquity": 64240299,
  "netIncome": 7519452,
  "returnOnAssets": null,
  "returnOnEquity": null,
  "sourceUrl": "https://api.fdic.gov/banks/summary?fields=YEAR%2CSTNAME%2CSTALP%2CCB_SI%2CBANKS%2CCOUNT%2CASSET%2CDEP%2CEQ%2CNETINC%2CROA%2CROE%2CREPDTE&filters=YEAR%3A2025+AND+STNAME%3A%22Texas%22+AND+CB_SI%3A%22CB%22&limit=1&offset=0"
}
```

#### 💳 Pricing

The Actor uses pay-per-event pricing. A charge is tied to a successfully returned row of the matching type. Apify shows the current price and any tier for your account.

| Event | What it charges for |
| --- | --- |
| Institution profile | You are charged only when an institution profile is returned. |
| Quarterly report | You are charged only when a quarterly financial report is returned. |
| Bank failure | You are charged only when a bank failure is returned. |

#### 🔌 Integrations

**Dataset access**

Read the default dataset through Apify for download and programmatic access to the normalized rows.

**Video guide**

https://www.youtube.com/watch?v=bNACk1\_S\_6w\&list=PLObrtcm1Kw6MUrlLNDbK9QRg8VDJg0gOW\&index=4

#### ❓ FAQ

##### Can I look up one institution by FDIC certificate ID?

Yes. Choose Certificate lookup and enter one `certificateId`. The institution row includes its available latest summary and quarterly financials up to the `maxItems` limit.

##### Can I get quarterly financial records without an institution profile?

Yes. Choose Quarterly financial records and enter a `certificateId`. You can also enter a `reportingPeriod` to select a quarter.

##### Can one run combine several FDIC targets?

No. Choose one target per run. Fields for other targets are ignored, so run separate searches when you need different target families.

##### What happens when I leave Maximum items empty?

The Actor returns all available results until the source is exhausted. For Certificate lookup, the same limit also controls the number of quarterly financial periods when a limit is set.

##### What happens when the FDIC does not publish a value?

The matching field stays `null` when the schema allows it. The Actor does not invent a replacement value.

##### Does this include credit unions?

No. The dataset covers FDIC-insured banks and thrifts. Credit unions and NCUA data are outside this Actor's scope.

##### Is this an official FDIC service?

No. This is an Apify Actor that reads public FDIC BankFind data. The source is official public FDIC data, but the Actor is not operated by the FDIC.

##### Do I need an FDIC API key?

No. The Actor reads the public FDIC source without asking you for an FDIC API key.

##### Does the output contain the complete raw FDIC response?

No. It returns the curated normalized fields in the public dataset schema, with an FDIC source URL for each row.

### 📝 Changelog

**0.0: Initial release**

### 🆘 Support

For issues, questions, or feature requests, [file a ticket](https://console.apify.com/actors/maximedupre~fdic-bankfind/issues) and I'll fix or implement it in less than 24h 🫡

### 🔗 Related Actors

- [OpenInsider](https://apify.com/maximedupre/openinsider) — Review public SEC Form 4 trades for market and company research.
- [Sanctions & Watchlist Screening — Risk-Scored Decisions](https://apify.com/maximedupre/sanctions-screening) — Screen names against official sanctions lists during onboarding or review.
- [World Bank Projects Scraper](https://apify.com/maximedupre/world-bank-projects-scraper) — Add public development-finance projects and country indicators to economic research.
- [FDIC Bank Branch Locations Scraper](https://apify.com/neuton/fdic-bank-branch-locations-scraper) — Search branch addresses, services, coordinates, and bank identifiers.
- [FDIC Bank M\&A, Charter & Structure-Change Monitor](https://apify.com/malonestar/fdic-structure-change-delta-monitor) — Track bank mergers, charter changes, and related institution details.

**Made with ❤️ by Maxime Dupré**

# Actor input Schema

## `target` (type: `string`):

Choose the FDIC data target for this run.

## `institutionName` (type: `string`):

For Institution search, enter all or part of an institution name.

## `activeOnly` (type: `boolean`):

For Institution search, leave this on to return active institutions only. Turn it off to include inactive and historical institutions.

## `minimumAssets` (type: `number`):

For Institution search. Return institutions with total assets at or above this amount in USD.

## `maximumAssets` (type: `number`):

For Institution search. Return institutions with total assets at or below this amount in USD.

## `primaryRegulators` (type: `array`):

For Institution search, enter one or more primary regulator names to include.

## `resultOrder` (type: `string`):

For Institution search. Sort results by institution name, total assets, total deposits, net income, return on assets, or return on equity.

## `certificateId` (type: `integer`):

For Certificate lookup and Quarterly financial records, enter one FDIC certificate ID.

## `reportingPeriod` (type: `string`):

For Quarterly financial records and Industry summaries, enter a reporting date such as 2024-12-31.

## `statesOrTerritories` (type: `array`):

For Institution search, Bank failures, Branch locations, and Industry summaries, enter one or more US states or territories to include. Other targets ignore this field.

## `charterClasses` (type: `array`):

For Institution search and Industry summaries, enter one or more charter classifications to include. Other targets ignore this field.

## `maxItems` (type: `integer`):

Stop after this many returned items. For Certificate lookup, this also limits quarterly financial periods. Leave it empty to get all available results until the source is exhausted.

## Actor input object example

```json
{
  "target": "institutionSearch",
  "activeOnly": true,
  "resultOrder": "institutionName",
  "reportingPeriod": "2024-12-31",
  "maxItems": 100
}
```

# Actor output Schema

## `dataset` (type: `string`):

Links to the normalized rows from the selected FDIC target.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "target": "institutionSearch",
    "maxItems": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("maximedupre/fdic-bankfind").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "target": "institutionSearch",
    "maxItems": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("maximedupre/fdic-bankfind").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "target": "institutionSearch",
  "maxItems": 100
}' |
apify call maximedupre/fdic-bankfind --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,maximedupre/fdic-bankfind"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/wvhVYuZtzLPn0Prch/builds/2OhqDHYxq3tGH7DFL/openapi.json