Webmotors.com.br API Reference

Complete API documentation for extracting automotive data from Webmotors.com.br, Brazil's leading automotive marketplace.

🔗 Base URL

https://api.carapis.com/v1/webmotors

🔐 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., "Toyota")
`model`	string	No	Vehicle model (e.g., "Corolla")
`year_from`	integer	No	Minimum year
`year_to`	integer	No	Maximum year
`price_min`	integer	No	Minimum price in BRL
`price_max`	integer	No	Maximum price in BRL
`mileage_max`	integer	No	Maximum mileage in km
`fuel_type`	string	No	Fuel type (gasoline, ethanol, flex, diesel, electric)
`transmission`	string	No	Transmission type (manual, automatic)
`state`	string	No	Brazilian state
`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/webmotors/search?brand=Toyota&model=Corolla&year_from=2020&price_max=150000&state=São Paulo" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "success": true,
  "data": {
    "listings": [
      {
        "id": "wm_123456789",
        "title": "Toyota Corolla XEi 2.0 2022",
        "brand": "Toyota",
        "model": "Corolla",
        "year": 2022,
        "price": 125000,
        "original_price": 135000,
        "mileage": 25000,
        "fuel_type": "flex",
        "transmission": "automatic",
        "color": "Prata",
        "location": {
          "state": "São Paulo",
          "city": "São Paulo",
          "neighborhood": "Vila Madalena"
        },
        "dealer": {
          "id": "dealer_123",
          "name": "Toyota São Paulo",
          "rating": 4.8,
          "verified": true
        },
        "features": ["Air Conditioning", "Power Windows", "Bluetooth", "Backup Camera"],
        "images": ["https://example.com/image1.jpg", "https://example.com/image2.jpg"],
        "url": "https://www.webmotors.com.br/carros/toyota/corolla/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": "Toyota",
        "model": "Corolla",
        "year_from": 2020,
        "price_max": 150000,
        "state": "São Paulo"
      },
      "available": {
        "brands": ["Toyota", "Honda", "Volkswagen"],
        "price_ranges": ["0-50000", "50000-100000", "100000-150000"],
        "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/webmotors/listing/wm_123456789" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "success": true,
  "data": {
    "id": "wm_123456789",
    "title": "Toyota Corolla XEi 2.0 2022",
    "description": "Excelente Toyota Corolla XEi 2.0 2022, único dono, revisões em concessionária...",
    "brand": "Toyota",
    "model": "Corolla",
    "version": "XEi 2.0",
    "year": 2022,
    "model_year": 2023,
    "price": 125000,
    "original_price": 135000,
    "financing": {
      "available": true,
      "monthly_payment": 2500,
      "down_payment": 25000,
      "terms": [12, 24, 36, 48, 60]
    },
    "specifications": {
      "engine": "2.0L 4-cylinder",
      "power": "169 hp",
      "torque": "205 Nm",
      "fuel_type": "flex",
      "transmission": "automatic",
      "drivetrain": "front-wheel drive",
      "mileage": 25000,
      "color": "Prata",
      "interior_color": "Preto",
      "doors": 4,
      "seats": 5
    },
    "features": {
      "safety": ["ABS", "Airbag Driver", "Airbag Passenger", "Electronic Stability Control", "Traction Control"],
      "comfort": ["Air Conditioning", "Power Windows", "Power Locks", "Cruise Control", "Bluetooth"],
      "technology": ["Touchscreen", "Backup Camera", "USB Port", "Apple CarPlay", "Android Auto"]
    },
    "condition": {
      "overall": "excellent",
      "exterior": "excellent",
      "interior": "excellent",
      "mechanical": "excellent",
      "accident_history": false,
      "single_owner": true
    },
    "location": {
      "state": "São Paulo",
      "city": "São Paulo",
      "neighborhood": "Vila Madalena",
      "address": "Rua Harmonia, 123",
      "coordinates": {
        "latitude": -23.5505,
        "longitude": -46.6333
      }
    },
    "dealer": {
      "id": "dealer_123",
      "name": "Toyota São Paulo",
      "type": "authorized_dealer",
      "rating": 4.8,
      "reviews_count": 1250,
      "verified": true,
      "contact": {
        "phone": "+55 11 99999-9999",
        "whatsapp": "+55 11 99999-9999",
        "email": "contato@toyotasaopaulo.com.br"
      }
    },
    "images": [
      {
        "url": "https://example.com/image1.jpg",
        "alt": "Front view",
        "primary": true
      },
      {
        "url": "https://example.com/image2.jpg",
        "alt": "Side view",
        "primary": false
      }
    ],
    "documents": {
      "registration": "valid",
      "insurance": "included",
      "maintenance_book": "complete",
      "manual": "included"
    },
    "url": "https://www.webmotors.com.br/carros/toyota/corolla/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/webmotors/dealer/dealer_123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "success": true,
  "data": {
    "id": "dealer_123",
    "name": "Toyota São Paulo",
    "type": "authorized_dealer",
    "brands": ["Toyota", "Lexus"],
    "rating": 4.8,
    "reviews_count": 1250,
    "verified": true,
    "since": "2010-01-01",
    "location": {
      "state": "São Paulo",
      "city": "São Paulo",
      "neighborhood": "Vila Madalena",
      "address": "Rua Harmonia, 123",
      "coordinates": {
        "latitude": -23.5505,
        "longitude": -46.6333
      }
    },
    "contact": {
      "phone": "+55 11 99999-9999",
      "whatsapp": "+55 11 99999-9999",
      "email": "contato@toyotasaopaulo.com.br",
      "website": "https://www.toyotasaopaulo.com.br"
    },
    "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": "closed"
    },
    "services": ["sales", "financing", "insurance", "maintenance", "warranty"],
    "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
`state`	string	No	Filter by state
`period`	string	No	Time period (7d, 30d, 90d, 1y)

Example Request

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

Example Response

{
  "success": true,
  "data": {
    "period": "30d",
    "brand": "Toyota",
    "market_overview": {
      "total_listings": 12500,
      "average_price": 85000,
      "price_trend": "+2.5%",
      "demand_level": "high"
    },
    "price_analysis": {
      "price_ranges": {
        "0-50000": 15,
        "50000-100000": 45,
        "100000-150000": 30,
        "150000+": 10
      },
      "average_by_model": {
        "Corolla": 95000,
        "Hilux": 180000,
        "SW4": 220000,
        "RAV4": 160000
      }
    },
    "geographic_distribution": {
      "São Paulo": 35,
      "Rio de Janeiro": 20,
      "Minas Gerais": 15,
      "Paraná": 12,
      "Others": 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/webmotors/price-history/wm_123456789?period=30d" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "success": true,
  "data": {
    "listing_id": "wm_123456789",
    "period": "30d",
    "price_history": [
      {
        "date": "2024-01-01",
        "price": 130000,
        "change": 0
      },
      {
        "date": "2024-01-05",
        "price": 128000,
        "change": -2000
      },
      {
        "date": "2024-01-10",
        "price": 125000,
        "change": -3000
      },
      {
        "date": "2024-01-15",
        "price": 125000,
        "change": 0
      }
    ],
    "statistics": {
      "initial_price": 130000,
      "current_price": 125000,
      "total_change": -5000,
      "percentage_change": -3.85,
      "lowest_price": 125000,
      "highest_price": 130000
    }
  }
}

🚗 Brands and Models Endpoints

GET /brands

Get all available vehicle brands.

Example Request

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

Example Response

{
  "success": true,
  "data": [
    {
      "id": "toyota",
      "name": "Toyota",
      "listings_count": 12500,
      "average_price": 85000
    },
    {
      "id": "honda",
      "name": "Honda",
      "listings_count": 9800,
      "average_price": 78000
    },
    {
      "id": "volkswagen",
      "name": "Volkswagen",
      "listings_count": 15200,
      "average_price": 72000
    }
  ]
}

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/webmotors/models/toyota" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "success": true,
  "data": [
    {
      "id": "corolla",
      "name": "Corolla",
      "listings_count": 3200,
      "average_price": 95000,
      "years": [2020, 2021, 2022, 2023, 2024]
    },
    {
      "id": "hilux",
      "name": "Hilux",
      "listings_count": 1800,
      "average_price": 180000,
      "years": [2020, 2021, 2022, 2023, 2024]
    },
    {
      "id": "sw4",
      "name": "SW4",
      "listings_count": 950,
      "average_price": 220000,
      "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.webmotors.search(
    brand="Toyota",
    model="Corolla",
    year_from=2020,
    price_max=150000
)

# Get listing details
listing = client.webmotors.get_listing("wm_123456789")

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

JavaScript SDK

const CarAPIS = require('carapis');

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

// Search for vehicles
const listings = await client.webmotors.search({
  brand: 'Toyota',
  model: 'Corolla',
  yearFrom: 2020,
  priceMax: 150000,
});

// Get listing details
const listing = await client.webmotors.getListing('wm_123456789');

// Get market data
const marketData = await client.webmotors.getMarketData({
  brand: 'Toyota',
  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 Webmotors.com.br automotive data, enabling developers to build powerful automotive applications and services.

🔗 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