# Bid.cars Lot Scraper - Low-costπŸ’²πŸ”₯πŸš—πŸ”¨ (`delectable_incubator/bid-cars-lot-scraper-low-cost`) Actor πŸš— Easily scrape Bid.cars vehicle auction listings from search URLs. Extract vehicle titles, VINs, lot IDs, current bids, auction status, damage details, locations, images, auction URLs & more. Perfect for salvage vehicle research, price tracking, automotive intelligence and market analysis. - **URL**: https://apify.com/delectable\_incubator/bid-cars-lot-scraper-low-cost.md - **Developed by:** [Prime Scrape](https://apify.com/delectable_incubator) (community) - **Categories:** E-commerce, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.00005 / actor start 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 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

bid.cars Lot Scraper

--- ## πŸš—πŸ”¨πŸ“Š bid.cars Lot Scraper | Bulk Auction Vehicle Scraper | Apify Actor ### πŸš€ Extract bid.cars Auction Vehicle Data in Seconds (No Code) The **bid.cars Lot Scraper (Apify Actor)** is a powerful, scalable and easy-to-use vehicle auction scraping tool designed to extract structured auction lot data directly from **bid.cars**. It allows you to scrape auction vehicles in bulk from multiple **bid.cars search and filter result URLs**, extract detailed vehicle information, VIN numbers, auction data, bidding information, vehicle condition, damage reports, pricing estimates, and auction schedules. Perfect for automotive analysts, car exporters, dealerships, salvage buyers, vehicle traders, market researchers, and automotive data platforms. --- ### πŸ”₯ Why This bid.cars Scraper? βœ” Powerful bid.cars auction scraper on Apify βœ” Supports **Bulk URL Scraping** βœ” Scrape multiple bid.cars search URLs in a single run βœ” Supports bid.cars search and filter result pages βœ” Extract detailed auction vehicle information βœ” Extract VIN numbers and lot IDs βœ” Extract auction house and auction type βœ” Extract current bids and estimated prices βœ” Extract vehicle condition and damage information βœ” Extract mileage and engine specifications βœ” Extract auction dates and remaining time βœ” Extract location and seller information βœ” Automatic Load More result handling βœ” Respect maximum lots per URL limits βœ” Clean structured dataset output βœ” Perfect for salvage vehicle market research βœ” Ideal for automotive market intelligence βœ” No coding required --- ### 🎯 What This Scraper Does (bid.cars Auction Data Extraction) This Apify Actor extracts structured vehicle auction data from bid.cars search and filter result pages. #### πŸ“Œ Core Features: βœ… Scrape bid.cars auction lot listings βœ… Bulk URL scraping support βœ… Process multiple search URLs independently βœ… Extract vehicle titles and model names βœ… Extract unique lot IDs βœ… Extract auction lot numbers βœ… Extract VIN numbers βœ… Extract auction house information βœ… Extract auction types βœ… Extract scheduled auction dates βœ… Extract remaining auction time βœ… Extract current bid information βœ… Extract estimated vehicle prices βœ… Extract vehicle driving condition βœ… Extract vehicle mileage βœ… Extract damage descriptions βœ… Extract engine specifications βœ… Extract auction locations βœ… Extract sale document information βœ… Extract seller information βœ… Extract vehicle images βœ… Extract direct listing URLs βœ… Extract source search URLs βœ… Automatic Load More handling βœ… Clean structured dataset output --- ### ⚑ Input Configuration (Simple & Powerful) #### πŸ”₯ BULK URL MODE πŸš€ Scrape multiple bid.cars search and filter URLs in a single run. ```` { "urls": \[ "https://bid.cars/en/search/results?search-type=filters\&status=All\&type=Automobile\&make=Mazda\&model=All\&year-from=1900\&year-to=2026\&auction-type=All", "https://bid.cars/en/search/results?search-type=filters\&status=All\&type=Automobile\&make=BMW\&model=All\&year-from=1900\&year-to=2026\&auction-type=All", "https://bid.cars/pl/search/results?search-type=filters\&status=All\&type=Automobile\&make=BMW\&model=All\&year-from=1900\&year-to=2027\&auction-type=All" ], "maxitems": 50 } ``` #### 🌍 SUPPORTED LOCALES The scraper supports bid.cars URLs using the following locale prefixes: ``` en pl ru ua ``` Each URL must contain: ``` bid.cars ``` --- ### 🌐 Supported bid.cars URL Types #### πŸ”Ž Search & Filter Result Pages Provide one or more bid.cars search or filter result URLs. Examples: ``` https://bid.cars/en/search/results?search-type=filters\&status=All\&type=Automobile\&make=Mazda\&model=All\&year-from=1900\&year-to=2026\&auction-type=All https://bid.cars/en/search/results?search-type=filters\&status=All\&type=Automobile\&make=BMW\&model=All\&year-from=1900\&year-to=2026\&auction-type=All https://bid.cars/pl/search/results?search-type=filters\&status=All\&type=Automobile\&make=BMW\&model=All\&year-from=1900\&year-to=2027\&auction-type=All ``` You can use different filters such as: * Vehicle make * Vehicle model * Vehicle type * Year range * Auction type * Vehicle status * Other available bid.cars search filters --- ### πŸ“Š Extracted Auction Vehicle Data (Structured Output) | Field | Description | | ------------------- | --------------------------------------- | | πŸš— `title` | Vehicle title and model name | | πŸ†” `lotId` | Unique auction lot ID | | πŸ”’ `lotNumber` | Auction lot number | | πŸ” `vin` | Vehicle Identification Number | | πŸ›οΈ `auctionHouse` | Auction provider such as Copart or IAAI | | πŸ”¨ `auctionType` | Type of auction | | πŸ“… `auctionDate` | Scheduled auction date | | ⏳ `timeLeft` | Remaining time before auction | | πŸ’° `currentBid` | Current highest bid | | πŸ’΅ `estimatedPrice` | Estimated vehicle price | | πŸš™ `driveStatus` | Vehicle driving condition | | πŸ“ `mileage` | Vehicle mileage | | ⚠️ `damage` | Vehicle damage description | | βš™οΈ `engineSpecs` | Engine specifications | | πŸ“ `location` | Auction location | | πŸ“„ `saleDoc` | Sale document or title status | | 🏒 `seller` | Seller information | | πŸ–ΌοΈ `imageUrl` | Vehicle image URL | | πŸ”— `listingUrl` | Direct auction lot listing URL | | πŸ“… `extractionDate` | Date and time of data extraction | | 🌐 `sourceUrl` | Original bid.cars search or filter URL | ``` *** ### πŸ“¦ Example Output ``` { "title": "2024 Jeep Grand Cherokee, L Laredo X", "lotId": "0-44435259", "lotNumber": "0-44435259", "vin": "1C4RJJAG0R8940562", "auctionHouse": "iaai", "auctionType": "Π’Ρ–Π΄ΠΊΡ€ΠΈΡ‚ΠΈΠΉ Π°ΡƒΠΊΡ†Ρ–ΠΎΠ½", "auctionDate": "ΠΏΠ½ 16 ΠΌΠ°Ρ€., 14:30 GMT+1", "timeLeft": "1 d 23 h 27 min залишСний", "currentBid": "ΠŸΠΎΡ‚ΠΎΡ‡Π½Π° ставка:$0", "estimatedPrice": "$10,960 - $16,280", "driveStatus": "Бтатус: Π—Π°Π²ΠΎΠ΄ΠΈΡ‚ΡŒΡΡ Ρ– Ρ—Π΄Π΅", "mileage": "ΠšΡ–Π»ΠΎΠΌΠ΅Ρ‚Ρ€Π°ΠΆ: 23k ΠΌΠΈΠ»Ρ– (38k km)", "damage": "ПошкодТСння: ЗіктнСння | Π‘ΠΏΠ΅Ρ€Π΅Π΄Ρƒ / Π·Π·Π°Π΄Ρƒ", "engineSpecs": "ΠžΠ±β€™Ρ”ΠΌ Π΄Π²ΠΈΠ³ΡƒΠ½Π°, Ρ‚ΠΈΠΏ, ΠΏΠΎΡ‚ΡƒΠΆΠ½Ρ–ΡΡ‚ΡŒ", "location": "ΠœΡ–ΡΡ†Π΅ знаходТСння: West Palm... (FL)", "saleDoc": "Π”ΠΎΠΊΡƒΠΌΠ΅Π½Ρ‚ΠΈ ΠΏΡ€ΠΎΠ΄Π°ΠΆΡƒ: Certificate of destruction (Florida)", "seller": "ΠŸΡ€ΠΎΠ΄Π°Π²Π΅Ρ†ΡŒ: ---", "imageUrl": "https://images.bid.cars/044435259_69b4fd2af254b/2024-Jeep-Grand-Cherokee-1C4RJJAG0R8940562-1.jpg", "listingUrl": "https://bid.cars/ua/lot/0-44435259/2024-Jeep-Grand-Cherokee-1C4RJJAG0R8940562", "extractionDate": "2026-03-14T13:32:30.710Z", "sourceUrl": "https://bid.cars/ua/search/results?search-type=filters&status=All&type=Automobile&make=Jeep&model=Grand+Cherokee&year-from=1900&year-to=2027&auction-type=All" } ``` *** ### πŸ’‘ Use Cases (High-Demand Automotive Data Research) This bid.cars scraper is useful for: πŸš— Salvage vehicle market research πŸ”¨ Vehicle auction monitoring πŸ“Š Automotive market intelligence πŸ’° Auction pricing analysis πŸ“ˆ Vehicle resale opportunity research 🧠 Competitor and market analysis πŸš™ Car export business intelligence 🏒 Dealership vehicle research πŸ“¦ Salvage vehicle data collection πŸ” VIN and lot research πŸ“Š Auction supply analysis ⚑ Bulk auction data extraction *** ### πŸš€ Key Features (Apify SEO Optimized) ⚑ **Bulk URL scraping support** πŸš— Bid.cars auction vehicle scraping πŸ”Ž Search and filter URL support 🌍 Multi-language locale support πŸ“Œ Automatic Load More handling 🎯 Maximum lots per URL control πŸ†” VIN and Lot ID extraction πŸ’° Current bid and estimated price extraction ⚠️ Vehicle damage information πŸ“ Mileage and vehicle condition data πŸ›οΈ Auction house identification πŸ“… Auction date and schedule extraction πŸ–ΌοΈ Vehicle image extraction πŸ”— Direct listing URL extraction 🧠 Clean structured output πŸ“Š Preconfigured dataset views πŸ’Ύ Export-ready datasets βš™οΈ Scalable cloud execution with Apify *** ### πŸ› οΈ How to Use #### 1️⃣ Deploy the Actor on Apify Run the **bid.cars Lot Scraper** from the Apify platform. #### 2️⃣ Add One or More bid.cars URLs Use the **Bulk URL Mode** to provide multiple search or filter URLs. Example: ``` { "urls": [ "https://bid.cars/en/search/results?search-type=filters&status=All&type=Automobile&make=Mazda&model=All&year-from=1900&year-to=2026&auction-type=All", "https://bid.cars/en/search/results?search-type=filters&status=All&type=Automobile&make=BMW&model=All&year-from=1900&year-to=2026&auction-type=All" ], "maxitems": 50 } ``` #### 3️⃣ Set Maximum Lots per URL Define how many auction lots should be collected from each URL. Example: ``` 50 ``` The scraper will continue loading additional results until: - The maximum limit is reached - Or two consecutive loads return no new results #### 4️⃣ Run the Scraper Launch the Actor and it will automatically process each provided bid.cars search URL and collect structured auction lot data. #### 5️⃣ Export Your Data Download your structured dataset in: - JSON - CSV - Excel XLSX - XML - HTML *** ### πŸ“Š Input Fields | Field | Type | Description | | ---------- | ------- | ------------------------------------------------- | | `urls` | array | List of bid.cars search and filter URLs to scrape | | `maxitems` | integer | Maximum number of auction lots to collect per URL | *** ### πŸ“Š Preconfigured Dataset Views #### πŸ”Ž Overview View Quick overview of extracted auction lot listings. Fields included: - Vehicle Title - Lot ID - VIN - Auction House - Auction Date - Current Bid - Estimated Price - Mileage - Damage - Location - Seller - Image URL - Listing URL - Source URL #### πŸ“„ Detailed View Complete structured auction lot information. Fields included: - Vehicle Title - Lot ID - Lot Number - VIN - Auction House - Auction Type - Auction Date - Time Left - Current Bid - Estimated Price - Drive Status - Mileage - Damage - Engine Specifications - Location - Sale Document - Seller - Image URL - Listing URL - Extraction Date - Source URL #### 🌐 By Source URL View Groups extracted auction lots according to the original bid.cars search or filter URL. Useful for comparing results from multiple search queries, vehicle makes, models, years, and auction filters. *** ### πŸ”₯ Why Use This bid.cars Scraper? βœ” Scrape multiple bid.cars searches in one run βœ” Automate large-scale auction vehicle collection βœ” Collect structured salvage vehicle data βœ” Monitor auction prices and vehicle supply βœ” Analyze damage patterns and vehicle conditions βœ” Research potential resale opportunities βœ” Compare auction inventory across multiple searches βœ” Build automotive market intelligence datasets βœ” Collect VIN and lot information at scale βœ” Save time with automatic Load More handling βœ” No coding required *** ### πŸ’Έ Pricing This scraper runs on a **pay-per-result pricing model**. You only pay for successfully extracted records. πŸ’³ **Price:** **$0.95 / 1,000 results** *** ### ❓ FAQ (SEO BOOST SECTION) #### Can I scrape multiple bid.cars URLs at once? Yes. The scraper supports **Bulk URL Scraping**, allowing you to process multiple bid.cars search and filter URLs in a single run. #### What type of bid.cars URLs are supported? The scraper supports bid.cars search and filter result pages. #### Can I scrape different vehicle makes and models? Yes. You can provide different bid.cars search URLs using the available filters for vehicle make, model, year, type, status, and auction type. #### Can I use multiple languages? Yes. The scraper supports bid.cars locale prefixes including `en`, `pl`, `ru`, and `ua`. #### What does `maxitems` do? The `maxitems` parameter controls the maximum number of auction lots collected per URL. #### Does the scraper automatically load more results? Yes. The scraper automatically uses the Load More functionality to retrieve additional auction results. #### When does the scraper stop loading results? The scraper stops when the configured maximum number of lots is reached or when two consecutive loads return no new results. #### What vehicle data can I extract? You can extract vehicle titles, lot IDs, lot numbers, VINs, auction houses, auction types, auction dates, current bids, estimated prices, mileage, damage, engine specifications, locations, sale documents, sellers, images, listing URLs, and source URLs. #### Can I export the results? Yes. The dataset can be exported in JSON, CSV, Excel XLSX, XML, and HTML formats. #### Is coding required? No. The bid.cars Lot Scraper runs as a no-code Apify Actor. *** ### 🌍 PrimeScrape Automotive Data Ecosystem The **PrimeScrape Automotive Data Intelligence Suite** is built for large-scale vehicle data extraction, auction monitoring, automotive market research, and business intelligence. πŸš— Vehicle auction data extraction πŸ”¨ Salvage vehicle research πŸ“Š Automotive market intelligence πŸ’° Auction pricing analysis πŸ” VIN and vehicle research 🏒 Dealership intelligence πŸ“¦ Car export business data πŸ“ˆ Vehicle market analytics πŸ€– AI-ready automotive datasets βš™οΈ Automated data pipelines *** ### πŸ”— Related Actors (PrimeScrape Ecosystem) We are building a complete **PrimeScrape Data Intelligence Suite** for automated web data extraction, automotive data, e-commerce, jobs, companies, social media, AI datasets, and market intelligence. πŸ‘‰ More scraping tools coming soon πŸš€ *** ### ⚠️ Disclaimer This scraper is an independent automation and data extraction tool. It is **not affiliated with, endorsed by, or sponsored by bid.cars**. Users are responsible for ensuring that their use of the scraper complies with all applicable laws, regulations, and the terms of service of the websites they access. *** ### πŸ“¬ Support ⭐⭐⭐⭐⭐ Leave a 5-star review if you like this scraper! πŸ“© Contact us for custom scraping solutions, feature requests, or enterprise scraping projects. πŸš€ **PrimeScrape β€” Data extraction and automation at scale.** # Actor input Schema ## `urls` (type: `array`): List of bid.cars search/filter URLs to scrape. Examples: β€’ https://bid.cars/en/search/results?search-type=filters\&status=All\&type=Automobile\&make=Mazda\&model=All\&year-from=1900\&year-to=2026\&auction-type=All β€’ https://bid.cars/pl/search/results?search-type=filters\&status=All\&type=Automobile\&make=BMW\&model=All\&year-from=1900\&year-to=2027\&auction-type=All β€’ https://bid.cars/ru/search/results?search-type=filters\&status=All\&type=Automobile\&make=BMW\&model=All\&year-from=1900\&year-to=2027\&auction-type=All β€’ https://bid.cars/ua/search/results?search-type=filters\&status=All\&type=Automobile\&make=BMW\&model=All\&year-from=1900\&year-to=2027\&auction-type=All ⚠️ URLs must be from bid.cars. All locale prefixes (en, pl, ru, ua) are supported. ## `maxitems` (type: `integer`): Maximum number of auction lots to collect per URL. ## Actor input object example ```json { "urls": [ "https://bid.cars/en/search/results?search-type=filters&status=All&type=Automobile&make=Mazda&model=All&year-from=1900&year-to=2026&auction-type=All", "https://bid.cars/en/search/results?search-type=filters&status=All&type=Automobile&make=BMW&model=All&year-from=1900&year-to=2026&auction-type=All" ], "maxitems": 100 } ``` # Actor output Schema ## `overview` (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 = { "urls": [ "https://bid.cars/en/search/results?search-type=filters&status=All&type=Automobile&make=Mazda&model=All&year-from=1900&year-to=2026&auction-type=All", "https://bid.cars/en/search/results?search-type=filters&status=All&type=Automobile&make=BMW&model=All&year-from=1900&year-to=2026&auction-type=All" ], "maxitems": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("delectable_incubator/bid-cars-lot-scraper-low-cost").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 = { "urls": [ "https://bid.cars/en/search/results?search-type=filters&status=All&type=Automobile&make=Mazda&model=All&year-from=1900&year-to=2026&auction-type=All", "https://bid.cars/en/search/results?search-type=filters&status=All&type=Automobile&make=BMW&model=All&year-from=1900&year-to=2026&auction-type=All", ], "maxitems": 100, } # Run the Actor and wait for it to finish run = client.actor("delectable_incubator/bid-cars-lot-scraper-low-cost").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 '{ "urls": [ "https://bid.cars/en/search/results?search-type=filters&status=All&type=Automobile&make=Mazda&model=All&year-from=1900&year-to=2026&auction-type=All", "https://bid.cars/en/search/results?search-type=filters&status=All&type=Automobile&make=BMW&model=All&year-from=1900&year-to=2026&auction-type=All" ], "maxitems": 100 }' | apify call delectable_incubator/bid-cars-lot-scraper-low-cost --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=delectable_incubator/bid-cars-lot-scraper-low-cost", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Bid.cars Lot Scraper - Low-costπŸ’²πŸ”₯πŸš—πŸ”¨", "description": "πŸš— Easily scrape Bid.cars vehicle auction listings from search URLs. Extract vehicle titles, VINs, lot IDs, current bids, auction status, damage details, locations, images, auction URLs & more. Perfect for salvage vehicle research, price tracking, automotive intelligence and market analysis.", "version": "0.0", "x-build-id": "EURkAidCdcDk1HkXl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/delectable_incubator~bid-cars-lot-scraper-low-cost/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-delectable_incubator-bid-cars-lot-scraper-low-cost", "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/delectable_incubator~bid-cars-lot-scraper-low-cost/runs": { "post": { "operationId": "runs-sync-delectable_incubator-bid-cars-lot-scraper-low-cost", "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/delectable_incubator~bid-cars-lot-scraper-low-cost/run-sync": { "post": { "operationId": "run-sync-delectable_incubator-bid-cars-lot-scraper-low-cost", "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": [ "urls", "maxitems" ], "properties": { "urls": { "title": "bid.cars Search URLs πŸš—", "type": "array", "description": "List of bid.cars search/filter URLs to scrape. \n\nExamples:\nβ€’ https://bid.cars/en/search/results?search-type=filters&status=All&type=Automobile&make=Mazda&model=All&year-from=1900&year-to=2026&auction-type=All\nβ€’ https://bid.cars/pl/search/results?search-type=filters&status=All&type=Automobile&make=BMW&model=All&year-from=1900&year-to=2027&auction-type=All\nβ€’ https://bid.cars/ru/search/results?search-type=filters&status=All&type=Automobile&make=BMW&model=All&year-from=1900&year-to=2027&auction-type=All\nβ€’ https://bid.cars/ua/search/results?search-type=filters&status=All&type=Automobile&make=BMW&model=All&year-from=1900&year-to=2027&auction-type=All\n\n⚠️ URLs must be from bid.cars. All locale prefixes (en, pl, ru, ua) are supported.", "items": { "type": "string" } }, "maxitems": { "title": "Maximum Lots per URL πŸ“„", "type": "integer", "description": "Maximum number of auction lots to collect per URL. ", "default": 100 } } }, "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 } } } } } } } } } } ```