# Driverdb Motorsport Driver Database Scraper (`jungle_synthesizer/driverdb-motorsport-driver-database-scraper`) Actor Scrape driver profiles from DriverDB.com — biographical details, career history, statistics, and social handles for 80k+ drivers spanning F1, NASCAR, IndyCar, WEC, and more. - **URL**: https://apify.com/jungle\_synthesizer/driverdb-motorsport-driver-database-scraper.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Sports, Lead generation - **Stats:** 2 total users, 1 monthly users, 80.0% runs succeeded, NaN 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 ## Driverdb Motorsport Driver Database Scraper Scrape comprehensive driver profiles from [DriverDB.com](https://www.driverdb.com/) — the most complete multi-series motorsport driver database on the open web. Covers **80k+ drivers** across Formula 1, Formula 2, Formula 3, IndyCar, NASCAR, WEC, IMSA, Formula E, GT World Challenge, Formula Regional, F4, and karting. Each profile includes biographical data, career statistics, championship history, and social handles. ### What you get Each driver record includes: | Field | Description | |-------|-------------| | `driver_id` | Unique driver slug (e.g. `max-verstappen`) | | `driver_url` | Full profile URL | | `full_name` | Driver full name | | `nationality` | Country of nationality | | `dob` | Date of birth (YYYY-MM-DD) | | `birthplace` | City/country of birth | | `current_team` | Current team affiliation | | `current_series` | Current primary racing series | | `current_car_number` | Race car number | | `total_starts` | Total career starts | | `total_wins` | Total career wins | | `total_podiums` | Total career podiums | | `total_poles` | Total career pole positions | | `career_summary` | JSON array — per-season entries with year, series, team, position, points, wins, podiums, poles | | `championship_titles` | Championships won (comma-separated, e.g. "2021 FIA Formula 1 World Championship") | | `karting_history` | JSON array of karting career entries | | `social_handles` | JSON object — twitter, instagram, tiktok, linkedin, website | | `headshot_url` | Driver profile photo URL | ### How to use #### Scrape specific drivers Provide a list of DriverDB.com driver profile URLs: ```json { "startUrls": [ { "url": "https://www.driverdb.com/drivers/max-verstappen/" }, { "url": "https://www.driverdb.com/drivers/lewis-hamilton/" }, { "url": "https://www.driverdb.com/drivers/fernando-alonso/" } ], "maxItems": 10 } ```` #### Scrape by series or index Provide a DriverDB series listing URL to get all drivers in that series: ```json { "startUrls": [ { "url": "https://www.driverdb.com/championships/formula-1/" } ], "maxItems": 30 } ``` #### Full database crawl Leave `startUrls` empty to crawl all drivers alphabetically. The actor walks the A-Z index pages and scrapes every profile it finds: ```json { "maxItems": 1000 } ``` ### Input | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `startUrls` | array | `[]` | DriverDB driver URLs to scrape. Leave empty for full alphabetical crawl. | | `maxItems` | integer | `0` | Maximum driver records to return. `0` means no limit. | ### Notes - **Cloudflare protection**: DriverDB.com is protected by Cloudflare Turnstile. This actor uses CapSolver to bypass the challenge once per run and reuses the session. Typical solve time: 15-25 seconds. - **Data source**: Profile data is extracted from the page's embedded JSON (Next.js SSR), not scraped from rendered HTML, so it is complete and reliable. - **Data freshness**: Statistics reflect what DriverDB has published. Career data is sourced directly from the site's structured data. # 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. ## `startUrls` (type: `array`): List of DriverDB.com driver profile URLs to scrape (e.g. https://www.driverdb.com/drivers/max-verstappen/). Leave empty to use the default seed (a-z driver index pages). ## `maxItems` (type: `integer`): Maximum number of driver records to scrape. Set to 0 for no limit. ## 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...", "startUrls": [ { "url": "https://www.driverdb.com/drivers/max-verstappen/" } ], "maxItems": 5 } ``` # 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...", "startUrls": [ { "url": "https://www.driverdb.com/drivers/max-verstappen/" } ], "maxItems": 5 }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/driverdb-motorsport-driver-database-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...", "startUrls": [{ "url": "https://www.driverdb.com/drivers/max-verstappen/" }], "maxItems": 5, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/driverdb-motorsport-driver-database-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...", "startUrls": [ { "url": "https://www.driverdb.com/drivers/max-verstappen/" } ], "maxItems": 5 }' | apify call jungle_synthesizer/driverdb-motorsport-driver-database-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/driverdb-motorsport-driver-database-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Driverdb Motorsport Driver Database Scraper", "description": "Scrape driver profiles from DriverDB.com — biographical details, career history, statistics, and social handles for 80k+ drivers spanning F1, NASCAR, IndyCar, WEC, and more.", "version": "0.1", "x-build-id": "L01343xiH7g1zb8R0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~driverdb-motorsport-driver-database-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-driverdb-motorsport-driver-database-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~driverdb-motorsport-driver-database-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-driverdb-motorsport-driver-database-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~driverdb-motorsport-driver-database-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-driverdb-motorsport-driver-database-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." }, "startUrls": { "title": "Start URLs", "type": "array", "description": "List of DriverDB.com driver profile URLs to scrape (e.g. https://www.driverdb.com/drivers/max-verstappen/). Leave empty to use the default seed (a-z driver index pages).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of driver records to scrape. Set to 0 for no limit." } } }, "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 } } } } } } } } } } ```