# FCC Broadband Provider Data Scraper (`compute-edge/fcc-broadband-scraper`) Actor Extract FCC Form 477 broadband provider deployment data. Filter by state, provider, technology type, and speed tier. - **URL**: https://apify.com/compute-edge/fcc-broadband-scraper.md - **Developed by:** [Compute Edge](https://apify.com/compute-edge) (community) - **Categories:** Lead generation - **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 ## FCC Broadband Provider Data Scraper ### Overview Extract comprehensive **FCC Form 477 broadband provider deployment data** from the Federal Communications Commission's open data portal. Access **181,000+ broadband service records** covering providers, technologies, speeds, and census block coverage. This actor scrapes the authoritative FCC Form 477 dataset—filed twice yearly by all facilities-based broadband providers in the United States. Perfect for: - **Municipal broadband planning** — Map provider coverage by census block - **Telecom infrastructure analysis** — Identify technology gaps and deployment patterns - **BEAD investment mapping** — Analyze provider participation in broadband expansion programs - **Competitive landscape research** — Track major providers' service areas and speed offerings - **Academic & policy research** — Study broadband deployment trends over time #### Key Features - **181,000+ provider records** spanning all US states and territories - **Provider information** — Name, FRN (FCC Registration Number), holding company hierarchy - **Technology type** — Filter by fiber, cable, DSL, fixed wireless, satellite, etc. - **Speed data** — Advertised maximum download and upload speeds - **Service type** — Consumer vs. business service availability - **Census block coverage** — Track provider presence by geographic area - **State & regional filtering** — Isolate specific markets for analysis - **Structured JSON output** — Ready for analytics, mapping, and integration with GIS systems --- ### How to Scrape FCC Broadband Provider Data #### Step 1: Open the Actor in Apify Console Navigate to the [FCC Broadband Provider Data Scraper](https://console.apify.com/actors/[ACTOR_ID]) in the Apify Store or Console. #### Step 2: Configure Your Search Set the following input parameters (all optional — leave blank to search all records): | Parameter | Type | Example | Description | |-----------|------|---------|-------------| | **State Abbreviation** | String | `CA`, `TX`, `NY` | Two-letter state code. Leave blank for all states. | | **Provider Name** | String | `Comcast`, `Verizon` | Provider name (partial match supported). Leave blank for all providers. | | **Technology Code** | String | `11`, `70`, `41` | [See technology codes below](#technology-codes). Leave blank for all technologies. | | **Min Download Speed (Mbps)** | Integer | `25`, `100` | Filter for providers offering at least this download speed. Leave blank to skip. | | **Min Upload Speed (Mbps)** | Integer | `3`, `10` | Filter for providers offering at least this upload speed. Leave blank to skip. | | **Max Results** | Integer | `1000`, `50000` | Number of records to return. Default: 1000. Max: 500,000. | #### Step 3: Run the Actor 1. **Enter your search parameters** in the input form 2. **Click "Start"** to begin extraction 3. **Monitor progress** in the Run log #### Step 4: Download Results Once the run completes: 1. **View the dataset** — Click the "Dataset" tab to browse extracted records 2. **Download as CSV/JSON** — Use the "Download" button to export all records 3. **API access** — Use the Dataset API to fetch records programmatically --- ### Technology Codes Reference The `techCode` field identifies the broadband technology: | Code | Technology | Description | |------|-----------|-------------| | `10` | Copper (Legacy) | Traditional telephone-based broadband | | `11` | Cable Modem | Broadband over cable television infrastructure | | `12` | Fixed Wireless | Terrestrial fixed wireless, point-to-point | | `13` | Terrestrial Fixed Wireless | Mobile broadband stations | | `14` | Satellite | Geostationary satellite service | | `20` | Fiber to the Premises (FTTP) | Direct fiber connection to home | | `21` | DOCSIS 3.1 (Cable) | Latest cable modem standard | | `70` | Satellite (LEO) | Low-Earth Orbit satellite service | | `41` | Fiber to the Home (FTTH) | Fiber-optic broadband to premises | --- ### Input & Output Examples #### Example 1: California Fiber Providers **Input:** ```json { "stateAbbr": "CA", "techCode": "41", "maxResults": 50 } ```` **Sample Output (JSON):** ```json [ { "logRecno": "16981", "providerId": "59626", "frn": "0020305868", "providerName": "Ultimate Internet Access, Inc", "stateAbbr": "CA", "blockCode": "060374016011026", "techCode": "41", "maxDownloadSpeed": 1000, "maxUploadSpeed": 1000, "consumerService": 1, "businessService": 1 }, { "logRecno": "16982", "providerId": "59627", "frn": "0020305869", "providerName": "Fiber Communications Inc", "stateAbbr": "CA", "blockCode": "060374016011027", "techCode": "41", "maxDownloadSpeed": 500, "maxUploadSpeed": 100, "consumerService": 1, "businessService": 0 } ] ``` #### Example 2: National 25+ Mbps Download **Input:** ```json { "minDownloadSpeed": 25, "maxResults": 100 } ``` This returns all providers nationwide offering at least 25 Mbps download (standard broadband definition). #### Example 3: Texas Cable & Satellite Providers **Input:** ```json { "stateAbbr": "TX", "providerName": "Comcast", "maxResults": 5000 } ``` This returns all Comcast service blocks in Texas. *** ### Output Fields Explained | Field | Type | Description | |-------|------|-------------| | **logRecno** | String | Unique log record number from FCC database | | **providerId** | String | FCC provider identifier | | **frn** | String | FCC Registration Number (unique to each company) | | **providerName** | String | Legal company name | | **dbaName** | String | "Doing Business As" operating name | | **holdingCompanyName** | String | Parent company if applicable | | **hocoNum** | String | Holding company number (FCC identifier) | | **hocoFinal** | String | Final holding company after consolidation | | **stateAbbr** | String | Two-letter state abbreviation | | **blockCode** | String | Census block FIPS code (15-digit) | | **techCode** | String | Technology code (see reference above) | | **maxDownloadSpeed** | Integer | Advertised max download speed (Mbps) | | **maxUploadSpeed** | Integer | Advertised max upload speed (Mbps) | | **consumerService** | Integer | 1 = Consumer service available, 0 = No | | **businessService** | Integer | 1 = Business service available, 0 = No | *** ### Pricing & Performance - **Cost per result**: $0.002 per provider record - **API call time**: Typically 15–60 seconds depending on filter complexity and result count - **Compute units**: ~0.1–2 compute units per run (varies by record count) **Estimate:** Extracting 1,000 records costs approximately **$2.00 + compute costs** *** ### Use Cases & Applications #### Municipal Broadband Planning Assess existing provider coverage by census block to identify service gaps for municipal broadband initiatives. #### BEAD Program Analysis Map provider participation in the Broadband Equity & Access Deployment (BEAD) program funded by the Bipartisan Infrastructure Law. #### Competitive Intelligence Track major telecom providers' service areas, technologies deployed, and speed offerings in specific regions. #### Academic Research Study broadband deployment trends, technology adoption patterns, and gaps in underserved areas. #### GIS Mapping Combine census block codes with geographic data to create interactive broadband availability maps. #### Regulatory Analysis Monitor provider compliance with FCC Form 477 filings and analyze technology deployment timelines. *** ### FAQ #### Q: How current is the data? **A:** The underlying FCC Form 477 dataset is updated twice annually (June and December). This Actor queries the latest available data. #### Q: What is a "census block"? **A:** A census block is the smallest geographic unit defined by the U.S. Census Bureau. The `blockCode` field is a 15-digit FIPS code you can cross-reference with Census Bureau GIS data for mapping. #### Q: Why are there multiple records per provider? **A:** Each record represents a provider's service availability in a **specific census block**. Large providers like Comcast have thousands of records (one per block served). #### Q: Can I filter by speed inside the Actor? **A:** Yes! Use the **Min Download Speed** and **Min Upload Speed** parameters to filter results (e.g., only providers offering 100+ Mbps). #### Q: What does "consumerService: 1" mean? **A:** This indicates the provider offers residential (consumer) broadband service in that census block. `consumerService: 0` means business-only. #### Q: How do I use census block codes? **A:** Download Census Bureau shape files or use services like OpenStreetMap to geocode block codes. This enables GIS analysis of provider coverage. #### Q: Can I get historical data? **A:** The current Actor provides the latest FCC Form 477 filing. Historical data requires querying different dataset versions (available on FCC's open data portal). *** ### Data Source & Attribution **Source:** Federal Communications Commission (FCC) **Dataset:** Form 477 Fixed Broadband Provider Data (June 2020 + latest) **URL:** https://opendata.fcc.gov/resource/4kuc-phrr.json **License:** Public domain (USA.gov) *** ### Troubleshooting #### Q: My run is very slow **A:** Large result sets (50,000+) take longer to fetch. Consider filtering by state or provider name to reduce record count. #### Q: I'm not seeing expected providers **A:** FCC Form 477 only includes facilities-based providers (those that own infrastructure). Resellers are excluded. Also, ensure your technology code filter is correct. #### Q: How do I map this data? **A:** Combine the `blockCode` (15-digit FIPS) with Census Bureau shapefiles or use platforms like Mapbox, Carto, or QGIS. Example workflow: 1. Download results as CSV 2. Get Census tiger/line shapefiles 3. Join on blockCode (as integer: remove leading zeros) 4. Visualize in GIS *** ### Legal & Compliance **Disclaimer:** This Actor extracts publicly available FCC Form 477 data from the FCC's official open data portal. The underlying data is in the public domain. Use of this Actor does not violate FCC policies or robots.txt restrictions. **Citation:** When publishing analyses, cite the FCC: > Federal Communications Commission. "Form 477 Fixed Broadband Provider Data." https://opendata.fcc.gov/resource/4kuc-phrr.json *** ### Related Actors - [FCC License Search Scraper](#) — Extract FCC broadcast license data - [BEAD Program Status Tracker](#) — Monitor state broadband grant progress - [Telecom Provider Directory](#) — Multi-source provider intelligence *** ### Support For issues, feature requests, or questions: - **GitHub Issues:** https://github.com/\[YOUR\_ORG]/fcc-broadband-scraper/issues - **Email:** support@\[YOUR\_DOMAIN].com *** **Built with [Apify](https://apify.com) for reliable web data extraction.** # Actor input Schema ## `stateAbbr` (type: `string`): Two-letter state abbreviation (e.g., 'CA', 'TX', 'NY'). Leave empty to search all states. ## `providerName` (type: `string`): Broadband provider name (e.g., 'Comcast', 'Verizon', 'AT\&T'). Partial match supported via LIKE. Leave empty for all providers. ## `techCode` (type: `string`): Technology code filter (e.g., '10'=Copper, '11'=Cable modem, '12'=Terrestrial fixed wireless, '70'=Satellite, '41'=Fiber to the home). Leave empty for all technologies. ## `minDownloadSpeed` (type: `integer`): Minimum advertised download speed in Mbps. Only returns providers offering at least this speed. ## `minUploadSpeed` (type: `integer`): Minimum advertised upload speed in Mbps. Only returns providers offering at least this speed. ## `maxResults` (type: `integer`): Maximum number of records to return. ## Actor input object example ```json { "stateAbbr": "", "providerName": "", "techCode": "", "maxResults": 1000 } ``` # Actor output Schema ## `dataset` (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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("compute-edge/fcc-broadband-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("compute-edge/fcc-broadband-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 compute-edge/fcc-broadband-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=compute-edge/fcc-broadband-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "FCC Broadband Provider Data Scraper", "description": "Extract FCC Form 477 broadband provider deployment data. Filter by state, provider, technology type, and speed tier.", "version": "0.1", "x-build-id": "ksL4AtU3YTbRy1Nxh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/compute-edge~fcc-broadband-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-compute-edge-fcc-broadband-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/compute-edge~fcc-broadband-scraper/runs": { "post": { "operationId": "runs-sync-compute-edge-fcc-broadband-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/compute-edge~fcc-broadband-scraper/run-sync": { "post": { "operationId": "run-sync-compute-edge-fcc-broadband-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": { "stateAbbr": { "title": "State Abbreviation", "type": "string", "description": "Two-letter state abbreviation (e.g., 'CA', 'TX', 'NY'). Leave empty to search all states.", "default": "" }, "providerName": { "title": "Provider Name", "type": "string", "description": "Broadband provider name (e.g., 'Comcast', 'Verizon', 'AT&T'). Partial match supported via LIKE. Leave empty for all providers.", "default": "" }, "techCode": { "title": "Technology Code", "type": "string", "description": "Technology code filter (e.g., '10'=Copper, '11'=Cable modem, '12'=Terrestrial fixed wireless, '70'=Satellite, '41'=Fiber to the home). Leave empty for all technologies.", "default": "" }, "minDownloadSpeed": { "title": "Minimum Download Speed (Mbps)", "minimum": 0, "type": "integer", "description": "Minimum advertised download speed in Mbps. Only returns providers offering at least this speed." }, "minUploadSpeed": { "title": "Minimum Upload Speed (Mbps)", "minimum": 0, "type": "integer", "description": "Minimum advertised upload speed in Mbps. Only returns providers offering at least this speed." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 500000, "type": "integer", "description": "Maximum number of records to return.", "default": 1000 } } }, "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 } } } } } } } } } } ```