# AutoScout24 Scraper (`rigelbytes/autoscout24-scraper`) Actor
Scrape car listings from AutoScout24 with full filter support. Extract makes, models, prices, mileage, seller info, and more.
- **URL**: https://apify.com/rigelbytes/autoscout24-scraper.md
- **Developed by:** [Rigel Bytes](https://apify.com/rigelbytes) (community)
- **Categories:** E-commerce, News, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $1.00 / 1,000 cars
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 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
## AutoScout24 Scraper
Extract thousands of car listings from AutoScout24 β Europe's largest automotive marketplace β to power market research, price monitoring, inventory tracking, and lead generation, all for just **$1** per 1,000 listings.
---
### What can AutoScout24 Scraper do for you?
- **Build comprehensive car databases** across 19 European countries with detailed vehicle specs, pricing, and seller information
- **Monitor market trends** by tracking listing prices, mileage patterns, and vehicle availability over time
- **Analyze competitor inventory** β see what dealers are offering, at what prices, and how quickly inventory turns over
- **Generate sales leads** by extracting seller contact details, company names, and ratings from thousands of listings
- **Feed data pipelines and dashboards** β export structured JSON, CSV, or Excel for BI tools, analytics platforms, and custom applications
- **Search by make, model, or full URL** with support for 30+ filter parameters including price range, mileage, year, fuel type, transmission, and location
### What data can you extract?
Every listing returns **30+ structured data fields**:
| Category | Fields |
|----------|--------|
| π **Identifiers** | `listingId`, `url`, `make`, `model`, `modelId` |
| π° **Pricing** | `priceFormatted`, `priceRaw`, `priceCurrency`, `vatLabel`, `isConditionalPrice` |
| π **Vehicle Specs** | `mileageInKm`, `firstRegistration`, `fuel`, `transmission`, `engineDisplacementInCCM`, `powerKw`, `powerHp` |
| π **Location** | `locationCity`, `locationZip`, `locationCountryCode`, `distanceToSearchLocationInKm` |
| πͺ **Seller Info** | `sellerId`, `sellerType`, `sellerCompanyName`, `sellerContactName`, `sellerRating` |
| πΌοΈ **Media** | `imageUrl`, `images` (gallery array), `hasVideo` |
| π·οΈ **Listing Metadata** | `offerType`, `appliedAdTier`, `isOcs`, `isCurrentlyDamaged`, `availableNow`, `searchResultType` |
### Why use this scraper?
- π **Market Research** β understand supply, demand, and pricing trends across the European used car market
- π **Price Monitoring** β track listing prices over time for specific makes, models, or regions
- π’ **Competitor Analysis** β monitor what other dealers are listing and how they price inventory
- π **Lead Generation** β collect verified dealer contact information and seller ratings at scale
- π€ **Automation** β replace manual browsing with automated data extraction that feeds directly into your CRM, spreadsheet, or database
### Pricing
- **$1/1,000 listings**
- No hidden fees or limits on usage.
- Check the [Pricing tab](https://apify.com/rigelbytes/autoscout24-scraper) on Apify Store for plan-based discounts.
---
### How to use AutoScout24 Scraper
1. **Create a free Apify account** at [apify.com](https://apify.com)
2. **Open the AutoScout24 Scraper** on Apify Store
3. **Enter your search terms** β use search queries like `"audi"`, `"bmw 3er"`, or paste full AutoScout24 search URLs
4. **Set optional filters** β narrow results by price, mileage, year, fuel type, location, and 25+ other parameters
5. **Start the scraper** and watch it extract listings in real time
6. **Download your data** as JSON, CSV, Excel, or access it via the Apify API
### Input
The scraper accepts a rich set of input parameters to customize your search. All fields are optional β by default it runs with sensible defaults.
#### Search Configuration
| Field | Type | Description |
|-------|------|-------------|
| `searchUrls` | array | Full AutoScout24 search URLs. When provided, these take priority over `searchQueries`. |
| `searchQueries` | array | Car makes/models as URL path segments. Examples: `"audi"`, `"bmw 3er"`, `"volkswagen"` |
| `maxItems` | integer | Maximum number of listings to scrape (0 = unlimited) |
| `maxPages` | integer | Maximum result pages per search (0 = unlimited) |
| `sort` | select | Sort by: `standard`, `price`, `mileage`, `age`, `power`, `first_registration` |
| `desc` | boolean | Sort in descending order |
#### Vehicle Filters
| Field | Type | Description |
|-------|------|-------------|
| `ustate` | select | Condition: `N,U` (new & used), `N` (new only), `U` (used only) |
| `atype` | select | Vehicle category: `C` (cars), `B` (motorcycles), `T` (trucks) |
| `pricefrom` | integer | Minimum price in EUR |
| `priceto` | integer | Maximum price in EUR |
| `kmfrom` | integer | Minimum mileage in km |
| `kmto` | integer | Maximum mileage in km |
| `yearfrom` | integer | Minimum first registration year |
| `yearto` | integer | Maximum first registration year |
| `powerfrom` | integer | Minimum engine power |
| `powerto` | integer | Maximum engine power |
| `powertype` | select | Power unit: `kw` or `hp` |
| `gear` | select | Transmission type |
| `fuel` | select | Fuel type |
| `body` | select | Body type |
| `color` | select | Exterior color |
#### Location
| Field | Type | Description |
|-------|------|-------------|
| `zip` | string | ZIP code or city name |
| `zipr` | integer | Search radius in km |
| `city` | string | City name |
| `cy` | select | Country code (default: Germany, 19 countries supported) |
#### Additional Filters
| Field | Type | Description |
|-------|------|-------------|
| `custtype` | select | Seller type: private, dealer, or both |
| `ocs_listing` | select | Include/exclude online car sale listings |
| `damaged_listing` | select | Include/exclude damaged vehicles |
| `pricetype` | select | `public` (listed) or `private` (on request) |
| `emissionclass` | select | Emission class (Euro 1β6d) |
| `emissionsticker` | select | German emission sticker |
| `climatisation` | select | Air conditioning type |
| `interior` | select | Interior material type |
| `consumptionfrom` / `consumptionto` | number | Fuel consumption range (l/100km) |
| `co2from` / `co2to` | integer | CO2 emission range (g/km) |
| `weightfrom` / `weightto` | integer | Weight range (kg) |
| `cylindersfrom` / `cylindersto` | integer | Number of cylinders range |
| `cubiccapacityfrom` / `cubiccapacityto` | integer | Engine displacement range (ccm) |
| `seatsfrom` / `seatsto` | integer | Number of seats range |
| `doorsfrom` / `doorsto` | integer | Number of doors range |
| `proxyConfiguration` | proxy | Proxy settings (default: Apify residential proxies) |
#### π Copy for Use:
```json
{
"searchQueries": ["audi", "bmw 3er", "mercedes-benz"],
"maxItems": 100,
"cy": "D",
"ustate": "N,U",
"atype": "C",
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"]
}
}
````
### Output sample
#### Sample listing data:
```json
{
"listingId": "d92fb2a9-72a8-4b4a-a647-fdba919e9804",
"url": "https://www.autoscout24.de/angebote/audi-a3-sportback-35-tfsi-benzin-schwarz-cat_ma9mo1624-d92fb2a9-...",
"make": "Audi",
"model": "A3",
"modelId": 1624,
"offerType": "U",
"priceFormatted": "β¬ 18.480",
"priceRaw": 18480,
"priceCurrency": "EUR",
"mileageInKm": "72.288 km",
"fuel": "Benzin",
"transmission": "Automatik",
"engineDisplacementInCCM": "1.498 cmΒ³",
"powerKw": 0,
"powerHp": 0,
"locationCity": "Ursensollen",
"locationZip": "92289",
"locationCountryCode": "DE",
"sellerType": "Dealer",
"sellerCompanyName": "Fischer Automobile GmbH & Co. KG",
"sellerRating": "4.5",
"imageUrl": "https://prod.pictures.autoscout24.net/listing-images/...",
"images": ["..."],
"availableNow": true
}
```
### Why Choose This Scraper?
- **Affordable**: Pay only $1 per 1,000 listings scraped.
- **Comprehensive**: Extracts 30+ data fields including pricing, specs, seller details, and images across 19 European countries.
- **Easy to Use**: No coding required β just enter search terms or paste a URL. Runs with one click on Apify.
- **Reliable**: Built with residential proxies, HTTP/2 support, and intelligent retry logic to handle rate limiting and anti-bot measures.
### Recommended Proxy Providers
- ## **Shifter**
- Reliable residential proxies all over the world.
- Cheap rates
- [Order Shifter Now](https://shifter.io/r/YoBB/order)
- Get 10% Off any product, use coupan `rigelbytes-YoBB`.
- ## **OxyLabs**
- **100M+ Proxies**
- Fastest proxies in the market
- Real profile, human-like Residential IPs
- Quality assurance framework for most reliable IPs
- [Get Proxies](https://oxylabs.go2cloud.org/aff_c?offer_id=7\&aff_id=1366\&url_id=7)
- ## **DataImpulse**
- Covers **200+ Counties**
- Reliable Residential Proxies for just $1/GB
- [Get Residential Proxies](https://dataimpulse.com/?aff=89421)
### [](#understanding-proxies)
### π Why Buy Through Our Affiliate Link?
- Exclusive Deals: Some providers may offer special discounts or bonuses when you use our link.
- Support Our Work: Each purchase helps us maintain and improve the tools and services we provide.
- No Extra Cost: You pay the same price, but part of it goes to supporting our efforts.
#### Running via Apify Console
You can run this actor from the Apify Console by providing the necessary input parameters.
#### Running via API
You can trigger this actor using the Apify API, passing the required input in the request body.
### API Examples
#### Python
```shell
import requests
url = "https://api.apify.com/v2/acts/rigelbytes/autoscout24-scraper/runs"
headers = {"Authorization": "Bearer YOUR_APIFY_TOKEN"}
input_data = {
"searchQueries": ["audi", "bmw"],
"maxItems": 100,
"proxyConfiguration": {
"useApifyProxy": true
}
}
response = requests.post(url, json=input_data, headers=headers)
print(response.json())
```
#### JavaScript
```shell
const axios = require('axios');
const url = 'https://api.apify.com/v2/acts/rigelbytes/autoscout24-scraper/runs';
const input = {
searchQueries: ['audi', 'bmw'],
maxItems: 100,
proxyConfiguration: {
useApifyProxy: true
}
};
axios.post(url, input, {
headers: { Authorization: 'Bearer YOUR_APIFY_TOKEN' }
}).then(res => console.log(res.data));
```
#### cURL
```shell
curl -X POST "https://api.apify.com/v2/acts/rigelbytes/autoscout24-scraper/runs" \
-H "Authorization: Bearer YOUR_APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"searchQueries": ["audi", "bmw"],
"maxItems": 100,
"proxyConfiguration": {
"useApifyProxy": true
}
}'
```
### π Other Tools by Rigel Bytes
Explore **78** more scraping tools by Rigel Bytes, organized by use case:
#### π± Social Media
Scrape Instagram, TikTok, LinkedIn, and more for content research and marketing intelligence.
- **[Export Instagram Reels](https://apify.com/rigelbytes/export-instagram-reels)** β Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics.
- **[Facebook Ads Scraper](https://apify.com/rigelbytes/facebook-ads-scraper)** β Extract posts, profiles, and engagement data from Facebook for content research, influencer tracking, and marketing analytics.
- **[Instagram Analytics Tool](https://apify.com/rigelbytes/instagram-analytics-tool)** β Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics.
- **[Instagram Comment Scraper](https://apify.com/rigelbytes/instagram-comment-scraper)** β Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics.
- **[Instagram Creator Stats](https://apify.com/rigelbytes/instagram-creator-stats)** β Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics.
- **[Instagram Engagement Tool](https://apify.com/rigelbytes/instagram-engagement-tool)** β Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics.
- **[Instagram Post Scraper](https://apify.com/rigelbytes/instagram-post-scraper)** β Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics.
- **[instagram-posts](https://apify.com/rigelbytes/instagram-posts)** β Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics.
- **[Instagram Profile Scraper](https://apify.com/rigelbytes/instagram-profile-scraper)** β Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics.
- **[Instagram Reel Scraper](https://apify.com/rigelbytes/instagram-reel-scraper)** β Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics.
- **[linkedin-company-details](https://apify.com/rigelbytes/linkedin-company-details)** β Extract posts, profiles, and engagement data from LinkedIn for content research, influencer tracking, and marketing analytics.
- **[Linkedin Company Scraper](https://apify.com/rigelbytes/linkedin-company-scraper)** β Extract posts, profiles, and engagement data from LinkedIn for content research, influencer tracking, and marketing analytics.
- **[LinkedIn Profile Scraper](https://apify.com/rigelbytes/linkedin-profile-scraper)** β Extract posts, profiles, and engagement data from LinkedIn for content research, influencer tracking, and marketing analytics.
- **[Scrape Instagram Creators](https://apify.com/rigelbytes/scrape-instagram-creators)** β Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics.
- **[Tiktok Comment Scraper](https://apify.com/rigelbytes/tiktok-comment-scraper)** β Extract posts, profiles, and engagement data from TikTok for content research, influencer tracking, and marketing analytics.
- **[Tiktok Creator Stats](https://apify.com/rigelbytes/tiktok-creator-stats)** β Extract posts, profiles, and engagement data from TikTok for content research, influencer tracking, and marketing analytics.
- **[Tiktok Engagement Rate](https://apify.com/rigelbytes/tiktok-engagement-rate)** β Extract posts, profiles, and engagement data from TikTok for content research, influencer tracking, and marketing analytics.
- **[TikTok Profile Scraper](https://apify.com/rigelbytes/tiktok-profile-scraper)** β Extract posts, profiles, and engagement data from TikTok for content research, influencer tracking, and marketing analytics.
#### π Real Estate
Extract property listings, prices, and agent data from top real estate platforms.
- **[Airbnb Address Finder](https://apify.com/rigelbytes/airbnb-address-finder)** β Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis.
- **[Airbnb Availability Calendar](https://apify.com/rigelbytes/airbnb-availability-calendar)** β Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis.
- **[Airbnb Detailed Scraper - Search & Listing Details](https://apify.com/rigelbytes/airbnb-detailed-scraper)** β Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis.
- **[Airbnb Images Downloader](https://apify.com/rigelbytes/airbnb-images-downloader)** β Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis.
- **[Airbnb Listing](https://apify.com/rigelbytes/airbnb-listing)** β Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis.
- **[Airbnb Listing Urls](https://apify.com/rigelbytes/airbnb-listing-urls)** β Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis.
- **[Airbnb Property Details](https://apify.com/rigelbytes/airbnb-property-details)** β Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis.
- **[Airbnb Reviews](https://apify.com/rigelbytes/airbnb-reviews)** β Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis.
- **[Airbnb Scraper - Search & Listing Details](https://apify.com/rigelbytes/airbnb-scraper)** β Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis.
- **[Bayut Scraper](https://apify.com/rigelbytes/bayut-scraper)** β Scrape property listings and market data from Bayut for market research, price monitoring, and investment analysis.
- **[Boligsiden.dk Scraper](https://apify.com/rigelbytes/boligsiden-dk-scraper)** β Scrape Danish real estate listings from Boligsiden.dk β for sale, sold, and rental properties with pricing, details, floor plans, and energy labels.
- **[Daft.ie Property Scraper](https://apify.com/rigelbytes/daft-ie-scraper)** β Scrapes property listings from Daft.ie including residential, rental, commercial, and new homes across Ireland.
- **[dubai-listing-scraper](https://apify.com/rigelbytes/dubai-listing-scraper)** β Extract unlimited property listings from Bayut.com β the UAE's largest real estate platform. Get detailed property data including prices, specs, and agent info.
- **[Export Airbnb Calendar](https://apify.com/rigelbytes/export-airbnb-calendar)** β Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis.
- **[Funda Netherlands Real Estate Scraper](https://apify.com/rigelbytes/funda-nl-scraper)** β Scrape property listings from Funda.nl β the largest real estate platform in the Netherlands. Supports buy and rent, with detailed property data.
- **[Furnished Finder Fast](https://apify.com/rigelbytes/furnished-finder-fast)** β Scrape property listings and market data from Furnished Finder for market research, price monitoring, and investment analysis.
- **[Extract Furnished Finder Hosts](https://apify.com/rigelbytes/furnished-finder-hosts)** β Scrape property listings and market data from Furnished Finder for market research, price monitoring, and investment analysis.
- **[FurnishedFinder](https://apify.com/rigelbytes/furnishedfinder)** β Scrape property listings and market data from Furnished Finder for market research, price monitoring, and investment analysis.
- **[Hemnet.se Scraper - Swedish Real Estate Listings](https://apify.com/rigelbytes/hemnet-se-scraper)** β Scrape property listings from Hemnet.se including for-sale, upcoming, and sold homes. Search by URL or location with detailed property data.
- **[Immobiliare Italy Real Estate Scraper](https://apify.com/rigelbytes/immobiliare-it-scraper)** β Scrape property listings and market data from real estate portals for market research, price monitoring, and investment analysis.
- **[Immobilienscout24](https://apify.com/rigelbytes/immobilienscout24)** β Scrape property listings and market data from real estate portals for market research, price monitoring, and investment analysis.
- **[Immobilienscout24-scraper](https://apify.com/rigelbytes/immobilienscout24-scraper)** β Scrape property listings and market data from real estate portals for market research, price monitoring, and investment analysis.
- **[Immoweb Scraper - Belgium Property Listings](https://apify.com/rigelbytes/immoweb-scraper)** β Scrapes property listings from Immoweb.be. Supports search result extraction with optional property detail enrichment.
- **[Immowelt Property Scraper](https://apify.com/rigelbytes/immowelt-property-scraper)** β The Immowelt Scraper helps you extract unlimited real estate listings from Immowelt with complete details including prices, descriptions, and property features.
- **[Immowelt Scraper](https://apify.com/rigelbytes/immowelt-scraper)** β The Immowelt Scraper helps you extract unlimited real estate listings from Immowelt with complete details including prices, descriptions, and property features.
- **[Land.com Scraper](https://apify.com/rigelbytes/landdotcom-scraper)** β Scrape property listings and market data from Land.com for market research, price monitoring, and investment analysis.
- **[Outdoorsy Scraper](https://apify.com/rigelbytes/outdoorsy-scraper)** β Scrape property listings and market data from Outdoorsy for market research, price monitoring, and investment analysis.
- **[Propertyfinder Scraper](https://apify.com/rigelbytes/propertyfinder-scraper)** β Scrape property listings and market data from Property Finder for market research, price monitoring, and investment analysis.
- **[Redfin Scraper](https://apify.com/rigelbytes/redfin-scraper)** β Scrape property listings and market data from Redfin for market research, price monitoring, and investment analysis.
- **[Rightmove Scraper](https://apify.com/rigelbytes/rightmove-scraper)** β Scrape property listings and market data from Rightmove for market research, price monitoring, and investment analysis.
- **[RVshare Scraper](https://apify.com/rigelbytes/rvshare-scraper)** β Scrape property listings and market data from RVshare for market research, price monitoring, and investment analysis.
- **[Unlimited Redfin Scraper](https://apify.com/rigelbytes/unlimited-redfin-scraper)** β Scrape property listings and market data from Redfin for market research, price monitoring, and investment analysis.
- **[Zillow Detail Scraper](https://apify.com/rigelbytes/zillow-detail-scraper)** β Scrape property listings and market data from Zillow for market research, price monitoring, and investment analysis.
- **[Zillow Scraper](https://apify.com/rigelbytes/zillow-scraper)** β Scrape property listings and market data from Zillow for market research, price monitoring, and investment analysis.
- **[Zoopla Scraper](https://apify.com/rigelbytes/zoopla-scraper)** β Scrape property listings and market data from Zoopla for market research, price monitoring, and investment analysis.
#### βοΈ Travel & Hospitality
Monitor rentals, bookings, and travel listings at scale.
- **[Autotrader Scraper](https://apify.com/rigelbytes/autotrader-scraper)** β Scrapes car listings from Autotrader.com with advanced search filters, pagination, and detailed vehicle data.
- **[CarMax Scraper](https://apify.com/rigelbytes/carmax-scraper)** β Scrapes used car listings from CarMax.com with search URL, zip code filtering, and pagination support.
- **[Cars.com Scraper](https://apify.com/rigelbytes/cars-scraper)** β Scrapes car listings from Cars.com using their GraphQL API. Extracts detailed vehicle data including price, specs, VIN, and dealer info.
- **[Ticketmaster Scraper](https://apify.com/rigelbytes/ticketmaster-scraper)** β Collect rental and travel listings from Ticketmaster for pricing intelligence and availability tracking.
#### π E-commerce
Scrape products, prices, and marketplace data for competitive research.
- **[Amazon Product Scraper](https://apify.com/rigelbytes/amazon-product-scraper)** β Scrape products, prices, and seller data from Amazon for competitor monitoring, pricing, and product research.
- **[Amazon Search Scraper](https://apify.com/rigelbytes/amazon-scraper)** β Scrape products, prices, and seller data from Amazon for competitor monitoring, pricing, and product research.
- **[Daraz](https://apify.com/rigelbytes/daraz)** β Scrape products, prices, and seller data from Daraz for competitor monitoring, pricing, and product research.
- **[Etsy Scraper](https://apify.com/rigelbytes/etsy-scraper)** β Scrape products, prices, and seller data from Etsy for competitor monitoring, pricing, and product research.
- **[Homedepot Scraper](https://apify.com/rigelbytes/homedepot-scraper)** β HomeDepot Products Scraper lets you extract product data from homedepot.com using a collection URL and delivery ZIP. Get pricing, availability, specs, and media.
- **[Otodom Scraper - Polish Real Estate Listings](https://apify.com/rigelbytes/otodom-scraper)** β Scrapes property listings from Otodom.pl, Poland's leading real estate marketplace. Supports filters for transaction type, property type, price, and area.
#### πΌ Jobs & Recruitment
Collect job listings and company hiring data for market analysis.
- **[ZipRecruiter Job Scraper](https://apify.com/rigelbytes/ziprecruiter-scraper)** β Scrape job listings from ZipRecruiter with search queries, locations, and radius filters. Extracts title, company, location, salary, and job description.
#### π© Lead Generation
Find business contacts, leads, and company data for sales and outreach.
- **[Company Service Finder](https://apify.com/rigelbytes/company-service-finder)** β The Company Service Finder uses AI to extract and analyze company services from Google Search & Maps. Get detailed service descriptions, categories, and business insights.
- **[Doctify Scraper](https://apify.com/rigelbytes/doctify-scraper)** β Doctify Scraper lets you extract doctor and practice data from doctify.com using a search results URL. Collect specialties, locations, ratings, and professional profiles.
- **[FindLaw Law Firm Scraper - Attorney & Law Firm Data Extraction](https://apify.com/rigelbytes/findlaw-scraper)** β Scrape law firm profiles from FindLaw.com. Extract detailed attorney and firm information including contact details, practice areas, and ratings.
- **[Google Maps Scraper](https://apify.com/rigelbytes/google-maps-scraper)** β Find business leads and contact details from Google Maps for outbound sales, prospecting, and CRM enrichment.
- **[Website Services Finder](https://apify.com/rigelbytes/website-services-finder)** β Automatically extract and analyze company services from any business website using advanced AI. Choose from 5 AI models including GPT-4, Claude 3.5, and Gemini 1.5.
- **[Zillow Agents](https://apify.com/rigelbytes/zillow-agents)** β Find business leads and contact details from Zillow for outbound sales, prospecting, and CRM enrichment.
- **[Zillow Agents Phone](https://apify.com/rigelbytes/zillow-agents-phone)** β Find business leads and contact details from Zillow for outbound sales, prospecting, and CRM enrichment.
#### β Reviews & Ratings
Monitor reviews and reputation data across review platforms.
- **[Airbnb Listing Reviews](https://apify.com/rigelbytes/airbnb-listing-reviews)** β Collect reviews and ratings from Airbnb for reputation monitoring and customer insights.
- **[BBB Scraper](https://apify.com/rigelbytes/bbb-scraper)** β Collect reviews and ratings from BBB for reputation monitoring and customer insights.
- **[Rottentomatoes Reviews Scraper](https://apify.com/rigelbytes/rottentomatoes-reviews-scraper)** β Collect reviews and ratings from Rotten Tomatoes for reputation monitoring and customer insights.
- **[Trustpilot Reviews Scraper](https://apify.com/rigelbytes/trustpilot-reviews)** β Collect reviews and ratings from Trustpilot for reputation monitoring and customer insights.
#### π Food & Delivery
Extract restaurant, grocery, and delivery platform data.
- **[Instacart Scraper](https://apify.com/rigelbytes/instacart-scraper)** β Scrape menus, stores, and delivery data from Instacart for data-driven research and automation.
- **[Publix Scraper](https://apify.com/rigelbytes/publix-scraper)** β Scrape menus, stores, and delivery data from Publix for data-driven research and automation.
#### π οΈ Developer Tools
General-purpose scraping and automation tools.
- **[Web Crawler](https://apify.com/rigelbytes/webcrawler)** β This web crawler is designed to provide users with complete flexibility by allowing them to use their own custom scraping code. Supports JavaScript rendering, proxy rotation, and custom request handling.
### Understanding Proxies:
When scraping data or browsing anonymously, proxies are essential. They act as intermediaries, masking your original IP address and allowing you to send requests from another location.
#### Why Use Proxies?
- Avoid IP Blocks: By routing requests through proxies, you prevent the target website from recognizing your IP as a scraper or spammer.
- Access Geo-restricted Content: Proxies let you access content or websites restricted by location.
- Enhance Anonymity: Hide your actual IP, ensuring privacy while scraping or browsing.
#### Types of Proxies
1. Residential Proxies
- Real IP addresses provided by ISPs to home users.
- They mimic regular users, making them harder to detect.
- Best for: Long-term, undetectable scraping, and avoiding blocks.
2. Data Center Proxies
- IP addresses from servers in data centers.
- Faster and cheaper than residential proxies but easier to detect and block.
- Best for: High-speed scraping, but with a higher risk of detection.
3. Mobile Proxies
- IPs provided by mobile carriers (3G/4G/5G networks).
- Very difficult to detect, as they appear as regular mobile users.
- Best for: Mobile-related scraping or avoiding sophisticated blocks.
#### Rotating Proxies vs. Straight Proxies
- Rotating Proxies: Every request you send goes through a different proxy, making it harder for websites to detect patterns.
- Straight Proxies: All requests are sent through the same proxy, making it easier to track your IP.
### About Rigel Bytes
Rigel Bytes specializes in web scraping, automation, and data analytics. We help businesses extract and leverage valuable data for informed decision-making.
### Contact Us
Ready to unlock the power of data? Reach out to us at (contact@rigelbytes.com) or [book an appointment](https://cal.com/faizanali/appointments) with us to learn more about how we can help you achieve your data goals.
### Detailed Data
Click to see sample output
```json
[
{
"listingId": "d92fb2a9-72a8-4b4a-a647-fdba919e9804",
"url": "https://www.autoscout24.de/angebote/audi-a3-sportback-35-tfsi-benzin-schwarz-cat_ma9mo1624-d92fb2a9-72a8-4b4a-a647-fdba919e9804",
"make": "Audi",
"model": "A3",
"modelId": 1624,
"offerType": "U",
"priceFormatted": "β¬ 18.480",
"priceRaw": 18480,
"priceCurrency": "EUR",
"vatLabel": "",
"isConditionalPrice": false,
"mileageInKm": "72.288 km",
"firstRegistration": "",
"fuel": "Benzin",
"transmission": "Automatik",
"engineDisplacementInCCM": "1.498 cmΒ³",
"powerKw": 0,
"powerHp": 0,
"isCurrentlyDamaged": false,
"locationCity": "Ursensollen",
"locationZip": "92289",
"locationCountryCode": "DE",
"distanceToSearchLocationInKm": 0,
"sellerId": "8748486",
"sellerType": "Dealer",
"sellerCompanyName": "Fischer Automobile GmbH & Co. KG",
"sellerContactName": "",
"sellerRating": "4.5",
"imageUrl": "https://prod.pictures.autoscout24.net/listing-images/...",
"images": ["..."],
"hasVideo": false,
"appliedAdTier": "T50",
"isOcs": false,
"availableNow": true,
"searchResultType": "Nfm"
},
{
"listingId": "6e6666f8-9be9-477d-b8a6-d27723b5f899",
"url": "https://www.autoscout24.de/angebote/audi-a6-avant-40tdi-quattro-sport-c8-matrix-dsg-diesel-weiss-cat_ma9mo1628-6e6666f8-9be9-477d-b8a6-d27723b5f899",
"make": "Audi",
"model": "A6",
"modelId": 1628,
"offerType": "U",
"priceFormatted": "β¬ 26.700",
"priceRaw": 26700,
"priceCurrency": "EUR",
"vatLabel": "inkl. MwSt.",
"isConditionalPrice": false,
"mileageInKm": "108.397 km",
"firstRegistration": "",
"fuel": "Diesel",
"transmission": "Automatik",
"engineDisplacementInCCM": "1.968 cmΒ³",
"powerKw": 0,
"powerHp": 0,
"isCurrentlyDamaged": false,
"locationCity": "MΓΌnchen",
"locationZip": "81825",
"locationCountryCode": "DE",
"distanceToSearchLocationInKm": 0,
"sellerId": "27264",
"sellerType": "Dealer",
"sellerCompanyName": "Auto-Vision",
"sellerContactName": "Sales Team",
"sellerRating": "4.5",
"imageUrl": "https://prod.pictures.autoscout24.net/listing-images/...",
"images": ["..."],
"hasVideo": false,
"appliedAdTier": "T50",
"isOcs": false,
"availableNow": true,
"searchResultType": "Organic"
},
{
"listingId": "e1961d9b-d4a3-47ef-be93-638b19ca06c9",
"url": "https://www.autoscout24.de/angebote/audi-q5-sportback-2-0-tdi-quattro-sline-ahk-rueck-diesel-grau-cat_ma9mo19155-e1961d9b-d4a3-47ef-be93-638b19ca06c9",
"make": "Audi",
"model": "Q5",
"modelId": 19155,
"offerType": "U",
"priceFormatted": "β¬ 64.990",
"priceRaw": 64990,
"priceCurrency": "EUR",
"vatLabel": "inkl. MwSt.",
"isConditionalPrice": false,
"mileageInKm": "4.150 km",
"firstRegistration": "",
"fuel": "Diesel",
"transmission": "Automatik",
"engineDisplacementInCCM": "1.968 cmΒ³",
"powerKw": 0,
"powerHp": 0,
"isCurrentlyDamaged": false,
"locationCity": "St. Wendel",
"locationZip": "66606",
"locationCountryCode": "DE",
"distanceToSearchLocationInKm": 0,
"sellerId": "48077078",
"sellerType": "Dealer",
"sellerCompanyName": "Autohaus KrΓΆninger GmbH & Co. KG",
"sellerContactName": "Verkaufsteam",
"sellerRating": "5",
"imageUrl": "https://prod.pictures.autoscout24.net/listing-images/...",
"images": ["..."],
"hasVideo": false,
"appliedAdTier": "T50",
"isOcs": false,
"availableNow": true,
"searchResultType": "Organic"
}
]
```
# Actor input Schema
## `searchUrls` (type: `array`):
Full AutoScout24 search URLs (e.g. https://www.autoscout24.de/lst/audi?city=Berlin\&priceto=40000). When provided, these take priority over searchQueries.
## `searchQueries` (type: `array`):
Car makes or models to search for. Enter as autoscout24 URL path segments. Examples: 'audi', 'bmw', 'volkswagen', 'bmw 1er' (BMW 1 Series), 'audi a4' (Audi A4), 'mercedes-benz' (Mercedes-Benz). Use hyphens for multi-word brands and / (space) for brand/model separation.
## `maxItems` (type: `integer`):
Maximum number of listings to scrape (0 = unlimited)
## `maxPages` (type: `integer`):
Maximum number of result pages to scrape per search (0 = unlimited)
## `sort` (type: `string`):
How to sort the results
## `desc` (type: `boolean`):
Sort in descending order
## `ustate` (type: `string`):
New, used, or both
## `atype` (type: `string`):
Vehicle category
## `pricefrom` (type: `integer`):
Filter by minimum price in EUR
## `priceto` (type: `integer`):
Filter by maximum price in EUR
## `kmfrom` (type: `integer`):
Filter by minimum mileage in kilometers
## `kmto` (type: `integer`):
Filter by maximum mileage in kilometers
## `yearfrom` (type: `integer`):
Filter by minimum first registration year
## `yearto` (type: `integer`):
Filter by maximum first registration year
## `powerfrom` (type: `integer`):
Filter by minimum engine power (unit depends on powertype setting)
## `powerto` (type: `integer`):
Filter by maximum engine power (unit depends on powertype setting)
## `powertype` (type: `string`):
Unit for power filter values
## `seatsfrom` (type: `integer`):
Filter by minimum number of seats
## `seatsto` (type: `integer`):
Filter by maximum number of seats
## `doorsfrom` (type: `integer`):
Filter by minimum number of doors
## `doorsto` (type: `integer`):
Filter by maximum number of doors
## `gear` (type: `string`):
Filter by transmission type (comma-separated codes)
## `fuel` (type: `string`):
Filter by fuel type (comma-separated codes)
## `body` (type: `string`):
Filter by body type (comma-separated codes)
## `color` (type: `string`):
Filter by exterior color (comma-separated codes)
## `zip` (type: `string`):
Filter by location (ZIP code or city name, e.g. 'Berlin' or '10115')
## `zipr` (type: `integer`):
Search radius around the ZIP/city in kilometers
## `city` (type: `string`):
City name for location-based search
## `cy` (type: `string`):
Filter by country code
## `custtype` (type: `string`):
Filter by seller type
## `ocs_listing` (type: `string`):
Include/exclude online car sale listings
## `damaged_listing` (type: `string`):
Include or exclude damaged/repaired vehicles
## `pricetype` (type: `string`):
Price visibility type
## `emissionclass` (type: `string`):
Filter by emission class (comma-separated codes)
## `emissionsticker` (type: `string`):
Filter by German emission sticker (Umweltplakette)
## `climatisation` (type: `string`):
Filter by air conditioning type (comma-separated codes)
## `interior` (type: `string`):
Filter by interior material type (comma-separated codes)
## `consumptionfrom` (type: `number`):
Filter by minimum fuel consumption
## `consumptionto` (type: `number`):
Filter by maximum fuel consumption
## `co2from` (type: `integer`):
Filter by minimum CO2 emissions
## `co2to` (type: `integer`):
Filter by maximum CO2 emissions
## `weightfrom` (type: `integer`):
Filter by minimum weight in kilograms
## `weightto` (type: `integer`):
Filter by maximum weight in kilograms
## `cylindersfrom` (type: `integer`):
Filter by minimum number of cylinders
## `cylindersto` (type: `integer`):
Filter by maximum number of cylinders
## `cubiccapacityfrom` (type: `integer`):
Filter by minimum engine displacement in ccm
## `cubiccapacityto` (type: `integer`):
Filter by maximum engine displacement in ccm
## `proxyConfiguration` (type: `object`):
Proxy settings for anti-bot protection
## Actor input object example
```json
{
"searchUrls": [
{
"url": "https://www.autoscout24.de/lst/audi"
}
],
"searchQueries": [
"audi",
"bmw 3er"
],
"maxItems": 0,
"maxPages": 0,
"sort": "standard",
"desc": false,
"ustate": "N,U",
"atype": "C",
"powertype": "kw",
"gear": "",
"fuel": "",
"body": "",
"color": "",
"zipr": 0,
"cy": "D",
"custtype": "",
"ocs_listing": "include",
"damaged_listing": "exclude",
"pricetype": "public",
"emissionclass": "",
"emissionsticker": "",
"climatisation": "",
"interior": "",
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
```
# Actor output Schema
## `results` (type: `string`):
Dataset containing scraped car listings
# 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 = {
"searchUrls": [
{
"url": "https://www.autoscout24.de/lst/audi"
}
],
"searchQueries": [
"audi",
"bmw 3er"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("rigelbytes/autoscout24-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 = {
"searchUrls": [{ "url": "https://www.autoscout24.de/lst/audi" }],
"searchQueries": [
"audi",
"bmw 3er",
],
}
# Run the Actor and wait for it to finish
run = client.actor("rigelbytes/autoscout24-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 '{
"searchUrls": [
{
"url": "https://www.autoscout24.de/lst/audi"
}
],
"searchQueries": [
"audi",
"bmw 3er"
]
}' |
apify call rigelbytes/autoscout24-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=rigelbytes/autoscout24-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "AutoScout24 Scraper",
"description": "Scrape car listings from AutoScout24 with full filter support. Extract makes, models, prices, mileage, seller info, and more.",
"version": "1.0",
"x-build-id": "4rbo2mshmkGKq1l03"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/rigelbytes~autoscout24-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-rigelbytes-autoscout24-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/rigelbytes~autoscout24-scraper/runs": {
"post": {
"operationId": "runs-sync-rigelbytes-autoscout24-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/rigelbytes~autoscout24-scraper/run-sync": {
"post": {
"operationId": "run-sync-rigelbytes-autoscout24-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": {
"searchUrls": {
"title": "Search URLs",
"type": "array",
"description": "Full AutoScout24 search URLs (e.g. https://www.autoscout24.de/lst/audi?city=Berlin&priceto=40000). When provided, these take priority over searchQueries.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"searchQueries": {
"title": "Search Queries",
"type": "array",
"description": "Car makes or models to search for. Enter as autoscout24 URL path segments. Examples: 'audi', 'bmw', 'volkswagen', 'bmw 1er' (BMW 1 Series), 'audi a4' (Audi A4), 'mercedes-benz' (Mercedes-Benz). Use hyphens for multi-word brands and / (space) for brand/model separation.",
"default": []
},
"maxItems": {
"title": "Max Items",
"minimum": 0,
"type": "integer",
"description": "Maximum number of listings to scrape (0 = unlimited)",
"default": 0
},
"maxPages": {
"title": "Max Pages",
"minimum": 0,
"type": "integer",
"description": "Maximum number of result pages to scrape per search (0 = unlimited)",
"default": 0
},
"sort": {
"title": "Sort By",
"enum": [
"standard",
"price",
"mileage",
"age",
"power",
"first_registration"
],
"type": "string",
"description": "How to sort the results",
"default": "standard"
},
"desc": {
"title": "Descending Sort",
"type": "boolean",
"description": "Sort in descending order",
"default": false
},
"ustate": {
"title": "Vehicle Condition",
"enum": [
"N,U",
"N",
"U"
],
"type": "string",
"description": "New, used, or both",
"default": "N,U"
},
"atype": {
"title": "Article Type",
"enum": [
"C",
"B",
"T"
],
"type": "string",
"description": "Vehicle category",
"default": "C"
},
"pricefrom": {
"title": "Minimum Price (EUR)",
"minimum": 0,
"type": "integer",
"description": "Filter by minimum price in EUR"
},
"priceto": {
"title": "Maximum Price (EUR)",
"minimum": 0,
"type": "integer",
"description": "Filter by maximum price in EUR"
},
"kmfrom": {
"title": "Minimum Mileage (km)",
"minimum": 0,
"type": "integer",
"description": "Filter by minimum mileage in kilometers"
},
"kmto": {
"title": "Maximum Mileage (km)",
"minimum": 0,
"type": "integer",
"description": "Filter by maximum mileage in kilometers"
},
"yearfrom": {
"title": "Minimum Year",
"minimum": 1900,
"type": "integer",
"description": "Filter by minimum first registration year"
},
"yearto": {
"title": "Maximum Year",
"minimum": 1900,
"type": "integer",
"description": "Filter by maximum first registration year"
},
"powerfrom": {
"title": "Minimum Power",
"minimum": 0,
"type": "integer",
"description": "Filter by minimum engine power (unit depends on powertype setting)"
},
"powerto": {
"title": "Maximum Power",
"minimum": 0,
"type": "integer",
"description": "Filter by maximum engine power (unit depends on powertype setting)"
},
"powertype": {
"title": "Power Unit",
"enum": [
"kw",
"hp"
],
"type": "string",
"description": "Unit for power filter values",
"default": "kw"
},
"seatsfrom": {
"title": "Minimum Seats",
"minimum": 0,
"type": "integer",
"description": "Filter by minimum number of seats"
},
"seatsto": {
"title": "Maximum Seats",
"minimum": 0,
"type": "integer",
"description": "Filter by maximum number of seats"
},
"doorsfrom": {
"title": "Minimum Doors",
"minimum": 0,
"type": "integer",
"description": "Filter by minimum number of doors"
},
"doorsto": {
"title": "Maximum Doors",
"minimum": 0,
"type": "integer",
"description": "Filter by maximum number of doors"
},
"gear": {
"title": "Transmission",
"enum": [
"",
"A",
"M",
"S",
"A,M",
"A,S",
"M,S",
"A,M,S"
],
"type": "string",
"description": "Filter by transmission type (comma-separated codes)",
"default": ""
},
"fuel": {
"title": "Fuel Type",
"enum": [
"",
"B",
"D",
"E",
"L",
"C",
"2",
"3",
"O"
],
"type": "string",
"description": "Filter by fuel type (comma-separated codes)",
"default": ""
},
"body": {
"title": "Body Type",
"enum": [
"",
"L",
"K",
"U",
"M",
"C",
"G",
"V",
"R",
"O"
],
"type": "string",
"description": "Filter by body type (comma-separated codes)",
"default": ""
},
"color": {
"title": "Exterior Color",
"enum": [
"",
"B",
"G",
"R",
"W",
"S",
"Y",
"O",
"V",
"N",
"M"
],
"type": "string",
"description": "Filter by exterior color (comma-separated codes)",
"default": ""
},
"zip": {
"title": "ZIP Code / City",
"type": "string",
"description": "Filter by location (ZIP code or city name, e.g. 'Berlin' or '10115')"
},
"zipr": {
"title": "Search Radius (km)",
"minimum": 0,
"type": "integer",
"description": "Search radius around the ZIP/city in kilometers",
"default": 0
},
"city": {
"title": "City",
"type": "string",
"description": "City name for location-based search"
},
"cy": {
"title": "Country",
"enum": [
"D",
"A",
"B",
"F",
"I",
"E",
"NL",
"LU",
"CH",
"PL",
"CZ",
"SK",
"HU",
"SI",
"HR",
"RO",
"LT",
"LV",
"EE"
],
"type": "string",
"description": "Filter by country code",
"default": "D"
},
"custtype": {
"title": "Seller Type",
"enum": [
"",
"D",
"H",
"D,H"
],
"type": "string",
"description": "Filter by seller type",
"default": ""
},
"ocs_listing": {
"title": "Online Car Sale Listings",
"enum": [
"include",
"exclude"
],
"type": "string",
"description": "Include/exclude online car sale listings",
"default": "include"
},
"damaged_listing": {
"title": "Damaged Listings",
"enum": [
"exclude",
"include",
"only"
],
"type": "string",
"description": "Include or exclude damaged/repaired vehicles",
"default": "exclude"
},
"pricetype": {
"title": "Price Type",
"enum": [
"public",
"private"
],
"type": "string",
"description": "Price visibility type",
"default": "public"
},
"emissionclass": {
"title": "Emission Class",
"enum": [
"",
"E1",
"E2",
"E3",
"E4",
"E5",
"E6",
"E6D"
],
"type": "string",
"description": "Filter by emission class (comma-separated codes)",
"default": ""
},
"emissionsticker": {
"title": "Emission Sticker",
"enum": [
"",
"1",
"2",
"3",
"4"
],
"type": "string",
"description": "Filter by German emission sticker (Umweltplakette)",
"default": ""
},
"climatisation": {
"title": "Air Conditioning",
"enum": [
"",
"A",
"B",
"C"
],
"type": "string",
"description": "Filter by air conditioning type (comma-separated codes)",
"default": ""
},
"interior": {
"title": "Interior Material",
"enum": [
"",
"C",
"F",
"V",
"S",
"O"
],
"type": "string",
"description": "Filter by interior material type (comma-separated codes)",
"default": ""
},
"consumptionfrom": {
"title": "Min Fuel Consumption (l/100km)",
"minimum": 0,
"type": "number",
"description": "Filter by minimum fuel consumption"
},
"consumptionto": {
"title": "Max Fuel Consumption (l/100km)",
"minimum": 0,
"type": "number",
"description": "Filter by maximum fuel consumption"
},
"co2from": {
"title": "Min CO2 Emission (g/km)",
"minimum": 0,
"type": "integer",
"description": "Filter by minimum CO2 emissions"
},
"co2to": {
"title": "Max CO2 Emission (g/km)",
"minimum": 0,
"type": "integer",
"description": "Filter by maximum CO2 emissions"
},
"weightfrom": {
"title": "Min Weight (kg)",
"minimum": 0,
"type": "integer",
"description": "Filter by minimum weight in kilograms"
},
"weightto": {
"title": "Max Weight (kg)",
"minimum": 0,
"type": "integer",
"description": "Filter by maximum weight in kilograms"
},
"cylindersfrom": {
"title": "Min Number of Cylinders",
"minimum": 0,
"type": "integer",
"description": "Filter by minimum number of cylinders"
},
"cylindersto": {
"title": "Max Number of Cylinders",
"minimum": 0,
"type": "integer",
"description": "Filter by maximum number of cylinders"
},
"cubiccapacityfrom": {
"title": "Min Engine Displacement (ccm)",
"minimum": 0,
"type": "integer",
"description": "Filter by minimum engine displacement in ccm"
},
"cubiccapacityto": {
"title": "Max Engine Displacement (ccm)",
"minimum": 0,
"type": "integer",
"description": "Filter by maximum engine displacement in ccm"
},
"proxyConfiguration": {
"title": "Proxy Configuration",
"type": "object",
"description": "Proxy settings for anti-bot protection",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```