Getting Started with the Carapis API

The Carapis API is one unified REST endpoint that returns structured used-car listing data from 60+ platforms — make, model, year, mileage, price, photos and dealer info — authenticated with a single Bearer key. You pick a platform with the source parameter; the response shape stays identical everywhere, so you integrate once and query every market.

Base URL and version

All requests go to:

https://api.carapis.com/v2

The current version is /v2. Every endpoint is path-versioned, so your integration stays stable.

Authenticate

Every request needs an Authorization header with your API key as a Bearer token:

Authorization: Bearer <API_KEY>

Get a key at my.carapis.com . Keep it secret — store it in an environment variable, never commit it. See Authentication for details.

Your first request

Fetch 20 listings from a single platform. Set source to a platform slug (the full list of valid slugs is on the platforms page):

import requests
 
resp = requests.get(
    "https://api.carapis.com/v2/listings",
    params={"source": "encar", "limit": 20},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
data = resp.json()
for car in data["results"]:
    print(car["make"], car["model"], car["year"], car["price"])

const res = await fetch(
  "https://api.carapis.com/v2/listings?source=encar&limit=20",
  { headers: { Authorization: `Bearer ${process.env.CARAPIS_API_KEY}` } },
);
const { results } = await res.json();
for (const car of results) {
  console.log(car.make, car.model, car.year, car.price);
}

curl "https://api.carapis.com/v2/listings?source=encar&limit=20" \
  -H "Authorization: Bearer $CARAPIS_API_KEY"

Response shape

The endpoint returns a paginated envelope. results is an array of listing objects:

{
  "count": 14820,
  "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"
    }
  ]
}

Each item is a listing object. When a platform exposes richer data, the object also carries inspection_sheet, accident_history or price_history.

Choosing a source

The source parameter is a platform slug such as encar, mobile-de or auto-ria. Browse every supported platform — and its slug — on the platforms page.

Next steps

• Authentication — Bearer keys and the header format
• Listings — every query parameter and the full field table
• Pagination — iterate beyond the first page
• Rate limits and Errors

Frequently asked questions