Auto.ru API Reference

Complete API documentation for extracting automotive data from Auto.ru, Russia's leading automotive marketplace.

🔗 Base URL

https://api.carapis.com/v1/auto-ru

🔐 Authentication

All API requests require authentication using an API key:

Authorization: Bearer YOUR_API_KEY

API Key

Get your API key from the CarAPIS Dashboard

📋 Endpoints Overview

Endpoint	Method	Description
`/search`	GET	Search vehicle listings
`/listing/\{id\}`	GET	Get detailed listing information
`/dealer/\{id\}`	GET	Get dealer information
`/market-data`	GET	Get market analysis data
`/price-history/\{id\}`	GET	Get price history for a listing
`/brands`	GET	Get available brands
`/models/\{brand\}`	GET	Get models for a specific brand

🔍 Search Endpoint

GET /search

Search for vehicle listings with various filters and parameters.

Query Parameters

Parameter	Type	Required	Description
`brand`	string	No	Vehicle brand (e.g., "Lada")
`model`	string	No	Vehicle model (e.g., "Vesta")
`year_from`	integer	No	Minimum year
`year_to`	integer	No	Maximum year
`price_min`	integer	No	Minimum price in RUB
`price_max`	integer	No	Maximum price in RUB
`mileage_max`	integer	No	Maximum mileage in km
`fuel_type`	string	No	Fuel type (gasoline, diesel, electric, hybrid)
`transmission`	string	No	Transmission type (manual, automatic, robot, variator)
`region`	string	No	Russian region
`city`	string	No	City name
`page`	integer	No	Page number (default: 1)
`limit`	integer	No	Results per page (default: 20, max: 100)

Example Request

curl -X GET "https://api.carapis.com/v1/auto-ru/search?brand=Lada&model=Vesta&year_from=2020&price_max=1500000&region=Московская область" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "success": true,
  "data": {
    "listings": [
      {
        "id": "auto_ru_123456789",
        "title": "Lada Vesta SW Cross 1.6 16V 2022",
        "brand": "Lada",
        "model": "Vesta",
        "year": 2022,
        "price": 1200000,
        "original_price": 1350000,
        "mileage": 45000,
        "fuel_type": "gasoline",
        "transmission": "manual",
        "color": "Серебристый",
        "location": {
          "region": "Московская область",
          "city": "Москва",
          "district": "Центральный"
        },
        "dealer": {
          "id": "dealer_123",
          "name": "Автоцентр Москва",
          "rating": 4.8,
          "verified": true
        },
        "features": ["Кондиционер", "Электростеклоподъемники", "Bluetooth", "Камера заднего вида"],
        "images": ["https://example.com/image1.jpg", "https://example.com/image2.jpg"],
        "url": "https://auto.ru/moskva/cars/lada/vesta/2022/123456789",
        "created_at": "2024-01-15T10:30:00Z",
        "updated_at": "2024-01-20T14:45:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 150,
      "total_pages": 8
    },
    "filters": {
      "applied": {
        "brand": "Lada",
        "model": "Vesta",
        "year_from": 2020,
        "price_max": 1500000,
        "region": "Московская область"
      },
      "available": {
        "brands": ["Lada", "Toyota", "Volkswagen"],
        "price_ranges": ["0-500000", "500000-1000000", "1000000-1500000"],
        "years": [2020, 2021, 2022, 2023, 2024]
      }
    }
  }
}

📄 Listing Details Endpoint

GET /listing/{id}

Get detailed information about a specific vehicle listing.

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	Listing ID

Example Request

curl -X GET "https://api.carapis.com/v1/auto-ru/listing/auto_ru_123456789" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "success": true,
  "data": {
    "id": "auto_ru_123456789",
    "title": "Lada Vesta SW Cross 1.6 16V 2022",
    "description": "Отличный Lada Vesta SW Cross 2022 года, один владелец, полная история обслуживания...",
    "brand": "Lada",
    "model": "Vesta",
    "version": "SW Cross 1.6 16V",
    "year": 2022,
    "model_year": 2023,
    "price": 1200000,
    "original_price": 1350000,
    "financing": {
      "available": true,
      "monthly_payment": 25000,
      "down_payment": 200000,
      "terms": [12, 24, 36, 48, 60]
    },
    "specifications": {
      "engine": "1.6L 4-цилиндровый",
      "power": "106 л.с.",
      "torque": "148 Нм",
      "fuel_type": "gasoline",
      "transmission": "manual",
      "drivetrain": "передний привод",
      "mileage": 45000,
      "color": "Серебристый",
      "interior_color": "Черный",
      "doors": 5,
      "seats": 5
    },
    "features": {
      "safety": ["ABS", "Подушка безопасности водителя", "Подушка безопасности пассажира", "Система курсовой устойчивости", "Контроль тяги"],
      "comfort": ["Кондиционер", "Электростеклоподъемники", "Центральный замок", "Круиз-контроль", "Bluetooth"],
      "technology": ["Мультимедийная система", "Камера заднего вида", "USB-порт", "Apple CarPlay", "Android Auto"]
    },
    "condition": {
      "overall": "отличное",
      "exterior": "отличное",
      "interior": "отличное",
      "mechanical": "отличное",
      "accident_history": false,
      "single_owner": true
    },
    "location": {
      "region": "Московская область",
      "city": "Москва",
      "district": "Центральный",
      "address": "ул. Тверская, 123",
      "coordinates": {
        "latitude": 55.7558,
        "longitude": 37.6176
      }
    },
    "dealer": {
      "id": "dealer_123",
      "name": "Автоцентр Москва",
      "type": "authorized_dealer",
      "rating": 4.8,
      "reviews_count": 1250,
      "verified": true,
      "contact": {
        "phone": "+7 495 123-45-67",
        "whatsapp": "+7 495 123-45-67",
        "email": "info@avtocentr-moscow.ru"
      }
    },
    "images": [
      {
        "url": "https://example.com/image1.jpg",
        "alt": "Вид спереди",
        "primary": true
      },
      {
        "url": "https://example.com/image2.jpg",
        "alt": "Вид сбоку",
        "primary": false
      }
    ],
    "documents": {
      "registration": "действительна",
      "insurance": "включена",
      "maintenance_book": "полная",
      "manual": "включена"
    },
    "url": "https://auto.ru/moskva/cars/lada/vesta/2022/123456789",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-20T14:45:00Z"
  }
}

🏢 Dealer Information Endpoint

GET /dealer/{id}

Get detailed information about a specific dealer.

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	Dealer ID

Example Request

curl -X GET "https://api.carapis.com/v1/auto-ru/dealer/dealer_123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "success": true,
  "data": {
    "id": "dealer_123",
    "name": "Автоцентр Москва",
    "type": "authorized_dealer",
    "brands": ["Lada", "Toyota", "Volkswagen"],
    "rating": 4.8,
    "reviews_count": 1250,
    "verified": true,
    "since": "2010-01-01",
    "location": {
      "region": "Московская область",
      "city": "Москва",
      "district": "Центральный",
      "address": "ул. Тверская, 123",
      "coordinates": {
        "latitude": 55.7558,
        "longitude": 37.6176
      }
    },
    "contact": {
      "phone": "+7 495 123-45-67",
      "whatsapp": "+7 495 123-45-67",
      "email": "info@avtocentr-moscow.ru",
      "website": "https://www.avtocentr-moscow.ru"
    },
    "business_hours": {
      "monday": "09:00-18:00",
      "tuesday": "09:00-18:00",
      "wednesday": "09:00-18:00",
      "thursday": "09:00-18:00",
      "friday": "09:00-18:00",
      "saturday": "09:00-17:00",
      "sunday": "закрыто"
    },
    "services": ["продажа", "финансирование", "страхование", "обслуживание", "гарантия"],
    "active_listings": 45,
    "total_sales": 1250
  }
}

📊 Market Data Endpoint

GET /market-data

Get comprehensive market analysis data.

Query Parameters

Parameter	Type	Required	Description
`brand`	string	No	Filter by brand
`model`	string	No	Filter by model
`region`	string	No	Filter by region
`period`	string	No	Time period (7d, 30d, 90d, 1y)

Example Request

curl -X GET "https://api.carapis.com/v1/auto-ru/market-data?brand=Lada&period=30d" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "success": true,
  "data": {
    "period": "30d",
    "brand": "Lada",
    "market_overview": {
      "total_listings": 12500,
      "average_price": 850000,
      "price_trend": "+2.5%",
      "demand_level": "высокий"
    },
    "price_analysis": {
      "price_ranges": {
        "0-500000": 15,
        "500000-1000000": 45,
        "1000000-1500000": 30,
        "1500000+": 10
      },
      "average_by_model": {
        "Vesta": 950000,
        "Granta": 650000,
        "Niva": 1200000,
        "XRAY": 1100000
      }
    },
    "geographic_distribution": {
      "Московская область": 35,
      "Санкт-Петербург": 20,
      "Новосибирск": 15,
      "Екатеринбург": 12,
      "Другие": 18
    },
    "trends": {
      "price_trend": "+2.5%",
      "demand_trend": "+8.2%",
      "supply_trend": "+3.1%"
    }
  }
}

📈 Price History Endpoint

GET /price-history/{id}

Get price history for a specific listing.

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	Listing ID

Query Parameters

Parameter	Type	Required	Description
`period`	string	No	Time period (7d, 30d, 90d, 1y)

Example Request

curl -X GET "https://api.carapis.com/v1/auto-ru/price-history/auto_ru_123456789?period=30d" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "success": true,
  "data": {
    "listing_id": "auto_ru_123456789",
    "period": "30d",
    "price_history": [
      {
        "date": "2024-01-01",
        "price": 1300000,
        "change": 0
      },
      {
        "date": "2024-01-05",
        "price": 1280000,
        "change": -20000
      },
      {
        "date": "2024-01-10",
        "price": 1250000,
        "change": -30000
      },
      {
        "date": "2024-01-15",
        "price": 1250000,
        "change": 0
      }
    ],
    "statistics": {
      "initial_price": 1300000,
      "current_price": 1250000,
      "total_change": -50000,
      "percentage_change": -3.85,
      "lowest_price": 1250000,
      "highest_price": 1300000
    }
  }
}

🚗 Brands and Models Endpoints

GET /brands

Get all available vehicle brands.

Example Request

curl -X GET "https://api.carapis.com/v1/auto-ru/brands" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "success": true,
  "data": [
    {
      "id": "lada",
      "name": "Lada",
      "listings_count": 12500,
      "average_price": 850000
    },
    {
      "id": "toyota",
      "name": "Toyota",
      "listings_count": 9800,
      "average_price": 1200000
    },
    {
      "id": "volkswagen",
      "name": "Volkswagen",
      "listings_count": 15200,
      "average_price": 1100000
    }
  ]
}

GET /models/{brand}

Get all models for a specific brand.

Path Parameters

Parameter	Type	Required	Description
`brand`	string	Yes	Brand ID

Example Request

curl -X GET "https://api.carapis.com/v1/auto-ru/models/lada" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "success": true,
  "data": [
    {
      "id": "vesta",
      "name": "Vesta",
      "listings_count": 3200,
      "average_price": 950000,
      "years": [2020, 2021, 2022, 2023, 2024]
    },
    {
      "id": "granta",
      "name": "Granta",
      "listings_count": 2800,
      "average_price": 650000,
      "years": [2020, 2021, 2022, 2023, 2024]
    },
    {
      "id": "niva",
      "name": "Niva",
      "listings_count": 1200,
      "average_price": 1200000,
      "years": [2020, 2021, 2022, 2023, 2024]
    }
  ]
}

⚠️ Error Responses

Error Format

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human readable error message",
    "details": "Additional error details"
  }
}

Common Error Codes

Code	HTTP Status	Description
`INVALID_API_KEY`	401	Invalid or missing API key
`RATE_LIMIT_EXCEEDED`	429	Rate limit exceeded
`INVALID_PARAMETERS`	400	Invalid request parameters
`LISTING_NOT_FOUND`	404	Listing not found
`DEALER_NOT_FOUND`	404	Dealer not found
`INTERNAL_ERROR`	500	Internal server error

Example Error Response

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Please try again in 60 seconds.",
    "details": "You have exceeded 1000 requests per hour"
  }
}

📊 Rate Limits

Plan	Requests per Hour	Requests per Day
Free	100	1,000
Basic	1,000	10,000
Pro	10,000	100,000
Enterprise	Unlimited	Unlimited

Rate Limiting

Rate limits are applied per API key. Exceeding limits will result in a 429 error response.

🔧 SDK Examples

Python SDK

import carapis

# Initialize client
client = carapis.Client(api_key="YOUR_API_KEY")

# Search for vehicles
listings = client.auto_ru.search(
    brand="Lada",
    model="Vesta",
    year_from=2020,
    price_max=1500000
)

# Get listing details
listing = client.auto_ru.get_listing("auto_ru_123456789")

# Get market data
market_data = client.auto_ru.get_market_data(
    brand="Lada",
    period="30d"
)

JavaScript SDK

const CarAPIS = require('carapis');

// Initialize client
const client = new CarAPIS('YOUR_API_KEY');

// Search for vehicles
const listings = await client.auto_ru.search({
  brand: 'Lada',
  model: 'Vesta',
  yearFrom: 2020,
  priceMax: 1500000,
});

// Get listing details
const listing = await client.auto_ru.getListing('auto_ru_123456789');

// Get market data
const marketData = await client.auto_ru.getMarketData({
  brand: 'Lada',
  period: '30d',
});

📞 Support

For API support and questions:

Documentation: docs.carapis.com
Email: api-support@carapis.com
Discord: CarAPIS Community

This API provides comprehensive access to Auto.ru automotive data, enabling developers to build powerful automotive applications and services for the Russian market.

🔗 Base URL​

🔐 Authentication​

📋 Endpoints Overview​

🔍 Search Endpoint​

GET /search​

Query Parameters​

Example Request​

Example Response​

📄 Listing Details Endpoint​

GET /listing/{id}​

Path Parameters​

Example Request​

Example Response​

🏢 Dealer Information Endpoint​

GET /dealer/{id}​

Path Parameters​

Example Request​

Example Response​

📊 Market Data Endpoint​

GET /market-data​

Query Parameters​

Example Request​

Example Response​

📈 Price History Endpoint​

GET /price-history/{id}​

Path Parameters​

Query Parameters​

Example Request​

Example Response​

🚗 Brands and Models Endpoints​

GET /brands​

Example Request​

Example Response​

GET /models/{brand}​

Path Parameters​

Example Request​

Example Response​

⚠️ Error Responses​

Error Format​

Common Error Codes​

Example Error Response​

📊 Rate Limits​

🔧 SDK Examples​

Python SDK​

JavaScript SDK​

📞 Support​

🔗 Base URL

🔐 Authentication

📋 Endpoints Overview

🔍 Search Endpoint

GET /search

Query Parameters

Example Request

Example Response

📄 Listing Details Endpoint

GET /listing/{id}

Path Parameters

Example Request

Example Response

🏢 Dealer Information Endpoint

GET /dealer/{id}

Path Parameters

Example Request

Example Response

📊 Market Data Endpoint

GET /market-data

Query Parameters

Example Request

Example Response

📈 Price History Endpoint

GET /price-history/{id}

Path Parameters

Query Parameters

Example Request

Example Response

🚗 Brands and Models Endpoints

GET /brands

Example Request

Example Response

GET /models/{brand}

Path Parameters

Example Request

Example Response

⚠️ Error Responses

Error Format

Common Error Codes

Example Error Response

📊 Rate Limits

🔧 SDK Examples

Python SDK

JavaScript SDK

📞 Support