Documentation | AUTO-API.COM

Automotive Scraper API documentation. Learn how to access car data via direct API endpoints. Integration guides and code examples.

Clean, structured automotive data delivered through API. No complex setup, infrastructure management, or technical maintenance needed.

Why Choose Us

Industry Experience

Automotive data API provider with over 8 years of experience since 2017.

7-Day Support

Support team available 7 days a week for API integration help.

24/7 Service

Round-the-clock monitoring for reliable data delivery.

Key API Capabilities | Scrapers & Parsers

Real-Time Listing Alerts

Get instant API access to new car listings as they're posted.

Daily Data Exports

Get daily exports of active and removed listings for market analysis and sales tracking.

Flexible Export Formats

Get data in CSV, JSON, Excel, and custom formats for easy integration.

Frequently Asked Questions | API vs Scraper & Crawler

How does the automotive API work?

Automotive API provides real-time access to data from major car marketplaces. Delivers formatted data through REST API.

What data does the automotive API provide?

Full car data including specs, pricing, seller info, location, and mileage. Access millions of listings from major platforms through API calls.

Are there usage limits?

No usage limits. Get all active listings across regions via real-time API or daily exports. No restrictions for business partners.

How can I track new car listings with the real-time API?

Monitor listings using 'from_id' parameter. Begin with from_id=0, then use last change ID + 1. Captures new listings, price changes, removals across platforms.

Which data formats do you support?

Get data in CSV, JSON, Excel, and database formats. Each format provides comprehensive data from all platforms.

Can you build custom API access for a specific marketplace?

Yes, we build custom API solutions for any car marketplace. Contact us with your requirements.

Is my data usage kept confidential?

Yes. We work under strict confidentiality agreements with all clients. Your use of our services stays private and secure.

Do I need to manage infrastructure or servers?

No, it's fully managed. We handle all infrastructure, servers and data collection. You get ready-to-use data.

Available Data Fields

API access to all data points, including:

Core Vehicle Attributes

  • Make & Model
  • Year & Generation
  • Trim & Configuration
  • Body Style
  • Exterior Color

Technical Specifications

  • Engine Type & Displacement
  • Horsepower
  • Transmission
  • Drivetrain
  • Odometer Reading

Marketplace Listing Data

  • Price & Currency
  • Listing URL & ID
  • Availability
  • Date Published
  • Full Description

Seller & Location Details

  • Region & City
  • Seller Type (Dealer/Private)
  • Contact Information
  • Vehicle History
  • Photos & Options

* Data field availability varies by source marketplace and listing completeness.

Daily Data Exports

Data Retention

Export files maintained with secure 3-day minimum storage plus automated archival system.

Export Availability

Daily data exports with updated content available for download each day

CSV Format Details

CSV files employ pipe delimiter (|) as standard column separator across all datasets.

URL Structure:

https://{personal_name}.auto-api.com/{date}/{file_name}

Request Parameters:

  • personal_name - your unique assigned subdomain identifier.
  • date - target date for the data in yyyy-mm-dd format (e.g., 2025-09-06).
  • file_name - name of the export file, including its extension.

Available Formats:

  • CSV - CSV - all_active.csv, new_daily.csv, removed_daily.csv
  • JSON - JSON - all_active.json, new_daily.json, removed_daily.json
  • Excel - Excel - all_active.xlsx, new_daily.xlsx, removed_daily.xlsx

cURL API Request Example

curl -L -X GET 'https://{personal_name}.auto-api.com/yyyy-mm-dd/all_active.csv' \
  -H 'Authorization: Basic XXX' \
  -o daily_car_data.csv

Wget Download Command

wget --method GET \
  --header 'Authorization: Basic XXX==' \
  'https://{personal_name}.auto-api.com/yyyy-mm-dd/all_active.csv'
Real-Time API Documentation

API Request Parameters

api_key - Your unique API key for authentication.

from_id - The Change ID to fetch data from. Use 0 for the initial request, then the last received ID + 1.

API Response Fields

inner_id - The permanent, unique ID of the listing on the source marketplace.

change_type - The type of event: "added", "changed" (e.g., price update), or "removed".

created_at - The timestamp indicating when the event occurred.

Response Body Example

{
  "result": [
    {
      "id": 2664810,
      "inner_id": "40428521",
      "change_type": "added",
      "created_at": "2025-09-02T05:44:49.000",
      "data": {
        "id": "1455502",
        "inner_id": "40428521",
        "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=40428521",
        "mark": "Hyundai",
        "model": "Genesis",
        "generation": "200 Turbo S",
        "configuration": "200 Turbo S",
        "complectation": null,
        "year": "2012",
        "color": "Red",
        "price": "8900000",
        "km_age": "246400",
        "engine_type": "Gasoline",
        "transmission_type": "Manual",
        "body_type": "Sports Car",
        "address": "Busan Dongnae-gu",
        "seller_type": "REPEAT",
        "is_dealer": "false",
        "section": "used",
        "seller": "cainabel",
        "salon_id": "05062013358",
        "description": "I'm not a dealer; I'm an individual who loves cars...",
        "displacement": "1998.0",
        "offer_created": "2025-09-02T05:44:49.000",
        "manufacturerName": "Hyundai",
        "modelName": "The New Genesis Coupe",
        "gradeName": "200 Turbo S",
        "modelGroupName": "Genesis",
        "yearMonth": "201203",
        "images": [
          {
            "code": "001",
            "path": "/carpicture02/pic4042/40428521_001.JPG",
            "type": "OUTER"
          }
        ],
        "advertisementType": "NORMAL",
        "created_at": "2025-09-02T00:47:21.243",
        "extra": "{diagnosis:{...},inspection:{...},accidents:[...]}",
        "options": {
          "standard": [
            "001",
            "003",
            "006",
            "007",
            "008"
          ],
          "choice": [
            "1052"
          ],
          "tuning": [
            "015",
            "016",
            "017",
            "018",
            "021"
          ]
        }
      }
    },
    {
      "id": 2664811,
      "inner_id": "39969819",
      "change_type": "changed",
      "created_at": "2025-08-17T05:19:34.442",
      "data": {
        "new_price": 34900000
      }
    },
    {
      "id": 2664812,
      "inner_id": "39971229",
      "change_type": "removed",
      "created_at": "2025-08-17T05:19:39.778"
    }
  ],
  "meta": {
    "cur_from_id": "2664810",
    "limit": 10
  }
}