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

{
  "id": 9162022,
  "listing_url": "https://www.chavesnamao.com.br//carro/mg-belo-horizonte/suzuki-grand-vitara-2.0-4x2-16v-2p-2015-automatico-branca-RS61900/id-9162022/",
  "title": "Suzuki g.vitara 2wd sd 2015",
  "description": "? Financiamento em até 60x!  ? Preço anunciado válido somente para pagamento à vista ou financiado (sem troca).  ? Quer dar seu carro como parte de pagamento? Consulte condições e valores diferenciados na troca.  ? Trabalhamos com todos os bancos!  ✅ Aprovação facilitada e sem burocracia – inclusive para autônomos.  ? Av Cristiano Machado 7715 B.Vila Suzana BH/MG  ? (31) 9      ? (31)     ",
  "reference": "8532568",
  "is_new": false,
  "is_active": true,
  "accepts_trades": false,
  "brand": "SUZUKI",
  "model": "GRAND VITARA",
  "version": "2.0 4X2 16V 2P",
  "model_year": 2015,
  "mileage": "96.510",
  "transmission": "Automático",
  "fuel": "Gasolina",
  "color": "BRANCA",
  "plate": "",
  "end_plate": "8",
  "price": 61900,
  "price_text": "R$ 61.900",
  "currency": "BRL",
  "city": "Belo Horizonte",
  "state": "MG",
  "neighborhood": "Suzana",
  "street": "Avenida Cristiano Machado",
  "street_number": "7715",
  "address_complement": "",
  "zip_code": "31260-500",
  "latitude": "-19.937525",
  "longitude": "-43.926453",
  "is_public_address": false,
  "dealer_name": "JPRIME SEMINOVOS",
  "dealer_type": "PJ",
  "dealer_url": "https://www.chavesnamao.com.br//revenda/jprime-seminovos/mg-belo-horizonte/id-930436/",
  "dealer_since": "2025-07-25T03:00:00.000Z",
  "dealer_logo": "930436-1763142908.JPG",
  "dealer_street": "Avenida Cristiano Machado",
  "dealer_street_number": "7715",
  "dealer_neighborhood": "Suzana",
  "dealer_zip_code": "31260-500",
  "dealer_city": "Belo Horizonte",
  "dealer_state": "Minas Gerais",
  "dealer_state_acronym": "MG",
  "dealer_cellphone": "(31) 97155-5744",
  "dealer_cellphone_has_whatsapp": true,
  "dealer_landline": "(31) 3203-0476",
  "dealer_landline_has_whatsapp": false,
  "dealer_commercial_phone": "",
  "dealer_whatsapp_numbers": [
    "(31) 97155-5744"
  ],
  "dealer_phones_public": true,
  "dealer_google_rating": 4.9,
  "dealer_google_reviews": 260,
  "dealer_google_maps_url": "https://www.google.com/maps?cid=12010274621773282753&hl=pt-BR&gl=BR",
  "leasing_available": true,
  "schedule_in_person": false,
  "schedule_virtual": false,
  "contact_whatsapp": true,
  "contact_message": true,
  "contact_phone": true,
  "optionals_count": 30,
  "optionals": [
    "Ar quente",
    "Bancos de couro",
    "Desembaçador traseiro",
    "Rodas de liga leve",
    "Vidro elétrico",
    "Abs",
    "Airbag",
    "Ar condicionado",
    "Direção hidráulica",
    "Trava elétrica",
    "Alarme",
    "Insulfilm",
    "Retrovisor elétrico",
    "Apoio de braço",
    "Banco bi partido",
    "Câmera de ré",
    "Computador de bordo",
    "Limpador traseiro",
    "Porta copos",
    "Sensor de ré",
    "Volante multifuncional",
    "Piloto automático",
    "Banco reclinável",
    "Banco(s) com ajuste de altura",
    "Espelhos elétricos",
    "Câmbio automatizado",
    "Faróis de milha",
    "Banco motorista com regulagem de altura",
    "Bancos com regulagem",
    "Sensor de estacionamento"
  ],
  "other_infos": [],
  "photo_count": 11,
  "featured_photo": "930436/9162022/suzuki-grand-vitara-em-belo-horizonte-mg-ed054d0e.jpg",
  "photo_paths": [
    "930436/9162022/suzuki-grand-vitara-em-belo-horizonte-mg-ed054d0e.jpg",
    "930436/9162022/suzuki-grand-vitara-em-belo-horizonte-mg-6d87a232.jpg",
    "930436/9162022/suzuki-grand-vitara-em-belo-horizonte-mg-bafb1737.jpg",
    "930436/9162022/suzuki-grand-vitara-em-belo-horizonte-mg-83ebb1cc.jpg",
    "930436/9162022/suzuki-grand-vitara-em-belo-horizonte-mg-ce4c3239.jpg"
  ],
  "raw_data": null,
  "from_url": "https://www.chavesnamao.com.br/carros-usados/brasil/?pg=4"
}

The scraper returns JSON data with each vehicle listing as an object containing detailed fields. Understanding field purposes enables effective analysis and application.

Listing Identification

ID: Unique numeric identifier of the listing on Chaves na Mão. Purpose: Database indexing, tracking specific listings over time, avoiding duplicates, linking to detail pages.

Listing URL: Direct link to the full vehicle listing. Purpose: Accessing complete details, sharing opportunities with clients, verification of scraped data.

Title: Headline of the listing. Purpose: Quick preview, keyword analysis, listing summaries.

Description: Free-text description written by the advertiser. Purpose: Extracting extra details (protection film, included options, condition notes), keyword analysis.

Reference: Dealer's internal stock reference code for the vehicle. Purpose: Matching listings with the dealer's own inventory and cross-checking duplicates.

Is New: Whether the vehicle is sold as new. Purpose: Separating new from used vehicles.

Is Active: Whether the listing is currently active. Purpose: Filtering out expired or inactive listings.

Accepts Trades: Whether the seller accepts a vehicle in trade. Purpose: Identifying flexible sellers and negotiation opportunities.

Vehicle Details

Brand: Vehicle manufacturer. Purpose: Brand-level market analysis and filtering.

Model: Vehicle model name. Purpose: Model-level price and demand comparison.

Version: Specific trim/engine version of the model. Purpose: Fine-grained comparison of equivalent vehicles.

Model Year: Year of the vehicle model. Purpose: Depreciation analysis and age-based filtering.

Mileage: Odometer reading in kilometers as displayed on the listing (text, locale-formatted). Purpose: Condition assessment, price-versus-usage analysis.

Transmission: Transmission type (e.g., Automático). Purpose: Filtering by buyer preference.

Fuel: Fuel type (e.g., Gasolina). Purpose: Segmenting by fuel and running costs.

Color: Exterior color of the vehicle. Purpose: Color preference analysis and filtering.

Plate: License plate (often empty because it is hidden by the dealer). Purpose: Vehicle identification and history checks when available.

End Plate: Last digit of the license plate. Purpose: Determining the vehicle's annual licensing/tax due period and driving-restriction day.

Pricing

Price: Asking price as a number. Purpose: Price comparison, market valuation, budget filtering.

Price Text: Price exactly as displayed on the listing. Purpose: Display and verification against the website.

Currency: Currency of the listed price (BRL). Purpose: Correct financial interpretation when merging datasets from multiple markets.

Vehicle Location

City: City where the vehicle is located. Purpose: City-level market analysis and lead targeting.

State: State abbreviation of the vehicle location. Purpose: Regional aggregation and filtering.

Neighborhood: Neighborhood of the vehicle location. Purpose: Hyper-local analysis and visit planning.

Street: Street name of the vehicle location. Purpose: Visit planning and address verification.

Street Number: Street number of the vehicle location. Purpose: Precise address identification.

Address Complement: Additional address details (may be empty). Purpose: Completing the address for navigation.

Zip Code: Postal code (CEP) of the location. Purpose: Geographic grouping and postcode-level analysis.

Latitude: Geographic latitude of the location. Purpose: Map plotting, distance calculations, spatial analysis.

Longitude: Geographic longitude of the location. Purpose: Map plotting, distance calculations, spatial analysis.

Is Public Address: Whether the exact address is publicly shown on the listing. Purpose: Knowing whether the address and coordinates are exact or approximate.

Dealer / Seller

Dealer Name: Name of the dealership or seller. Purpose: Lead generation, competitor analysis, market share evaluation.

Dealer Type: Seller type (e.g., PJ = company, PF = individual). Purpose: Separating dealerships from private sellers.

Dealer URL: Link to the dealer's profile page. Purpose: Exploring the dealer's full inventory and contact information.

Dealer Since: Date the dealer's contract with the platform started (ISO 8601). Purpose: Estimating dealer tenure and activity on the platform.

Dealer Logo: File name of the dealer logo image. Purpose: Branding in reports and dashboards.

Dealer Street: Street name of the dealer's address. Purpose: Local outreach and visit planning.

Dealer Street Number: Street number of the dealer's address. Purpose: Precise address identification.

Dealer Neighborhood: Neighborhood of the dealer's address. Purpose: Local targeting.

Dealer Zip Code: Postal code of the dealer's address. Purpose: Geographic grouping of dealers.

Dealer City: City of the dealer. Purpose: City-level dealer analysis.

Dealer State: Full state name of the dealer. Purpose: Regional dealer analysis.

Dealer State Acronym: State abbreviation of the dealer. Purpose: Compact regional filtering.

Dealer Cellphone: Dealer mobile phone number. Purpose: Direct outreach to the dealer.

Dealer Cellphone Has WhatsApp: Whether the mobile number is available on WhatsApp. Purpose: Choosing the best contact channel.

Dealer Landline: Dealer landline phone number. Purpose: Alternative contact channel.

Dealer Landline Has WhatsApp: Whether the landline is available on WhatsApp. Purpose: Choosing the best contact channel.

Dealer Commercial Phone: Dealer commercial phone number (may be empty). Purpose: Additional contact channel when available.

Dealer WhatsApp Numbers: List of dealer numbers that accept WhatsApp. Purpose: Direct messaging outreach.

Dealer Phones Public: Whether the dealer phone numbers are publicly displayed. Purpose: Knowing whether contact data is openly available.

Dealer Google Rating: Average Google Business rating of the dealer. Purpose: Reputation analysis and dealer quality benchmarking.

Dealer Google Reviews: Number of Google reviews for the dealer. Purpose: Weighting the reliability of the rating.

Dealer Google Maps URL: Link to the dealer's Google Maps listing. Purpose: Navigation, review inspection, verification.

Contact and Sales Options

Leasing Available: Whether leasing/financing is offered for this vehicle. Purpose: Identifying listings with financing options.

Schedule In Person: Whether in-person visit scheduling is enabled. Purpose: Planning showroom visits.

Schedule Virtual: Whether virtual visit scheduling is enabled. Purpose: Identifying remote-viewing-ready listings.

Contact WhatsApp: Whether contact via WhatsApp is enabled. Purpose: Choosing the best outreach channel.

Contact Message: Whether contact via on-platform message is enabled. Purpose: Choosing the best outreach channel.

Contact Phone: Whether contact via phone is enabled. Purpose: Choosing the best outreach channel.

Features and Extras

Optionals Count: Number of optional features listed. Purpose: Quick measure of how well-equipped the vehicle is.

Optionals: List of equipment and features (e.g., leather seats, sunroof, parking sensor). Purpose: Feature-based filtering, valuation adjustments, comparing equipment levels.

Other Infos: Additional vehicle information (e.g., factory warranty, spare key, dealership service history). Purpose: Assessing vehicle history and trustworthiness.

Media

Photo Count: Total number of photos in the listing. Purpose: Evaluating listing quality and completeness.

Featured Photo: Relative path of the main listing photo. Purpose: Thumbnails and quick visual identification.

Photo Paths: List of relative image paths in original order (may contain fewer items than Photo Count). Purpose: Downloading images, visual inspection, computer vision analysis.

Raw Data

Raw Data: Complete original JSON object of the listing as scraped, without modification. Purpose: Auditing, debugging, accessing fields not included in the cleaned output, and reprocessing without re-scraping.

---

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.