# Encar Automotive Details Scraper (`alexist/encar-automotive-details-scraper`) Actor Scrape detailed automotive listings from Encar.com with vehicle specs, pricing, condition data, photos, and contact information. Perfect for dealers, researchers, and price comparison platforms. Extract 200+ vehicles per session with reliable proxy support. - **URL**: https://apify.com/alexist/encar-automotive-details-scraper.md - **Developed by:** [Alex](https://apify.com/alexist) (community) - **Categories:** Automation, Developer tools, Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 ## Encar.com Automotive Scraper: Extract Vehicle Details & Specs Instantly *** ### What Is Encar.com? Encar.com is South Korea's largest automotive marketplace, featuring thousands of used and new vehicle listings with comprehensive details, photos, and seller contact information. It's the primary platform for car buyers and dealers to discover vehicles. Manually extracting listing details is inefficient — the **Encar Automotive Scraper** automates this process, delivering structured vehicle data at scale for market analysis, price tracking, and dealership operations. *** ### Overview The **Encar Automotive Scraper** extracts comprehensive vehicle detail pages from Encar.com, converting individual car listings into structured records. It is designed for: - **Auto dealers** monitoring competitor inventory and pricing - **Price aggregators** building comprehensive vehicle databases - **Market researchers** analyzing automotive trends in Korea - **Buyers** tracking specific models or price ranges across listings Key strengths include high-volume extraction (up to 200 items per URL), graceful URL failure handling, and rich output spanning vehicle specifications, condition, photos, and seller contact details. *** ### Input Format The scraper accepts a configuration object with the following parameters: ```json { "urls": [ "https://fem.encar.com/cars/detail/42177552?advClickPosition=mweb_mhightlight_g5_t10660&listAdvType=mhighlight&type=detail&view_type=checked", "https://fem.encar.com/cars/detail/41279203?advClickPosition=mweb_mopre_g4_t10655&listAdvType=mpremium&type=detail&view_type=checked" ], "max_items_per_url": 200, "ignore_url_failures": true } ``` | Parameter | Description | Example | |---|---|---| | `urls` | Array of Encar vehicle detail page URLs | `fem.encar.com/cars/detail/{ID}` | | `max_items_per_url` | Maximum records per URL (typically 1, up to 200) | `200` | | `ignore_url_failures` | If `true`, continues scraping if some URLs fail; if `false`, stops on first error | `true` or `false` | **Requirements:** - URLs must link to individual vehicle detail pages, not search results - Query parameters (e.g., `advClickPosition`, `listAdvType`) may be included or omitted - Each URL typically returns one vehicle record *** ### Output Format **Sample output** ```json { "manage": { "dummy": false, "dummy_vehicle_id": null, "re_registered": false, "web_reserved": true, "regist_date_time": "2026-06-12T14:21:49", "first_advertised_date_time": "2026-06-15T14:33:04", "modify_date_time": "2026-07-24T11:33:07", "subscribe_count": 6, "view_count": 835 }, "category": { "type": "CAR", "manufacturer_cd": "013", "manufacturer_name": "벤츠", "model_cd": "001", "model_name": "E-클래스 W212", "grade_cd": "014", "grade_name": "E220 CDI 아방가르드", "grade_english_name": "E220 CDI Avantgarde", "year_month": "201206", "form_year": "2012", "domestic": false, "import_type": "REGULAR_IMPORT", "origin_price": 6520, "manufacturer_english_name": "Mercedes-Benz", "model_group_cd": "004", "model_group_name": "E-클래스", "model_group_english_name": "E-Class", "grade_detail_cd": null, "grade_detail_name": null, "grade_detail_english_name": null, "jato_vehicle_id": 735051020120315, "warranty": { "user_defined": false, "company_name": null, "body_month": 24, "body_mileage": 999999, "transmission_month": 36, "transmission_mileage": 60000 } }, "advertisement": { "type": "CAR", "price": 479, "status": "ADVERTISE", "warranty_style_color": "WHITE", "trust": [ "Warranty" ], "hot_mark": [ 12, 17, 24 ], "one_line_text": "완전무사고/엔카진단/정비완료/전국최저가", "sales_status": null, "direct_inspected": false, "pre_verified": false, "extend_warranty": false, "deemed_extend_warranty": false, "home_service": false, "meet_go": false, "encar_check": false, "pre_delivery": false, "lease_rent_info": null, "encar_pass_type": null, "encar_pass_category_type": null, "under_body_photos": [], "has_under_body_photo": false, "advertisement_type": "NORMAL", "diagnosis_car": true }, "contact": { "user_id": "feelbike", "user_type": "DEALER", "no": "05062212760", "address": "서울 강서구 강서로74길 58", "contact_type": "MOBILE", "is_verify_owner": false, "is_owner_partner": true }, "spec": { "type": "CAR", "mileage": 248110, "displacement": 2143, "transmission_name": "오토", "fuel_cd": "002", "fuel_name": "디젤", "color_name": "흰색", "custom_color": null, "seat_count": 5, "trade_type": "D", "trade_owner_type": null, "trade_company_name": null, "body_name": "중형차" }, "photos": [ { "code": "021", "path": "/carpicture07/pic4217/42177552_021.jpg", "type": "OPTION", "update_date_time": "2026-06-15T14:32:48", "desc": null }, { "code": "022", "path": "/carpicture07/pic4217/42177552_022.jpg", "type": "OPTION", "update_date_time": "2026-06-15T14:32:48", "desc": null }, { "code": "010", "path": "/carpicture07/pic4217/42177552_010.jpg", "type": "INNER", "update_date_time": "2026-06-15T14:32:48", "desc": null }, { "code": "006", "path": "/carpicture07/pic4217/42177552_006.jpg", "type": "OUTER", "update_date_time": "2026-06-15T14:32:48", "desc": null }, { "code": "004", "path": "/carpicture07/pic4217/42177552_004.jpg", "type": "OUTER", "update_date_time": "2026-06-15T14:32:48", "desc": null }, { "code": "005", "path": "/carpicture07/pic4217/42177552_005.jpg", "type": "OUTER", "update_date_time": "2026-06-15T14:32:48", "desc": null }, { "code": "020", "path": "/carpicture07/pic4217/42177552_020.jpg", "type": "OPTION", "update_date_time": "2026-06-15T14:32:48", "desc": null }, { "code": "008", "path": "/carpicture07/pic4217/42177552_008.jpg", "type": "INNER", "update_date_time": "2026-06-15T14:32:48", "desc": null }, { "code": "015", "path": "/carpicture07/pic4217/42177552_015.jpg", "type": "OPTION", "update_date_time": "2026-06-15T14:32:48", "desc": null }, { "code": "019", "path": "/carpicture07/pic4217/42177552_019.jpg", "type": "OPTION", "update_date_time": "2026-06-15T14:32:48", "desc": null }, { "code": "009", "path": "/carpicture07/pic4217/42177552_009.jpg", "type": "INNER", "update_date_time": "2026-06-15T14:32:48", "desc": null }, { "code": "001", "path": "/carpicture07/pic4217/42177552_001.jpg", "type": "OUTER", "update_date_time": "2026-06-15T14:32:48", "desc": null }, { "code": "024", "path": "/carpicture07/pic4217/42177552_024.jpg", "type": "OPTION", "update_date_time": "2026-06-15T14:32:48", "desc": null }, { "code": "002", "path": "/carpicture07/pic4217/42177552_002.jpg", "type": "OUTER", "update_date_time": "2026-06-15T14:32:48", "desc": null }, { "code": "018", "path": "/carpicture07/pic4217/42177552_018.jpg", "type": "OPTION", "update_date_time": "2026-06-15T14:32:48", "desc": null }, { "code": "017", "path": "/carpicture07/pic4217/42177552_017.jpg", "type": "OPTION", "update_date_time": "2026-06-15T14:32:48", "desc": null }, { "code": "007", "path": "/carpicture07/pic4217/42177552_007.jpg", "type": "INNER", "update_date_time": "2026-06-15T14:32:48", "desc": null }, { "code": "003", "path": "/carpicture07/pic4217/42177552_003.jpg", "type": "OUTER", "update_date_time": "2026-06-15T14:32:48", "desc": null }, { "code": "016", "path": "/carpicture07/pic4217/42177552_016.jpg", "type": "OPTION", "update_date_time": "2026-06-15T14:32:48", "desc": null }, { "code": "023", "path": "/carpicture07/pic4217/42177552_023.jpg", "type": "OPTION", "update_date_time": "2026-06-15T14:32:48", "desc": null } ], "options": { "type": "CAR", "standard": [ "001", "003", "004", "005", "006", "007", "008", "010", "014", "015", "017", "019", "020", "021", "022", "023", "024", "026", "027", "029", "030", "031", "032", "035", "051", "055", "056", "058", "068", "072", "074", "078", "081", "083", "084", "085", "096", "097" ], "etc": [], "choice": [], "tuning": [] }, "condition": { "accident": { "record_view": true, "resume_view": true }, "inspection": { "formats": [ "TABLE" ] }, "seizing": { "seizing_count": 0, "pledge_count": 0 } }, "partnership": { "brand": null, "testdrive": { "active": false }, "dealer": { "user_id": "feelbike", "name": "윤억준", "firm": { "code": "6715", "name": "(주)플랜오토", "diag2_partnered": false, "diagnosis_centers": [ { "code": "151", "name": "엔카진단센터 강서가양점", "major": true, "telephone_number": "02-2659-5457", "address": "서울 강서구 강서로74길 58 가양오토갤러리 1층 진단센터/(컨설팅룸 203호)" } ], "meetgo_centers": [] }, "visit_reservation": false }, "is_partnered_vehicle": true, "certified_brand": null, "lease": null, "rent": null }, "contents": null, "view": { "encar_diagnosis": 0, "encar_meet_go": -1, "has_ev_battery_info": false, "is_battery_pass": false, "photo_plus": 0, "meetgo_expert_available": false, "is_single_ad": false }, "vehicle_id": 42177552, "vehicle_type": "CAR", "vin": "WDDHF0CB9CA630196", "vehicle_no": "122소8990", "query_car_id": 42177552, "request_url": "/v1/readside/vehicle/42177552?include=ADVERTISEMENT,CATEGORY,CONDITION,CONTACT,MANAGE,OPTIONS,PHOTOS,SPEC,PARTNERSHIP,CENTER,VIEW" } ``` Each scraped vehicle returns a structured record with 17 data fields: #### Vehicle Identification | Field | Meaning | Example | |---|---|---| | `Vehicle ID` | Unique Encar identifier for the vehicle | `42177552` | | `VIN` | Vehicle Identification Number (chassis number) | `KMHEC4A46CU123456` | | `Vehicle No` | License plate or registration number | Used by dealers/authorities | | `Vehicle Type` | Category classification (sedan, SUV, truck, etc.) | `sedan` | | `Query Car ID` | Alternative vehicle reference ID in Encar system | Numeric identifier | #### Listing & Visibility | Field | Meaning | Example | |---|---|---| | `Advertisement` | Ad type or promotion status | `mpremium`, `mhighlight` | | `View` | Number of times the listing was viewed | `1,234` | | `Request URL` | Original input URL for the vehicle | Full URL with parameters | #### Vehicle Specifications | Field | Meaning | Example | |---|---|---| | `Spec` | Detailed specifications (engine, transmission, fuel type, mileage, color, year, displacement) | Combined JSON or structured data | | `Condition` | Vehicle condition assessment (excellent, good, fair, poor) | Used/certified status | | `Options` | Available features and add-ons (sunroof, leather seats, nav system) | List of installed options | #### Seller & Listing Management | Field | Meaning | Example | |---|---|---| | `Manage` | Listing management status or seller tier | Active, inactive, sold | | `Category` | Listing category or pricing tier | Used car, CPO, showroom | | `Contact` | Seller contact information (phone, email, dealer name) | Dealership or private seller details | | `Partnership` | Partnership or franchise affiliation | Official dealer badge | | `Contents` | Additional content (reviews, warranty info, financing options) | User-generated or dealer-provided | | `Photos` | URLs or count of vehicle photos | Array of image URLs | *** ### How to Use 1. **Collect URLs** — Visit Encar.com, search for vehicles, and open individual car detail pages. Copy the full URL (including query parameters). 2. **Prepare input** — Paste URLs into the `urls` array. Set `max_items_per_url` to `200` for high-volume scraping or `1` for single-vehicle extraction. 3. **Configure failure handling** — Set `ignore_url_failures` to `true` if scraping batches to prevent interruptions. 4. **Start the scraper** — Run the actor and monitor progress in the run log. 5. **Export data** — Download results as JSON, CSV, or Excel for analysis in spreadsheets or databases. **Tips & Best Practices:** - Use query parameters as provided in browser URLs; they contain seller filter and ad type information - For bulk scraping, group similar URLs (e.g., same seller or category) for faster processing - Check the `View` count to identify popular listings - Combine `Spec` and `Condition` fields to assess vehicle quality and pricing patterns *** ### Use Cases & Business Value - **Dealership operations:** Track competitor inventory, pricing strategies, and listing duration - **Market analysis:** Identify trends in vehicle demand, pricing by region, and popular models - **Price comparison platforms:** Aggregate listings from multiple Encar sellers into unified databases - **Personal buying:** Monitor specific vehicle models and price ranges over time The Encar Automotive Scraper eliminates hours of manual data collection, delivering structured records that integrate directly into CRM systems, spreadsheets, and analytics platforms. *** ### Conclusion The **Encar.com Automotive Scraper** streamlines vehicle data extraction for dealers, researchers, and market analysts. With 17 comprehensive fields and support for high-volume scraping, it transforms individual car listings into actionable datasets. Whether tracking market trends or building inventory tools, this scraper provides reliable, structured automotive data at scale. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the Specific cars urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## Actor input object example ```json { "urls": [ "https://fem.encar.com/cars/detail/42177552?advClickPosition=mweb_mhightlight_g5_t10660&listAdvType=mhighlight&type=detail&view_type=checked", "https://fem.encar.com/cars/detail/41279203?advClickPosition=mweb_mopre_g4_t10655&listAdvType=mpremium&type=detail&view_type=checked", "https://fem.encar.com/cars/detail/41814989?advClickPosition=mweb_mopre_g7_t10655&listAdvType=mpremium&type=detail&view_type=checked", "https://fem.encar.com/cars/detail/41864084?advClickPosition=mweb_mopre_g5_t10655&listAdvType=mpremium&type=detail&view_type=checked", "https://fem.encar.com/cars/detail/41211812?advClickPosition=mweb_mopre_g6_t10655&listAdvType=mpremium&type=detail&view_type=checked" ], "ignore_url_failures": true } ``` # 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://fem.encar.com/cars/detail/42177552?advClickPosition=mweb_mhightlight_g5_t10660&listAdvType=mhighlight&type=detail&view_type=checked", "https://fem.encar.com/cars/detail/41279203?advClickPosition=mweb_mopre_g4_t10655&listAdvType=mpremium&type=detail&view_type=checked", "https://fem.encar.com/cars/detail/41814989?advClickPosition=mweb_mopre_g7_t10655&listAdvType=mpremium&type=detail&view_type=checked", "https://fem.encar.com/cars/detail/41864084?advClickPosition=mweb_mopre_g5_t10655&listAdvType=mpremium&type=detail&view_type=checked", "https://fem.encar.com/cars/detail/41211812?advClickPosition=mweb_mopre_g6_t10655&listAdvType=mpremium&type=detail&view_type=checked" ], "ignore_url_failures": true }; // Run the Actor and wait for it to finish const run = await client.actor("alexist/encar-automotive-details-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 = { "urls": [ "https://fem.encar.com/cars/detail/42177552?advClickPosition=mweb_mhightlight_g5_t10660&listAdvType=mhighlight&type=detail&view_type=checked", "https://fem.encar.com/cars/detail/41279203?advClickPosition=mweb_mopre_g4_t10655&listAdvType=mpremium&type=detail&view_type=checked", "https://fem.encar.com/cars/detail/41814989?advClickPosition=mweb_mopre_g7_t10655&listAdvType=mpremium&type=detail&view_type=checked", "https://fem.encar.com/cars/detail/41864084?advClickPosition=mweb_mopre_g5_t10655&listAdvType=mpremium&type=detail&view_type=checked", "https://fem.encar.com/cars/detail/41211812?advClickPosition=mweb_mopre_g6_t10655&listAdvType=mpremium&type=detail&view_type=checked", ], "ignore_url_failures": True, } # Run the Actor and wait for it to finish run = client.actor("alexist/encar-automotive-details-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).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://fem.encar.com/cars/detail/42177552?advClickPosition=mweb_mhightlight_g5_t10660&listAdvType=mhighlight&type=detail&view_type=checked", "https://fem.encar.com/cars/detail/41279203?advClickPosition=mweb_mopre_g4_t10655&listAdvType=mpremium&type=detail&view_type=checked", "https://fem.encar.com/cars/detail/41814989?advClickPosition=mweb_mopre_g7_t10655&listAdvType=mpremium&type=detail&view_type=checked", "https://fem.encar.com/cars/detail/41864084?advClickPosition=mweb_mopre_g5_t10655&listAdvType=mpremium&type=detail&view_type=checked", "https://fem.encar.com/cars/detail/41211812?advClickPosition=mweb_mopre_g6_t10655&listAdvType=mpremium&type=detail&view_type=checked" ], "ignore_url_failures": true }' | apify call alexist/encar-automotive-details-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,alexist/encar-automotive-details-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/5C3W1d2UeSFbTxmHh/builds/fUKxc1XanpeznZDa9/openapi.json