# FINRA BrokerCheck Scraper (`muhammadafzal/finra-brokercheck-scraper`) Actor Search public FINRA BrokerCheck broker and firm records by name or CRD number. - **URL**: https://apify.com/muhammadafzal/finra-brokercheck-scraper.md - **Developed by:** [Muhammad Afzal](https://apify.com/muhammadafzal) (community) - **Categories:** Integrations - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 brokercheck record returneds This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## FINRA BrokerCheck Scraper Search publicly available FINRA BrokerCheck records for individual brokers and brokerage firms. Supply names or public CRD numbers and receive structured, AI-friendly records that link back to the official BrokerCheck summary pages. Use this actor for due diligence, compliance research, recruitment verification, and market research. It does **not** provide investment advice, determine suitability, or replace a qualified compliance review. ### What it returns Each dataset item contains the public record type, CRD number when available, name, registration-status text, current firm name, disclosure count when supplied by BrokerCheck, and official profile URL. Optional profile fetching adds only the public page title and a short visible-text preview. ### Input - `searchTerms` — one broker/firm name or public CRD number per line. Do not supply SSNs, birth dates, account data, or any other sensitive personal information. - `recordType` — `individual`, `firm`, or `both`. - `maxResultsPerSearch` — 1–50, defaults to 10. - `includeProfilePage` — defaults to `false`; fetches public summary pages only when enabled. - `requestDelayMs` — 500–10,000 ms; defaults to 1,200 ms to keep public requests paced conservatively. Example: ```json { "searchTerms": ["Gregory Berg", "3081088"], "recordType": "individual", "maxResultsPerSearch": 10, "includeProfilePage": false, "requestDelayMs": 1200 } ```` ### Respectful-use notes BrokerCheck is a public resource, but this actor intentionally uses sequential requests, a configurable delay, tight caps, retries for temporary errors, and no login or access-control bypassing. It is designed for targeted public-record research—not bulk harvesting. Follow FINRA's terms and applicable laws, and independently verify material facts from the linked official record. FINRA also provides credentialed developer APIs. This actor does not use those APIs and never asks for FINRA API credentials or sensitive identity fields. ### Pricing The included pay-per-event definition charges $0.00005 per actor start and $0.005 per unique public BrokerCheck record returned. Enable both Pay Per Event and Pay Per Usage in the Apify Console before Store publication. ### For AI agents Use this actor when you need public FINRA BrokerCheck information for named brokers, brokerage firms, or CRD numbers. Do not use it for investment recommendations, private background checks, or investment-adviser-only records. Results include a stable `profileUrl` so an agent can cite or review the official public page. ### Limitations Public BrokerCheck search response fields can change. The actor preserves the core fields it recognizes and records warnings in the `SUMMARY` key if a query fails or returns no results. A warning or empty result is not evidence that a person or firm has no regulatory history. # Actor input Schema ## `searchTerms` (type: `array`): Use this when looking up public FINRA BrokerCheck records by a broker or firm name, or a public CRD number. Enter one value per line, for example 'Jane Smith' or '3081088'. Defaults to a sample name. Do NOT enter SSNs, dates of birth, or private identifiers. ## `recordType` (type: `string`): Use this to choose whether BrokerCheck searches individual brokers, brokerage firms, or both. Select 'individual' for people and 'firm' for organizations. Defaults to individual. This is not an investment-adviser-only IAPD search. ## `maxResultsPerSearch` (type: `integer`): Use this to cap records returned for each supplied search term. Enter a number from 1 to 50. Defaults to 10. This limit is per term, not the total across all inputs. ## `includeProfilePage` (type: `boolean`): Use this to retrieve each matched public BrokerCheck summary page and collect its title and visible text preview. Defaults to false for lower load. It does not download reports or bypass access controls. ## `requestDelayMs` (type: `integer`): Use this to set respectful pacing between public BrokerCheck requests. Enter 500 to 10000 milliseconds. Defaults to 1200 milliseconds. This is not a timeout or a concurrency setting. ## Actor input object example ```json { "searchTerms": [ "Gregory Berg" ], "recordType": "individual", "maxResultsPerSearch": 10, "includeProfilePage": false, "requestDelayMs": 1200 } ``` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("muhammadafzal/finra-brokercheck-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 = {} # Run the Actor and wait for it to finish run = client.actor("muhammadafzal/finra-brokercheck-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 '{}' | apify call muhammadafzal/finra-brokercheck-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=muhammadafzal/finra-brokercheck-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "FINRA BrokerCheck Scraper", "description": "Search public FINRA BrokerCheck broker and firm records by name or CRD number.", "version": "1.0", "x-build-id": "jGRjR7OJ1DfcjExJX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/muhammadafzal~finra-brokercheck-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-muhammadafzal-finra-brokercheck-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/muhammadafzal~finra-brokercheck-scraper/runs": { "post": { "operationId": "runs-sync-muhammadafzal-finra-brokercheck-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/muhammadafzal~finra-brokercheck-scraper/run-sync": { "post": { "operationId": "run-sync-muhammadafzal-finra-brokercheck-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", "required": [ "searchTerms" ], "properties": { "searchTerms": { "title": "Names or CRD numbers", "type": "array", "description": "Use this when looking up public FINRA BrokerCheck records by a broker or firm name, or a public CRD number. Enter one value per line, for example 'Jane Smith' or '3081088'. Defaults to a sample name. Do NOT enter SSNs, dates of birth, or private identifiers.", "items": { "type": "string", "minLength": 2, "maxLength": 120 }, "default": [ "Gregory Berg" ] }, "recordType": { "title": "Record type", "enum": [ "individual", "firm", "both" ], "type": "string", "description": "Use this to choose whether BrokerCheck searches individual brokers, brokerage firms, or both. Select 'individual' for people and 'firm' for organizations. Defaults to individual. This is not an investment-adviser-only IAPD search.", "default": "individual" }, "maxResultsPerSearch": { "title": "Maximum results per search", "minimum": 1, "maximum": 50, "type": "integer", "description": "Use this to cap records returned for each supplied search term. Enter a number from 1 to 50. Defaults to 10. This limit is per term, not the total across all inputs.", "default": 10 }, "includeProfilePage": { "title": "Fetch public profile page", "type": "boolean", "description": "Use this to retrieve each matched public BrokerCheck summary page and collect its title and visible text preview. Defaults to false for lower load. It does not download reports or bypass access controls.", "default": false }, "requestDelayMs": { "title": "Delay between requests (milliseconds)", "minimum": 500, "maximum": 10000, "type": "integer", "description": "Use this to set respectful pacing between public BrokerCheck requests. Enter 500 to 10000 milliseconds. Defaults to 1200 milliseconds. This is not a timeout or a concurrency setting.", "default": 1200 } } }, "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 } } } } } } } } } } ```