🚗 Junk Mail Cars Scraper

Want vehicle ads from Junk Mail in a spreadsheet? This scraper makes it easy.

Use structured filters — better for AI agents — or paste an input_url. When input_url is set it overrides the filters.

This actor stays on vehicle shelves that share the same fields (make, model, year, mileage, fuel, price): cars, cheap cars, bikes, and classic cars and bikes. It returns up to 2000 rows per run.

💡 Perfect for...

• Dealers: Export Junk Mail car and bike ads with make, year, and mileage.
• Dashboards: Track prices and fuel type without paging the site.
• Market research: Slice vehicles by make, year, province, or price.
• Data analysts: Export structured rows with public advert URLs.
• 🤖 AI Agents: Power Claude, Cursor, Codex, the Hermes Agent, and OpenClaw workflows with live Junk Mail vehicle results.
• 📚 RAG Systems: Feed titles, makes, and specs into retrieval pipelines.
• 🔗 AI Workflows: Plug into LangChain, AutoGPT, CrewAI, and similar stacks.

✨ Why you'll love this scraper

• 🔗 Input URL or Filters: Paste a Junk Mail search or advert URL, or pick the same filters as the site. input_url always wins when set.
• 🎯 Website-Matched Filters: Keyword, vehicle shelf, make, province, price, year, mileage, fuel, transmission, body type, colour, condition, and sort.
• 🌐 Full ads: Make, model, year, mileage, fuel, photos, seller, and description.

📦 What's inside the data?

id, url, title, price, price_text, currency, location, posted, image, images, description, seller, listing_type, brand, model, year, mileage_km, fuel, transmission, color, body_type, ad_code

🚀 Quick start

Option A: paste https://www.junkmail.co.za/cars. Option B: pick a vehicle shelf, make, or other filter and set max_results.

Input Example (filters):

{
  "category": "cars",
  "brand": "toyota",
  "location": "gauteng",
  "year_min": 2018,
  "price_max": 250000,
  "max_results": 100
}

Input Example (URL):

{
  "input_url": "https://www.junkmail.co.za/cars/toyota/gauteng",
  "max_results": 100
}

Output Example:

{
  "id": "bc4d684e614a4454890336fd27c74478",
  "url": "https://www.junkmail.co.za/cars/mitsubishi/national/mitsubishi-colt-trail-buster-2400i-4x4/bc4d684e614a4454890336fd27c74478",
  "title": "Mitsubishi Colt Trail Buster 2400i 4X4",
  "price": 119900,
  "currency": "ZAR",
  "location": "National",
  "brand": "Mitsubishi",
  "model": "Colt 2400i 4x4 Trailbuster",
  "year": 2001,
  "mileage_km": 220000,
  "fuel": "Petrol",
  "image": "https://junkmailimages.blob.core.windows.net/large/ea6b9cbd7f424ecebfbace1ab14be2de.jpg"
}

Output fields:

Field	Description
id	Advert id.
url	Public advert page.
title	Advert title.
price	Price in rand when shown.
currency	Always ZAR.
brand	Make.
model	Model text from the advert.
year	Model year.
mileage_km	Odometer reading in kilometres.
fuel	Petrol, diesel, hybrid, or electric when shown.
condition	New, used, or demo when the advert says.
image	Photo that opens as an image.

📋 Input reference

Parameter	Type	Required	Default	Description
input_url	string	No	—	Junk Mail search, category, or advert URL. Overrides every filter.
query	string	No	—	Same as the site search box.
category	dropdown	No	Cars	Cars, cheap cars, bikes, or classic cars and bikes.
brand	dropdown	No	any	Make, same list as the cars menu.
location	dropdown	No	South Africa	Province.
fuel	dropdown	No	any	Petrol, diesel, hybrid, or electric.
transmission	dropdown	No	any	Manual or automatic.
body_type	dropdown	No	any	Hatchback, sedan, bakkie, SUV, and the other body types.
color	dropdown	No	any	Exterior colour.
condition	dropdown	No	any	New, used, or demo.
price_min	integer	No	—	Lowest price in rand.
price_max	integer	No	—	Highest price in rand.
year_min	integer	No	—	Oldest model year.
year_max	integer	No	—	Newest model year.
mileage_min	integer	No	—	Lowest mileage in kilometres.
mileage_max	integer	No	—	Highest mileage in kilometres.
sort	dropdown	No	Site default	Latest ads, or price low to high / high to low.
max_results	integer	No	50	Maximum rows (1–2000).