🚗 CARAPIS Vehicles API Python Client
Universal Python client for the CARAPIS Vehicles API - Access automotive data from 25+ global marketplaces with enterprise-grade reliability.
🌐 Developed by CARAPIS - The leading automotive data extraction platform serving Fortune 500 companies and automotive professionals worldwide.
🌟 Why Choose CARAPIS Vehicles API?
- 🌍 Global Coverage: Access 25+ automotive marketplaces across Asia, Europe, Americas, and Middle East
- ⚡ Real-time Data: Live vehicle listings, pricing, and market intelligence
- 🛡️ Enterprise-Grade: 99.9% uptime, advanced anti-detection, residential proxies
- 🐍 Python-First: Full async/await support, type hints, dataclasses
- 📊 Market Intelligence: Advanced analytics, price trends, and market insights
- 🚀 Production Ready: Used by automotive dealers, marketplaces, and data companies globally
🌐 Supported Automotive Platforms
🇰🇷 Asia-Pacific
- Encar.com - South Korea's largest automotive marketplace (2M+ listings)
- Che168.com - China's premier automotive platform
- Guazi.com - Leading Chinese used car marketplace
- Goo-net.com - Japan's automotive marketplace
- BeForward.jp - Japanese automotive exporter
- Carsome.com - Southeast Asian automotive platform
- One2Car.com - Thailand's automotive marketplace
- CarDekho.com - India's automotive platform
- Spinny.com - Indian automotive marketplace
🇺🇸 North America
- Cars.com - Leading US automotive platform (2M+ listings)
- CarGurus.com - US automotive marketplace and analytics
- Carvana.com - US online car retailer
- Vroom.com - US online automotive marketplace
- AutoTrader.com - Premier automotive marketplace
🇪🇺 Europe
- AutoScout24.com - Europe's largest automotive marketplace
- Mobile.de - Germany's leading automotive platform
- Auto.ru - Russia's premier automotive marketplace (2M+ listings)
- Avito.ru - Russian classifieds platform
- Arabam.com - Turkey's automotive marketplace
🌍 Global & Regional
- OLX.com - Global classifieds platform
- Dubizzle.com - UAE automotive marketplace
- Webmotors.com.br - Brazilian automotive platform
🚀 Quick Start
Installation
# pip
pip install carapis-api
# poetry
poetry add carapis-api
# pipenv
pipenv install carapis-api
Basic Usage
import asyncio
from carapis import VehiclesAPIClient, CatalogFilters
# Initialize client
client = VehiclesAPIClient(
base_url="https://api.carapis.com",
api_key="your-api-key"
)
async def main():
# Get vehicles with filters
filters = CatalogFilters(
brand_code="toyota",
price_min=10000,
price_max=50000,
page_size=20
)
vehicles = await client.vehicles.list_async(**filters.to_api_params())
print(f"Found {vehicles.count} vehicles")
for vehicle in vehicles.results:
print(f"{vehicle.year} {vehicle.brand_name} {vehicle.model_name} - ${vehicle.price}")
# Run async function
asyncio.run(main())
Synchronous Usage
from carapis import VehiclesAPIClient, CatalogFilters
# Initialize client
client = VehiclesAPIClient(
base_url="https://api.carapis.com",
api_key="your-api-key"
)
# Synchronous calls
filters = CatalogFilters(brand_code="bmw", year_min=2020)
vehicles = client.vehicles.list(**filters.to_api_params())
# Get vehicle details
vehicle_detail = client.vehicles.get("vehicle-id")
print(f"Vehicle: {vehicle_detail.display_name}")
Advanced Filtering
from carapis import CatalogFilters
# Advanced search with multiple filters
filters = CatalogFilters(
search="BMW X5",
year_min=2020,
body_type="suv",
fuel_type="gasoline",
transmission="automatic",
mileage_max=50000,
ordering="-price" # Sort by price descending
)
vehicles = await client.vehicles.list_async(**filters.to_api_params())
Server-Side Rendering (SSR)
from carapis import VehiclesSSRService, CatalogFilters
# Perfect for Django, FastAPI, Flask
async def get_catalog_data(request):
filters = CatalogFilters(
brand_code="toyota",
page_size=20
)
catalog_data = await VehiclesSSRService.get_vehicles_for_catalog(
filters=filters,
page=1,
client=client
)
return {
'vehicles': catalog_data.vehicles,
'total_count': catalog_data.total_count,
'seo': VehiclesSSRService.generate_vehicle_seo(catalog_data.vehicles[0])
}
Brand and Market Data
# Get all brands
brands = await client.brands.list_async()
# Get brand-specific data
brand_data = await VehiclesSSRService.get_brand_page_data("toyota", client=client)
print(f"Toyota has {brand_data.total_count} vehicles available")
print(f"Average price: ${brand_data.stats.average_price}")
# Market statistics
stats = await client.statistics.get_market_overview_async()
print("Market overview:", stats)
🛠️ API Reference
Core Services
VehiclesService- Vehicle listings, search, and detailsBrandsService- Brand information and brand-specific vehiclesSourcesService- Data source management and statisticsStatisticsService- Market analytics and insightsVehiclesSSRService- Server-side rendering utilities
Type Safety with Dataclasses
Full type safety with Python dataclasses and type hints:
from carapis import (
CatalogVehicle, CatalogBrand, CatalogFilters,
VehiclePageData, SEOMetadata
)
# Type-safe filtering
filters = CatalogFilters(
brand_code="toyota",
price_min=15000,
price_max=45000,
body_type="sedan",
fuel_type="hybrid"
)
# Type-safe responses
vehicles: VehiclePageData = await VehiclesSSRService.get_vehicles_for_catalog(
filters=filters, client=client
)
# Access with full IDE support
for vehicle in vehicles.vehicles:
print(f"{vehicle.display_name}: {vehicle.formatted_price}")
print(f"Condition Score: {vehicle.condition_score}/100")
🏗️ Framework Integration
Django
# views.py
from django.shortcuts import render
from carapis import VehiclesSSRService, CatalogFilters
async def vehicle_catalog(request):
filters = CatalogFilters(
search=request.GET.get('search', ''),
brand_code=request.GET.get('brand'),
page_size=20
)
catalog_data = await VehiclesSSRService.get_vehicles_for_catalog(
filters=filters,
page=int(request.GET.get('page', 1)),
client=get_api_client() # Your client instance
)
context = {
'vehicles': catalog_data.vehicles,
'pagination': {
'current_page': catalog_data.current_page,
'total_pages': catalog_data.total_pages,
'has_next': catalog_data.has_next,
'has_previous': catalog_data.has_previous
},
'seo': VehiclesSSRService.generate_search_seo(
filters.search or "Vehicles",
catalog_data.total_count
)
}
return render(request, 'catalog.html', context)
FastAPI
from fastapi import FastAPI, Query
from carapis import VehiclesAPIClient, VehiclesSSRService, CatalogFilters
app = FastAPI()
client = VehiclesAPIClient(base_url="https://api.carapis.com", api_key="your-key")
@app.get("/vehicles/")
async def get_vehicles(
search: str = Query(None),
brand: str = Query(None),
page: int = Query(1),
page_size: int = Query(20)
):
filters = CatalogFilters(
search=search,
brand_code=brand,
page_size=page_size
)
catalog_data = await VehiclesSSRService.get_vehicles_for_catalog(
filters=filters,
page=page,
client=client
)
return {
"vehicles": [vehicle.__dict__ for vehicle in catalog_data.vehicles],
"total_count": catalog_data.total_count,
"current_page": catalog_data.current_page,
"total_pages": catalog_data.total_pages
}
Flask
from flask import Flask, request, jsonify
from carapis import VehiclesAPIClient, CatalogFilters
import asyncio
app = Flask(__name__)
client = VehiclesAPIClient(base_url="https://api.carapis.com", api_key="your-key")
@app.route('/vehicles')
def vehicles():
filters = CatalogFilters(
search=request.args.get('search'),
brand_code=request.args.get('brand'),
page_size=int(request.args.get('page_size', 20))
)
# Run async function in sync context
loop = asyncio.new_event_loop()
asyncio.set_event_loop(loop)
try:
vehicles = loop.run_until_complete(
client.vehicles.list_async(**filters.to_api_params())
)
return jsonify({
'vehicles': [v.__dict__ for v in vehicles.results],
'count': vehicles.count
})
finally:
loop.close()
🔧 Configuration
Environment Variables
# .env
CARAPIS_API_URL=https://api.carapis.com
CARAPIS_API_KEY=your-api-key-here
Client Configuration
from carapis import VehiclesAPIClient
# Basic configuration
client = VehiclesAPIClient(
base_url="https://api.carapis.com",
api_key="your-api-key",
timeout=30,
verify_ssl=True
)
# Check authentication
if client.is_authenticated():
print("Client is authenticated")
# Custom headers
client.set_custom_headers({
'User-Agent': 'MyApp/1.0',
'Accept-Language': 'en-US,en;q=0.9'
})
📊 Use Cases
🏪 Automotive Marketplaces
- Build comprehensive vehicle catalogs
- Real-time inventory management
- Competitive pricing analysis
- Market trend monitoring
🏢 Dealerships & Dealers
- Inventory optimization
- Pricing strategies
- Market research
- Lead generation
📈 Data Analytics & Research
- Market intelligence reports
- Price trend analysis
- Consumer behavior insights
- Regional market studies
🔧 Automotive Apps & Platforms
- Vehicle comparison tools
- Price estimation services
- Market analysis dashboards
- Automotive data enrichment
🌟 Enterprise Features
- 🔒 Secure Authentication - API key and token-based auth
- 📊 Rate Limiting - Intelligent request throttling
- 🛡️ Anti-Detection - Advanced proxy rotation and headers
- 📈 Analytics - Comprehensive usage statistics
- 🔧 Custom Integration - Tailored solutions for enterprise needs
- 📞 24/7 Support - Dedicated technical support team
📚 Documentation & Resources
- API Documentation - Complete API reference
- Platform Guides - Platform-specific documentation
- Market Analysis - Automotive market insights
- Developer Portal - Tools and resources
- Status Page - Real-time API status
🤝 Support & Community
- 📧 Email: support@carapis.com
- 📖 Documentation: docs.carapis.com
📄 License
MIT License - see the LICENSE file for details.
🏢 About CARAPIS
CARAPIS is the world's leading automotive data extraction platform, trusted by Fortune 500 companies, automotive dealers, and data-driven businesses globally. We provide real-time access to automotive data from 25+ international marketplaces with enterprise-grade reliability and advanced anti-detection technology.
Why Choose CARAPIS?
- 🌍 Global Leader - Serving 1000+ clients worldwide
- 🔒 Enterprise Security - SOC 2 compliant, GDPR ready
- ⚡ High Performance - 99.9% uptime, sub-second response times
- 🛡️ Anti-Detection - Advanced proxy networks and rotation
- 📊 Market Intelligence - Deep automotive market insights
- 🤝 Expert Support - Dedicated technical and business support
Ready to access global automotive data? Get your API key and start building with CARAPIS today!
Metadata
Release files for carapis-api 2.0.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| carapis_api-2.0.4.tar.gz | 70.9 kB | Without provenance | Details for carapis_api-2.0.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| carapis_api-2.0.4-py3-none-any.whl | Python 3 | none | any | Details for carapis_api-2.0.4-py3-none-any.whl |
Total release size: 235.3 kB
Release files / carapis_api-2.0.4.tar.gz
| Download URL | carapis_api-2.0.4.tar.gz |
|---|---|
| Size | 70.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e3b470d58c6daffa1a5205c2e130a78e2d14258503e13cd266a95fa4245f6a2a
|
|
BLAKE2b-256 checksum How to use checksums |
e0ada036e75994843540b1b4405cdefa66f1ceee4cef5e1de63a46ba7bb039db
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.2
|
Release files / carapis_api-2.0.4-py3-none-any.whl
| Download URL | carapis_api-2.0.4-py3-none-any.whl |
|---|---|
| Size | 164.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a890e5f8a2036bfe18f7f220ec8be5bd4861d3880655210b3f256be595b7d835
|
|
BLAKE2b-256 checksum How to use checksums |
8b7f4634b9b484f92c20d744d1d2ed81786d64a8d8b1869b96f54cc4c228e2ab
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.2
|
Security for carapis-api 2.0.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.