# League of American Bicyclists BFB/BFC/BFU Directory Scraper (`jungle_synthesizer/bikeleague-bicycle-friendly-business-community-scraper`) Actor Scrapes the League of American Bicyclists' Bicycle Friendly Business (BFB), Bicycle Friendly Community (BFC), and Bicycle Friendly University (BFU) award directories. Returns all certified organisations with award level, location, industry, employee count, contact email, and website. - **URL**: https://apify.com/jungle\_synthesizer/bikeleague-bicycle-friendly-business-community-scraper.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Lead generation - **Stats:** 2 total users, 1 monthly users, 87.5% runs succeeded, 0 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. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## League of American Bicyclists BFB/BFC/BFU Directory Scraper Scrapes the [League of American Bicyclists' Bicycle Friendly America (BFA)](https://bikeleague.org/bfa/award-database/) award database — all certified Bicycle Friendly Businesses (BFB), Bicycle Friendly Communities (BFC), and Bicycle Friendly Universities (BFU). Returns every awarded organisation with its award level, location, industry, contact email, and website in a single run. ### What you get | Field | Description | |-------|-------------| | `org_name` | Organisation name | | `org_type` | Program: `BFB`, `BFC`, or `BFU` | | `award_level` | Award tier: Platinum, Gold, Silver, Bronze, Honorable Mention | | `award_round` | Award round, e.g. `Spring 2018` | | `city` | City | | `state` | US state abbreviation | | `postal_code` | Postal / ZIP code | | `latitude` | Latitude (decimal degrees) | | `longitude` | Longitude (decimal degrees) | | `industry` | Industry or sector (BFBs only) | | `employee_count` | Number of employees disclosed (BFBs only) | | `student_enrollment` | Student enrollment (BFUs only) | | `population` | Community population (BFCs only) | | `jurisdiction` | Jurisdiction type, e.g. Town/City/Municipality (BFCs only) | | `website` | Organisation website | | `contact_email` | Contact email from the directory listing | | `facebook` | Facebook URL | | `twitter` | Twitter/X URL | | `salesforce_id` | Salesforce record ID | | `source_url` | Award database page URL | ### Coverage - **BFB (Bicycle Friendly Business):** 1,100+ certified businesses — shops, offices, universities, healthcare providers, government agencies - **BFC (Bicycle Friendly Community):** 450+ cities, counties, and municipalities - **BFU (Bicycle Friendly University):** 200+ accredited universities and colleges Run all three programs in a single execution or target individual programs via the `programs` input. ### Input | Field | Type | Default | Description | |-------|------|---------|-------------| | `programs` | Array | `["bfb","bfc","bfu"]` | Which programs to scrape. Any combination of `"bfb"`, `"bfc"`, `"bfu"`. | | `maxItems` | Integer | (all) | Maximum records to return across all programs. Omit or set `0` for all. | #### Example: All three programs ```json { "programs": ["bfb", "bfc", "bfu"] } ```` #### Example: Bicycle Friendly Businesses only, capped at 100 ```json { "programs": ["bfb"], "maxItems": 100 } ``` #### Example: Communities and Universities ```json { "programs": ["bfc", "bfu"] } ``` ### How it works The BFA award database page loads data asynchronously from a WordPress AJAX endpoint that returns the complete dataset in a single JSON call per program type — no pagination. The scraper calls this endpoint directly (one request per program), merges the results, and applies the optional `maxItems` cap. A full run of all three programs typically completes in under 30 seconds. ### Sample output ```json { "org_name": "Ride On Bikes", "org_type": "BFB", "award_level": "Platinum", "award_round": "Spring 2018", "city": "Columbus", "state": "GA", "postal_code": "31901", "latitude": 32.465377, "longitude": -84.993294, "industry": "Bicycle Shop", "employee_count": 12, "student_enrollment": null, "population": null, "jurisdiction": null, "website": "http://rideonbikes.com", "contact_email": "rideon@rideonbikes.com", "facebook": "https://www.facebook.com/rideonbikes", "twitter": null, "salesforce_id": "001G000000tq8zlIAA", "source_url": "https://bikeleague.org/bfa/award-database/" } ``` ### Use cases - **Lead generation** — identify bike-friendly businesses and institutions for cycling-related products and services - **Market research** — map the distribution of bike-friendly organisations by geography, industry, or award tier - **Policy research** — track adoption of Bicycle Friendly Community designations across US jurisdictions - **Partnership sourcing** — find certified bicycle-friendly organisations for co-marketing, sponsorship, or grant programs ### FAQ **Does the scraper return all records?** Yes. Each program's endpoint returns the complete dataset in one call. `maxItems` applies post-collection as a cap, not as a filter that could miss records. **What program types are available?** Three: `bfb` (businesses), `bfc` (communities/municipalities), `bfu` (universities). All are scraped by default. Specify one or more in the `programs` array to narrow the run. **Are all fields populated for every record?** No — fields are program-specific. `industry` and `employee_count` appear on BFB records; `student_enrollment` on BFUs; `population` and `jurisdiction` on BFCs. Records from other programs carry `null` for fields that don't apply. `contact_email`, `facebook`, and `twitter` depend on what each organisation has disclosed in the directory. **How fresh is the data?** The endpoint reflects the live BFA award database as of the moment the scraper runs. The League updates awards on a rolling basis. # 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. ## `maxItems` (type: `integer`): Maximum number of records to scrape (across all programs). Leave blank or set to 0 for all records. ## `programs` (type: `array`): Which BFA programs to scrape. Defaults to all three (BFB, BFC, BFU). ## 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...", "maxItems": 50, "programs": [ "bfb", "bfc", "bfu" ] } ``` # 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...", "maxItems": 50, "programs": [ "bfb", "bfc", "bfu" ] }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/bikeleague-bicycle-friendly-business-community-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 = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 50, "programs": [ "bfb", "bfc", "bfu", ], } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/bikeleague-bicycle-friendly-business-community-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 '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 50, "programs": [ "bfb", "bfc", "bfu" ] }' | apify call jungle_synthesizer/bikeleague-bicycle-friendly-business-community-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/bikeleague-bicycle-friendly-business-community-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "League of American Bicyclists BFB/BFC/BFU Directory Scraper", "description": "Scrapes the League of American Bicyclists' Bicycle Friendly Business (BFB), Bicycle Friendly Community (BFC), and Bicycle Friendly University (BFU) award directories. Returns all certified organisations with award level, location, industry, employee count, contact email, and website.", "version": "0.1", "x-build-id": "UJB6m6Ew0nbv7n0Ko" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~bikeleague-bicycle-friendly-business-community-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-bikeleague-bicycle-friendly-business-community-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/jungle_synthesizer~bikeleague-bicycle-friendly-business-community-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-bikeleague-bicycle-friendly-business-community-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/jungle_synthesizer~bikeleague-bicycle-friendly-business-community-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-bikeleague-bicycle-friendly-business-community-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": { "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." }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of records to scrape (across all programs). Leave blank or set to 0 for all records." }, "programs": { "title": "Programs", "type": "array", "description": "Which BFA programs to scrape. Defaults to all three (BFB, BFC, BFU).", "items": { "type": "string" } } } }, "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 } } } } } } } } } } ```