# Arabam.com Vehicle Scraper (`seralifatih/turkish-automotive-intelligence-suite`) Actor Extract structured used-car listings from Arabam.com, including price, mileage, specs, seller details, location, condition data, and optional detail-page enrichment. - **URL**: https://apify.com/seralifatih/turkish-automotive-intelligence-suite.md - **Developed by:** [Fatih İlhan](https://apify.com/seralifatih) (community) - **Categories:** Automation, E-commerce - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 vehicle listings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ## Arabam.com Vehicle Scraper — Turkish Auto Marketplace Data API **arabam veri çekme | araba fiyat | ikinci el otomobil** Extract comprehensive vehicle listing data from [arabam.com](https://www.arabam.com) — Turkey's largest dedicated automotive marketplace with 400,000+ active listings. Supports filter-based search and direct URL scraping. --- ### What You Get Each vehicle record includes: - **Full specifications**: year, mileage, fuel type, transmission, engine size, horsepower, color, body type, drivetrain - **Condition data**: paint condition (boya durumu — panels painted/replaced), accident/Tramer history - **Pricing**: amount in TRY, negotiability flag, swap (takas) availability - **Seller info**: dealer vs. private owner vs. authorized dealer, name, phone - **Location**: city, district - **All images**: full-resolution URLs from arabam's CDN - **Description**: full listing text - **Complete specs table**: every field as key-value pairs --- ### Input Two modes — use either filters or direct URLs: #### Mode 1: Filter-based search ```json { "filters": { "make": "volkswagen", "model": "passat", "yearMin": 2018, "yearMax": 2023, "priceMin": 500000, "priceMax": 2000000, "fuelType": "dizel", "transmission": "otomatik", "city": "istanbul" }, "maxListings": 200, "scrapeDetails": true, "proxyConfig": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "countryCode": "TR" } } ```` #### Mode 2: Direct URLs ```json { "searchUrls": [ "https://www.arabam.com/ikinci-el/otomobil/toyota-corolla", "https://www.arabam.com/ikinci-el/otomobil/bmw-3-serisi" ], "listingUrls": [ "https://www.arabam.com/ilan/galeriden-satilik-volkswagen-passat/39355250" ], "maxListings": 500, "scrapeDetails": true } ``` #### Input parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `filters.make` | string | — | Vehicle make slug (e.g. `volkswagen`, `toyota`, `bmw`) | | `filters.model` | string | — | Vehicle model slug (e.g. `passat`, `corolla`) | | `filters.yearMin` | integer | — | Minimum model year | | `filters.yearMax` | integer | — | Maximum model year | | `filters.priceMin` | integer | — | Minimum price in TRY | | `filters.priceMax` | integer | — | Maximum price in TRY | | `filters.mileageMax` | integer | — | Maximum mileage in km | | `filters.fuelType` | enum | — | `benzin`, `dizel`, `lpg`, `hybrid`, `elektrik`, `benzin_lpg` | | `filters.transmission` | enum | — | `manuel`, `otomatik`, `yarı_otomatik` | | `filters.city` | string | — | City in Turkish (e.g. `istanbul`, `ankara`) | | `searchUrls` | array | `[]` | Direct search result page URLs | | `listingUrls` | array | `[]` | Direct vehicle detail page URLs | | `maxListings` | integer | `200` | Maximum records to scrape (1–10,000) | | `scrapeDetails` | boolean | `true` | Visit detail pages for full specs (slower, comprehensive) | | `proxyConfig` | object | — | Proxy settings (residential TR recommended) | *** ### Output Each record is pushed to the default dataset. Two record types: #### Vehicle record (`scrapeDetails: true`) ```json { "listingId": "39355250", "title": "Volkswagen Passat 1.5 TSi Business", "url": "https://www.arabam.com/ilan/galeriden-satilik-volkswagen-passat-1-5-tsi-business/39355250", "make": "Volkswagen", "model": "Passat", "variant": "1.5 TSi Business", "year": 2021, "bodyType": "sedan", "mileage": 134000, "fuelType": "benzin", "transmission": "otomatik", "engineSize": 1498, "horsePower": 150, "drivetrain": "FWD", "color": "Siyah", "doors": 4, "price": { "amount": 1915000, "currency": "TRY" }, "negotiable": false, "paintCondition": { "originalText": "Boyasız", "paintedPanels": 0, "replacedPanels": 0, "isOriginal": true }, "accidentHistory": "Kazasız", "swapAvailable": true, "city": "Amasya", "district": "Merkez", "sellerType": "galeri", "sellerName": "ABC Otomotiv", "sellerPhone": null, "listingDate": "2024-03-15", "imageUrls": [ "https://arbstorage.mncdn.com/ilanfotograflari/2024/03/15/39355250/abc_1920x1080.jpg" ], "imageCount": 12, "featured": false, "description": "Aracımız tam bakımlıdır, hasarsız, boyasızdır...", "specifications": { "Marka": "Volkswagen", "Model": "Passat", "Yıl": "2021", "Kilometre": "134.000 km", "Yakıt Tipi": "Benzin", "Vites Tipi": "Otomatik", "Kasa Tipi": "Sedan", "Renk": "Siyah", "Motor Hacmi": "1498 cc", "Motor Gücü": "150 hp", "Boya-Değişen": "Boyasız" }, "damageReport": null, "scrapedAt": "2024-04-01T10:30:00.000Z", "sourceUrl": "https://www.arabam.com/ilan/..." } ``` #### Run summary (always appended at end) ```json { "type": "RUN_SUMMARY", "totalRecords": 187, "durationSeconds": 420, "errors": 2, "warnings": ["Failed: https://..."], "inputSummary": { "maxListings": 200, "scrapeDetails": true, "initialRequests": 1 } } ``` *** ### Paint Condition (Boya Durumu) Paint condition is the most important vehicle condition signal in the Turkish used-car market. This scraper always extracts and parses it: | Turkish text | paintedPanels | replacedPanels | isOriginal | |--------------|--------------|----------------|------------| | `Boyasız` | 0 | 0 | `true` | | `Tamamı orjinal` | 0 | 0 | `true` | | `2 boyalı` | 2 | 0 | `false` | | `3 boya 1 değişen` | 3 | 1 | `false` | *** ### Technical Notes #### Proxy Requirements Turkish residential proxies are strongly recommended. Arabam.com uses JavaScript rendering and may restrict datacenter IPs. Configure via `proxyConfig`: ```json { "proxyConfig": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "countryCode": "TR" } } ``` #### Scrape Modes | Mode | Speed | Data Completeness | Cost | |------|-------|-------------------|------| | `scrapeDetails: false` | Fast | Basic (no specs table, no images) | ~1 compute unit / 1K listings | | `scrapeDetails: true` | Slower | Full (all fields) | ~5 compute units / 1K listings | #### Pagination The scraper uses arabam.com's `skip`/`take` pagination system. Each search page returns up to 20 listings. The scraper automatically paginates until `maxListings` is reached. *** ### Pricing **$6 per 1,000 vehicle listings** Charged on successful records pushed to the dataset. Run summary records are free. *** ### FAQ **Why is `sellerPhone` null?** Arabam.com hides phone numbers until a user clicks "Telefonu Göster." The phone reveal requires authentication and is not scrappable without a logged-in session. **Can I scrape all listings without filters?** Yes — use `https://www.arabam.com/ikinci-el/otomobil` as a `searchUrls` entry. Set `maxListings` to control volume. **How fresh is the data?** This actor scrapes in real-time — data is as fresh as your run. Arabam listings change frequently. For daily monitoring, schedule the actor to run daily. **What if the scraper gets blocked?** - Ensure you're using TR residential proxies - If still blocked, try reducing `maxConcurrency` by setting it lower (contact support) *** ### Also by this developer #### Turkish E-Commerce Intelligence Suite - **N11.com Product Scraper** — Turkey's third-largest e-commerce platform - **Turkish Marketplace Seller Intelligence** — Cross-platform seller analytics - **Turkish Product Review Aggregator** — Customer review data at scale #### Turkish Automotive Intelligence Suite - **Turkish Auto Price Tracker** — Cross-platform price comparison (Arabam + Sahibinden + OtoMoto) - **Turkish Auto Dealer Intelligence** — Dealer/galeri profiles and inventory analytics *** *Building the definitive data intelligence toolkit for Turkey. Specializing in Turkish e-commerce and automotive market data. 6 actors | 2 verticals | Pay-per-event pricing.* # Actor input Schema ## `searchUrls` (type: `array`): Direct arabam.com search or category result page URLs. Use this or filters, not both. ## `listingUrls` (type: `array`): Direct arabam.com vehicle detail page URLs to scrape. Can be combined with other inputs. ## `filters` (type: `object`): Build a search URL from filters when searchUrls is not provided. ## `maxListings` (type: `integer`): Maximum number of vehicle listings to scrape, from 1 to 10000. ## `scrapeDetails` (type: `boolean`): When enabled, visits each listing detail page for complete specs, paint condition, accident history, and seller contact details. Disable for faster card-only scraping. ## `proxyConfig` (type: `object`): Proxy settings. Turkish residential proxies are strongly recommended for reliability. ## Actor input object example ```json { "searchUrls": [ "https://www.arabam.com/ikinci-el/otomobil/volkswagen-passat" ], "listingUrls": [ "https://www.arabam.com/ilan/galeriden-satilik-volkswagen-passat/39355250" ], "maxListings": 200, "scrapeDetails": true, "proxyConfig": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "countryCode": "TR" } } ``` # Actor output Schema ## `vehicleListings` (type: `string`): Structured vehicle listing records from Arabam.com. In Apify Console this opens the overview dataset view by default. ## `runSummary` (type: `string`): RUN\_SUMMARY dataset row with totals, duration, warnings, and the effective input summary for the scrape. # 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": [ "https://www.arabam.com/ikinci-el/otomobil/volkswagen-passat" ], "maxListings": 200, "scrapeDetails": true, "proxyConfig": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "countryCode": "TR" } }; // Run the Actor and wait for it to finish const run = await client.actor("seralifatih/turkish-automotive-intelligence-suite").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": ["https://www.arabam.com/ikinci-el/otomobil/volkswagen-passat"], "maxListings": 200, "scrapeDetails": True, "proxyConfig": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "countryCode": "TR", }, } # Run the Actor and wait for it to finish run = client.actor("seralifatih/turkish-automotive-intelligence-suite").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": [ "https://www.arabam.com/ikinci-el/otomobil/volkswagen-passat" ], "maxListings": 200, "scrapeDetails": true, "proxyConfig": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "countryCode": "TR" } }' | apify call seralifatih/turkish-automotive-intelligence-suite --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=seralifatih/turkish-automotive-intelligence-suite", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Arabam.com Vehicle Scraper", "description": "Extract structured used-car listings from Arabam.com, including price, mileage, specs, seller details, location, condition data, and optional detail-page enrichment.", "version": "0.0", "x-build-id": "vSw3jHPNf8TbPsyHQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/seralifatih~turkish-automotive-intelligence-suite/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-seralifatih-turkish-automotive-intelligence-suite", "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/seralifatih~turkish-automotive-intelligence-suite/runs": { "post": { "operationId": "runs-sync-seralifatih-turkish-automotive-intelligence-suite", "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/seralifatih~turkish-automotive-intelligence-suite/run-sync": { "post": { "operationId": "run-sync-seralifatih-turkish-automotive-intelligence-suite", "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": "Direct arabam.com search or category result page URLs. Use this or filters, not both.", "items": { "type": "string" } }, "listingUrls": { "title": "Listing URLs", "type": "array", "description": "Direct arabam.com vehicle detail page URLs to scrape. Can be combined with other inputs.", "items": { "type": "string" } }, "filters": { "title": "Search Filters", "type": "object", "description": "Build a search URL from filters when searchUrls is not provided.", "properties": { "make": { "title": "Make", "type": "string", "description": "Vehicle make or brand in slug form, for example 'volkswagen', 'toyota', or 'bmw'.", "example": "volkswagen" }, "model": { "title": "Model", "type": "string", "description": "Vehicle model in slug form, for example 'passat' or 'corolla'.", "example": "passat" }, "yearMin": { "title": "Minimum Year", "type": "integer", "description": "Optional. Minimum model year to include in the search.", "minimum": 1970, "maximum": 2030, "example": 2018 }, "yearMax": { "title": "Maximum Year", "type": "integer", "description": "Optional. Maximum model year to include in the search.", "minimum": 1970, "maximum": 2030, "example": 2023 }, "priceMin": { "title": "Minimum Price (TRY)", "type": "integer", "description": "Optional. Minimum asking price in Turkish lira.", "example": 500000 }, "priceMax": { "title": "Maximum Price (TRY)", "type": "integer", "description": "Optional. Maximum asking price in Turkish lira.", "example": 2000000 }, "mileageMax": { "title": "Maximum Mileage (km)", "type": "integer", "description": "Optional. Maximum mileage in kilometers.", "example": 150000 }, "fuelType": { "title": "Fuel Type", "type": "string", "description": "Optional. Fuel type filter.", "enum": [ "benzin", "dizel", "lpg", "hybrid", "elektrik", "benzin_lpg" ], "example": "dizel" }, "transmission": { "title": "Transmission", "type": "string", "description": "Optional. Transmission type filter.", "enum": [ "manuel", "otomatik", "yarı_otomatik" ], "example": "otomatik" }, "city": { "title": "City", "type": "string", "description": "Optional. Filter by city, for example 'istanbul', 'ankara', or 'izmir'.", "example": "istanbul" }, "bodyType": { "title": "Body Type", "type": "string", "description": "Optional. Body style filter.", "enum": [ "sedan", "hatchback", "station_wagon", "suv", "coupe", "cabrio", "minivan", "pickup" ], "example": "sedan" } } }, "maxListings": { "title": "Maximum Listings", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of vehicle listings to scrape, from 1 to 10000.", "default": 200 }, "scrapeDetails": { "title": "Scrape Detail Pages", "type": "boolean", "description": "When enabled, visits each listing detail page for complete specs, paint condition, accident history, and seller contact details. Disable for faster card-only scraping.", "default": true }, "proxyConfig": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Turkish residential proxies are strongly recommended for reliability." } } }, "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 } } } } } } } } } } ```