Chavesnamao Automotive Scraper: Extract Used Car Listings from Brazil

---

What Is Chavesnamao.com.br?

Chavesnamao.com.br is Brazil's largest used car marketplace, featuring thousands of vehicles listed daily by dealers and private sellers. The platform aggregates inventory across regions, making it a goldmine for automotive market research. However, manually collecting pricing data, vehicle specifications, and market trends across multiple listings is impractical — the Chavesnamao Automotive Scraper automates this process, delivering structured vehicle data in seconds.

---

Overview

The Chavesnamao Automotive Scraper extracts comprehensive vehicle listings from search results pages, converting listings into structured records with 30+ data fields. It is designed for:

• Dealerships monitoring competitor inventory and pricing strategies
• Price analysts building used car valuation models and market benchmarks
• Automotive researchers studying Brazilian vehicle market trends
• Aggregator platforms feeding data into automotive price comparison sites
• Fleet managers tracking vehicle availability by region and category

Key strengths include configurable item limits (up to 200 per page), robust error handling via ignore_url_failures, and direct access to pricing, mileage, images, and optional features.

---

Input Format

The scraper accepts a JSON configuration with search result page URLs:

{
  "urls": [
    "https://www.chavesnamao.com.br/carros-usados/brasil/?pg=4"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}

Parameter	Description
urls	Links to Chavesnamao automotive search result pages. Supports pagination (e.g., ?pg=1, ?pg=2, etc.). Add multiple URLs to scrape across regions or price ranges.
max_items_per_url	Maximum vehicles to extract per page (default: 20, max: 200). Higher values collect more listings per URL.
ignore_url_failures	If true, the scraper skips unavailable pages and continues. Useful for bulk runs across multiple regions.

Tip: Use region-specific URLs like ?estado=sp or filter by price range in the URL to target specific market segments.

---

Output Format

Sample output

{
  "title": "Porsche 911 2024 3.0 24v h6 gasolina carrera s pdk",
  "id": 7558718,
  "description": "Carro conta com PPF FULL, mais de 200 mil de opcionais listados na ultima foto do anuncio!  ",
  "new": false,
  "active": true,
  "highlighted": false,
  "accept_trades": false,
  "reference": "3216949",
  "plate": "",
  "leads_config": {
    "leasing": true,
    "schedule_irl": false,
    "schedule_virtual": false,
    "whatsapp": true,
    "message": true,
    "phones": true
  },
  "url": "/carro/sp-ribeirao-preto/porsche-911-3.0-carrera-s-cabriolet-420cv-2024-automatico-preta-RS1147000/id-7558718/",
  "segment": "VEHICLE",
  "mileage": "2.264",
  "transmission": {
    "name": "Automático"
  },
  "fuel": {
    "name": "Gasolina",
    "id": 2
  },
  "model_year": 2024,
  "vehicle_category": "C",
  "brand": {
    "id": 47,
    "name": "PORSCHE",
    "url": "porsche"
  },
  "model": {
    "id": 617,
    "name": "911",
    "url": "911"
  },
  "version": {
    "id": 4131,
    "name": "3.0 CARRERA S CABRIOLET 420cv",
    "url": "3.0-carrera-s-cabriolet-420cv"
  },
  "prices": {
    "main": "R$ 1.147.000",
    "raw_price": 1147000
  },
  "pictures": {
    "count": 16,
    "featured": "698283/7558718/porsche-911-em-ribeirao-preto-sp-9697d8a0.jpg",
    "list": [
      "698283/7558718/porsche-911-em-ribeirao-preto-sp-9697d8a0.jpg",
      "698283/7558718/porsche-911-em-ribeirao-preto-sp-411bcab7.jpg",
      "698283/7558718/porsche-911-em-ribeirao-preto-sp-97dc60e5.jpg",
      "698283/7558718/porsche-911-em-ribeirao-preto-sp-12ea3445.jpg",
      "698283/7558718/porsche-911-em-ribeirao-preto-sp-1669a25a.jpg"
    ]
  },
  "media": {},
  "location": {
    "city": {
      "name": "Ribeirão Preto"
    },
    "state": {
      "acronym": "SP"
    },
    "geoposition": {
      "lat": "-21.184835",
      "lon": "-47.805477"
    },
    "street": {
      "name": "Avenida Carlos Eduardo de Gasperi Consoni",
      "address_number": "1795"
    },
    "address_comp": "",
    "zip_code": "14021-600",
    "neighborhood": {
      "name": "Jardim Botânico"
    },
    "public_address": false
  },
  "publisher": {
    "category": 2,
    "url": "/revenda/lt4-motors/sp-ribeirao-preto/id-698283/",
    "type": "PJ",
    "contract_date": "2024-12-16T03:00:00.000Z",
    "name": "LT4 MOTORS",
    "logo": "698283-1735590560.png",
    "address": {
      "public_address": false,
      "address_comp": "",
      "street": {
        "name": "Avenida Carlos Eduardo de Gasperi Consoni",
        "address_number": "1795"
      },
      "neighborhood": {
        "name": "Jardim Botânico"
      },
      "zip_code": "14021-600",
      "city": {
        "id": 9560,
        "name": "Ribeirão Preto",
        "url": "sp-ribeirao-preto"
      },
      "state": {
        "id": 26,
        "name": "São Paulo",
        "acronym": "SP"
      }
    },
    "phones": {
      "cellphone": {
        "number": "(16) 99703-1795",
        "whatsapp": true
      },
      "landline": {
        "number": "(16) 3289-9409",
        "whatsapp": false
      },
      "commercial": {
        "number": "",
        "whatsapp": false
      },
      "whatsapp": [
        "(16) 99703-1795"
      ],
      "public": true
    }
  },
  "breadcrumb": [
    {
      "name": "Home",
      "url": "/"
    },
    {
      "name": "Carros",
      "url": "/carros-usados/brasil/"
    },
    {
      "name": "SP",
      "url": "/carros-usados/sp/"
    },
    {
      "name": "Ribeirão Preto",
      "url": "/carros-usados/sp-ribeirao-preto/"
    },
    {
      "name": "PORSCHE",
      "url": "/carros/sp-ribeirao-preto/porsche/"
    },
    {
      "name": "911",
      "url": "/carros/sp-ribeirao-preto/porsche-911/"
    },
    {
      "name": "3.0 CARRERA S CABRIOLET 420cv",
      "url": "/carros/sp-ribeirao-preto//carro/sp-ribeirao-preto/porsche-911-3.0-carrera-s-cabriolet-420cv-2024-automatico-preta-RS1147000/id-7558718//"
    }
  ],
  "color": {
    "name": "PRETA",
    "id": 2,
    "hexadecimal": "#2"
  },
  "end_plate": "5",
  "gmb": {
    "total_reviews": 28,
    "rating": 4.6,
    "url": "https://www.google.com/maps?cid=10707351600559571770&hl=pt-BR&gl=BR"
  },
  "optionals": [
    {
      "name": "Ar quente",
      "id": 3
    },
    {
      "name": "Bancos de couro",
      "id": 6
    },
    {
      "name": "Desembaçador traseiro",
      "id": 12
    },
    {
      "name": "Rodas de liga leve",
      "id": 21
    },
    {
      "name": "Vidro elétrico",
      "id": 22
    },
    {
      "name": "Teto solar",
      "id": 24
    },
    {
      "name": "Abs",
      "id": 27
    },
    {
      "name": "Airbag",
      "id": 38
    },
    {
      "name": "Ar condicionado",
      "id": 40
    },
    {
      "name": "Direção hidráulica",
      "id": 42
    },
    {
      "name": "Trava elétrica",
      "id": 44
    },
    {
      "name": "Alarme",
      "id": 113
    },
    {
      "name": "Insulfilm",
      "id": 139
    },
    {
      "name": "Controle no volante",
      "id": 200
    },
    {
      "name": "Kit multimídia",
      "id": 202
    },
    {
      "name": "Retrovisor elétrico",
      "id": 210
    },
    {
      "name": "Câmera de ré",
      "id": 241
    },
    {
      "name": "CD player",
      "id": 244
    },
    {
      "name": "Computador de bordo",
      "id": 245
    },
    {
      "name": "Direção elétrica",
      "id": 248
    },
    {
      "name": "DVD",
      "id": 250
    },
    {
      "name": "Encosto de cabeça",
      "id": 251
    },
    {
      "name": "Farol de neblina",
      "id": 256
    },
    {
      "name": "Farol de xenon",
      "id": 257
    },
    {
      "name": "Limpador traseiro",
      "id": 259
    },
    {
      "name": "MP3 player",
      "id": 262
    },
    {
      "name": "Porta copos",
      "id": 264
    },
    {
      "name": "Retrovisor fotocromico",
      "id": 271
    },
    {
      "name": "Sensor de chuva",
      "id": 273
    },
    {
      "name": "Volante com regulagem de altura",
      "id": 278
    },
    {
      "name": "Controle de tração",
      "id": 280
    },
    {
      "name": "GPS",
      "id": 281
    },
    {
      "name": "Piloto automático",
      "id": 286
    },
    {
      "name": "USB",
      "id": 288
    },
    {
      "name": "Para-choques na cor do veículo",
      "id": 308
    },
    {
      "name": "Bancos dianteiros com aquecimento",
      "id": 310
    },
    {
      "name": "Controle de velocidade",
      "id": 313
    },
    {
      "name": "Airbag lateral",
      "id": 345
    },
    {
      "name": "Faróis de milha",
      "id": 373
    },
    {
      "name": "Banco motorista com regulagem de altura",
      "id": 401
    },
    {
      "name": "Sensor de estacionamento",
      "id": 411
    }
  ],
  "other_infos": [
    {
      "name": "Todas revisões em concessionária",
      "id": 5
    },
    {
      "name": "Garantia de fábrica",
      "id": 8
    },
    {
      "name": "Manual",
      "id": 9
    },
    {
      "name": "Chave reserva",
      "id": 10
    }
  ],
  "from_url": "https://www.chavesnamao.com.br/carros-usados/brasil/?pg=4"
}

Each vehicle listing returns a comprehensive record with 30+ fields covering identification, specifications, pricing, media, and availability:

Vehicle Identification

Field	Description
ID	Unique identifier for the listing in Chavesnamao's database
Title	Vehicle title (e.g., "2018 Honda Civic 1.8 LXS Auto")
Reference	Internal reference number for the dealership or publisher
URL	Direct link to the individual vehicle listing page
Description	Full text description provided by the seller

Core Specifications

Field	Description
Brand	Vehicle manufacturer (e.g., Honda, Toyota, Chevrolet)
Model	Model name (e.g., Civic, Corolla, Onix)
Version	Trim level or variant (e.g., LXS, SE, Elegance)
Model Year	Manufacturing year of the vehicle
Vehicle Category	Type classification (sedan, SUV, hatchback, truck, etc.)
Segment	Market segment (economy, mid-range, premium, luxury)

Technical Details

Field	Description
Fuel	Fuel type (gasoline, diesel, ethanol/flex, hybrid, electric)
Transmission	Transmission type (manual, automatic, CVT)
Mileage	Odometer reading in kilometers
Color	Vehicle exterior color
End Plate	Last digit of the license plate
Plate	Full license plate number (if available)

Pricing & Transaction

Field	Description
Prices	Asking price(s) in Brazilian Real (R$), including negotiation info
Accept Trades	Boolean indicating if the seller accepts trade-ins
Leads Config	Configuration for lead generation (dealer contact methods)

Features & Condition

Field	Description
Optionals	List of optional features (air conditioning, power steering, sunroof, etc.)
Other Infos	Additional details (service history, accident status, warranty info)
New	Boolean indicating if the vehicle is brand new (rare on used car sites)
Active	Whether the listing is currently active for sale
Highlighted	Boolean for premium/featured listings with increased visibility
GMB	Google My Business integration status (dealer location)

Media & Location

Field	Description
Pictures	Array of image URLs showing the vehicle (exterior, interior, details)
Media	Additional media files or video links
Location	Geographic location (city, state) where the vehicle is physically located
Breadcrumb	Navigation path showing category hierarchy (e.g., Carros Usados > São Paulo > Sedans)

Publisher Information

Field	Description
Publisher	Information about the listing owner (dealership name, private seller ID)

---

How to Use

1. Identify search pages — Navigate to Chavesnamao.com.br and build a search (by region, price, brand, etc.). Copy the result page URL, including pagination parameters.

2. Prepare URLs — Add one or more search result URLs to the urls array. Example formats:

   • By region: https://www.chavesnamao.com.br/carros-usados/brasil/?estado=sp
   • By price: https://www.chavesnamao.com.br/carros-usados/brasil/?preco_ate=50000
   • Paginated: https://www.chavesnamao.com.br/carros-usados/brasil/?pg=1, ?pg=2, etc.

3. Configure limits — Set max_items_per_url (recommend 100–200 for comprehensive data).

4. Run the scraper — Start execution and monitor progress in the run log.

5. Export & analyze — Download results as JSON or CSV for spreadsheet analysis, database import, or API integration.

Best practices:

• Test with a single URL first to verify output structure
• Use ignore_url_failures: true when scraping 10+ pages to tolerate temporary blocks
• Space out large runs to avoid overwhelming the server

---

Use Cases & Business Value

• Price benchmarking: Compare vehicle pricing across regions and brands in real-time
• Inventory analysis: Track used car supply trends by model and category
• Competitive intelligence: Monitor dealer pricing strategies and inventory levels
• Market research: Build datasets for automotive price prediction models
• Integration: Feed data into CRM systems, pricing engines, or data warehouses

The Chavesnamao Automotive Scraper eliminates manual data entry and spreadsheet updates, enabling dealers, analysts, and platforms to make data-driven decisions with current market information.

---

Conclusion

The Chavesnamao Automotive Scraper streamlines access to Brazil's largest used car marketplace. With 30+ output fields covering pricing, specifications, images, and seller information, it unlocks market intelligence that would take hours to collect manually. Whether you're a dealer tracking competitors or a researcher analyzing automotive trends, this scraper delivers the structured data you need instantly.