Carsales Listing Scraper

E-commerce & Marketplaces

Operated by Sourcelane✓ verified

A scraper for carsales.com.au that extracts complete search-result inventories (new, used and demo vehicles across Australia) and returns structured car-listing metadata: listing identifiers and URLs, title/variant and year/make/model/condition, pricing details (price, pricing type, price excluding government charges, marketplace price badge), vehicle specifications (body type, transmission, engine, fuel type, odometer in km), seller information (seller type, seller identifier, state), promotion/top-spot flag, listing badges, photo count and image URLs, the originating search URL and sort order, the total results for that search, and a scrape timestamp. The connector follows pagination across search results and circumvents the site’s per-search listing cap by automatically subdividing large searches into price bands and then model-year ranges, with deduplication by listing identifier; it operates from search-results pages and uses a rotating pool of Australian IPs to handle rate limits.

Verified Sep 28, 12:10 AM

$0.002

per listing

Up to 100 per call. Only pay for results returned; failed calls are refunded.

What people use it for

Used car market research and price tracking by make, model, state or year
Dealer stock monitoring and competitor analysis
Vehicle valuation results and price-guide benchmarking
Lead generation for automotive finance, insurance and inspection services
Alerts for newly listed cars matching saved searches (can be scheduled and tracked by listing identifier)

Trust & reliability

7d uptime trend

Window	Uptime	Success rate	p50	p95
24h	—	—	—	—
7d	—	—	—	—
30d	—	—	—	—

Calling contract

Call it through Sourcelane's gateway or MCP server. We run the connector, apply your agent's spend guardrails, and bill only the results returned.

Call it via Sourcelane

curl -X POST https://cool-puffin-608.convex.site/v1/call \
  -H "Authorization: Bearer sl_live_your_agent_key" \
  -H "Content-Type: application/json" \
  -d '{"listing":"carsales-scraper","params":{"searchUrls":["https://www.carsales.com.au/cars/used/toyota/hilux/"],"maxItems":5},"maxResults":10}'

Request params

Field	Type	Required	Description
`searchUrls`	array	required	One or more carsales.com.au search result URLs copied from your browser, e.g. https://www.carsales.com.au/cars/used/toyota/hilux/ or https://www.carsales.com.au/cars/used/tesla/model-3/victoria-state/. Filters in the URL (make, model, state, price, year, body style, fuel, transmission, sort) are all honoured. Individual listing pages are not supported.
`maxItems`	integer	optional	Maximum number of unique listings to save across all search URLs. Set 0 for no limit. Capped at 100 per call.
`deepCollection`	boolean	optional	carsales only serves the first 20 pages (about 440 listings) of any search. When a search is larger, automatically split it into price bands, then model years, and merge the results so you get the whole set.
`maxPagesPerSearch`	integer	optional	How many result pages (about 22 listings each) to read for each search or sub-search. The site serves at most 20.

Each result contains

Field	Type	Description
`adId`	string	Ad Id
`listingId`	string	Listing Id
`url`	string	Url
`title`	string	Title
`variant`	string	Variant
`year`	integer	Year
`make`	string	Make
`model`	string	Model
`condition`	string	Condition
`price`	integer	Price
`priceType`	string	Price Type
`priceExclGovtCharges`	integer	Price Excl Govt Charges
`priceBadge`	string	—
`bodyType`	string	—
`transmission`	string	—
`engine`	string	—
`fuelType`	string	—
`odometerKm`	integer	—
`sellerType`	string	—
`sellerId`	string	—
`state`	string	—
`isPromoted`	boolean	—
`badges`	array	—
`imageCount`	integer	—
`images`	array	—
`searchUrl`	string	—
`sortBy`	string	—
`totalResultsForSearch`	integer	—
`scrapedAt`	string	—

Use Carsales Listing Scraper from Claude, ChatGPT or Cursor

Pick your tool and connect in under a minute. Then just ask — for example: “Track the price of these 20 grocery items at Woolworths and Coles every week.”

Connect Claude

Web, desktop and mobile. Paste one URL.

1Copy your personal connector URL
2In Claude open Settings → Connectors → Add custom connector
3Paste the URL and click Add — done

Manual setup (config files, REST, Python) +

Claude Code

Adds the Sourcelane MCP server with your key as a header.

terminal

claude mcp add --transport http sourcelane https://cool-puffin-608.convex.site/mcp \
  --header "Authorization: Bearer sl_live_your_agent_key"

Claude Desktop (config file)

Alternative to the connector URL: add to claude_desktop_config.json, then restart Claude.

claude_desktop_config.json

{
  "mcpServers": {
    "sourcelane": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://cool-puffin-608.convex.site/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer sl_live_your_agent_key"
      }
    }
  }
}

Cursor & Windsurf

Add to ~/.cursor/mcp.json (or Windsurf's mcp_config.json).

mcp.json

{
  "mcpServers": {
    "sourcelane": {
      "url": "https://cool-puffin-608.convex.site/mcp",
      "headers": {
        "Authorization": "Bearer sl_live_your_agent_key"
      }
    }
  }
}

VS Code

Save as .vscode/mcp.json. VS Code prompts for your key once.

.vscode/mcp.json

{
  "servers": {
    "sourcelane": {
      "type": "http",
      "url": "https://cool-puffin-608.convex.site/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sourcelane-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "sourcelane-key",
      "description": "Sourcelane agent key",
      "password": true
    }
  ]
}

ChatGPT Custom GPT (Actions)

Create a GPT → Actions → Import from URL, then Authentication: API Key, Bearer.

OpenAPI schema URL

https://sourcelane-amber.vercel.app/openapi.json

REST

One POST. Pass maxResults to cap cost.

curl

curl -X POST https://cool-puffin-608.convex.site/v1/call \
  -H "Authorization: Bearer sl_live_your_agent_key" \
  -H "Content-Type: application/json" \
  -d '{"listing":"carsales-scraper","params":{"searchUrls":["https://www.carsales.com.au/cars/used/toyota/hilux/"],"maxItems":5},"maxResults":10}'

Python, LangChain, CrewAI, OpenAI Agents SDK…

Wrap the REST call as a tool, or point an MCP client at the endpoint.

python

import requests

res = requests.post(
    "https://cool-puffin-608.convex.site/v1/call",
    headers={"Authorization": "Bearer sl_live_your_agent_key"},
    json={
        "listing": "carsales-scraper",
        "params": {"searchUrls":["https://www.carsales.com.au/cars/used/toyota/hilux/"],"maxItems":5},
        "maxResults": 10,
    },
    timeout=300,
)
body = res.json()
print(body["receipt"]["chargedMicros"], "micro-USD for", body["receipt"]["results"], "results")
print(body["data"])

Reviews

—

0 reviews

Leave a review

Loading reviews…