Skip to content
Scrappa Get API key
Carsales API 1 credit/request

Carsales Facets

GET https://scrappa.co/api/carsales/v1/facets

Return the valid values for one level (make, model, state, body_style or price) under a filter set, with the approximate live result count. Use q to filter the returned values by text. Price returns the price steps in AUD.

Carsales Facets 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/carsales/v1/facets
Auth header
x-api-key
Cost
1 credit/request
Response preview
200 OK
Example JSON appears below when a response schema is available for this endpoint.

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

This endpoint has no required query parameters.

6 optional filters available.

level string Optional

make, model, state, body_style or price.

Example value example
q string Optional

Text to filter the returned values.

Example value coffee shops
condition string Optional

used or new.

Example value example
make string Optional

Make name from the taxonomy endpoint, for example Toyota.

Example value example
model string Optional

Model name from the taxonomy endpoint. Needs make.

Example value example
state string Optional

Full state name or short code, for example Queensland or QLD.

Example value example

Errors

Handle these documented responses before retrying or showing customer-facing failures.

404

HTTP 404

The listing, make, model or year was not found. This response is not billable.

422

HTTP 422

A parameter is invalid, a value is unknown, or no filter was set. This response is not billable.

502

HTTP 502

The upstream answer changed shape and could not be read. This response is not billable.

503

HTTP 503

The upstream refused the request or is unavailable. This response is not billable.

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.