Listings Endpoint
GET /v2/listings is the core Carapis endpoint: it returns structured used-car listings from any supported platform, filtered by make, model, year and price, in one stable JSON schema. Set source to pick the platform; everything else is an optional filter.
GET https://api.carapis.com/v2/listingsQuery parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
source | string | yes | Platform slug to query, e.g. encar. See the platforms page for valid slugs. |
limit | integer | no | Results per page (default 20). |
page | integer | no | Page number, 1-based. See Pagination. |
make | string | no | Filter by manufacturer, e.g. Hyundai. |
model | string | no | Filter by model, e.g. Grandeur. |
year_min | integer | no | Earliest model year (inclusive). |
year_max | integer | no | Latest model year (inclusive). |
price_min | integer | no | Minimum price in the listing currency. |
price_max | integer | no | Maximum price in the listing currency. |
Example request
Python
import requests
resp = requests.get(
"https://api.carapis.com/v2/listings",
params={
"source": "encar",
"make": "Hyundai",
"model": "Grandeur",
"year_min": 2021,
"price_max": 30000000,
"limit": 20,
},
headers={"Authorization": f"Bearer {API_KEY}"},
)
data = resp.json()
print(data["count"], "matches")Example response
{
"count": 312,
"page": 1,
"limit": 20,
"results": [
{
"id": "encar_38217645",
"source": "encar",
"make": "Hyundai",
"model": "Grandeur",
"trim": "2.5 GDi Premium",
"year": 2022,
"mileage": 31500,
"price": 28500000,
"currency": "KRW",
"location": "Seoul",
"fuel_type": "gasoline",
"transmission": "automatic",
"photos": ["https://.../1.jpg", "https://.../2.jpg"],
"dealer": "Encar Certified Dealer",
"url": "https://www.encar.com/dc/dc_cardetailview.do?carid=38217645",
"inspection_sheet": { "panels_repainted": 0, "frame_damage": false },
"accident_history": [],
"price_history": [
{ "date": "2025-05-01", "price": 29200000 },
{ "date": "2025-05-20", "price": 28500000 }
]
}
]
}Listing object
Each item in results is a listing object with the following fields:
| Field | Type | Description |
|---|---|---|
id | string | Unique Carapis listing identifier. |
source | string | Platform slug the listing came from. |
make | string | Vehicle manufacturer. |
model | string | Vehicle model. |
trim | string | Trim or variant name. |
year | integer | Model year. |
mileage | integer | Odometer reading. |
price | integer | Listed price in currency. |
currency | string | ISO 4217 currency code, e.g. KRW, EUR. |
location | string | Listing location. |
fuel_type | string | e.g. gasoline, diesel, hybrid, electric. |
transmission | string | e.g. automatic, manual. |
photos | string[] | Photo gallery URLs. |
dealer | string | Dealer or seller name. |
url | string | Canonical URL of the original listing. |
Optional fields appear only when the source platform exposes them:
| Field | Type | Description |
|---|---|---|
inspection_sheet | object | Structured condition report (Korea/Japan platforms). |
accident_history | array | Recorded accident and repair events. |
price_history | array | Price changes over time, each { date, price }. |
See Pagination to page through large result sets and Errors for failure responses.