name: TheCarApi
description: >-
  A multi-source vehicle auction inventory REST/JSON API aggregating live and archived auction listings and European
  retail classifieds. Provides search, facets, catalog, auction detail & price history, VIN history, market
  intelligence, and import cost calculators. Fully specified via OpenAPI 3.1 with Postman collection and agent-native
  documentation (llms.txt).
url: https://raw.githubusercontent.com/api-evangelist/thecarapi/refs/heads/main/apis.yml
image: https://thecarapi.com/og-image.png
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  - scopes
  - rate-limits
  - security
  - sandbox
  generated: '2026-09-02'
  method: derived
created: '2026-09-01'
modified: '2026-09-02'
specificationVersion: '0.21'
tags:
  - Automotive
  - Vehicle Data
  - Car Auctions
  - Used Cars
  - Vehicle Inventory
  - Classifieds
  - Market Intelligence
  - Pricing
  - VIN
  - Image CDN
  - Europe
  - South Korea
  - Japan Auctions
tags_raw:
  - Automotive
  - Vehicle Data
  - Car Auctions
  - Used Cars
  - Vehicle Inventory
  - Classifieds
  - Market Intelligence
  - Pricing
  - VIN
  - Image CDN
  - Europe
  - Korea
  - Japan Auctions
apis:
- aid: thecarapi:thecarapi-auctions-history-api
  name: TheCarApi Auctions & history API
  description: >-
    Retrieve source-aware listing detail, galleries, price changes, and VIN history. A running openlane
    or ecarstrade auction has its bid read from the auction house at the moment you request the detail
    — nothing needs to be passed to enable it. Every other listing is served at its cycle price, refreshed
    at least every twelve hours.
  humanURL: https://thecarapi.com/docs
  baseURL: https://api.thecarapi.com
  tags:
  - Auctions & history
  properties:
  - type: OpenAPI
    url: openapi/thecarapi-auctions-history-api-openapi.yml
  - type: PostmanCollection
    url: https://thecarapi.com/thecarapi.postman_collection.json
  - type: Documentation
    url: https://thecarapi.com/docs
  - type: LLMsTxt
    url: https://thecarapi.com/llms.txt
- aid: thecarapi:thecarapi-catalog-api
  name: TheCarApi Catalog API
  description: >-
    Build slug-addressable manufacturer and model-group navigation. All catalog list routes paginate with
    a default limit of 50 and are capped at offset 5000 — a deeper page is a 400 naming the limit. They
    carry page, page_size and max_page.
  humanURL: https://thecarapi.com/docs
  baseURL: https://api.thecarapi.com
  tags:
  - Catalog
  properties:
  - type: OpenAPI
    url: openapi/thecarapi-catalog-api-openapi.yml
  - type: PostmanCollection
    url: https://thecarapi.com/thecarapi.postman_collection.json
  - type: Documentation
    url: https://thecarapi.com/docs
  - type: LLMsTxt
    url: https://thecarapi.com/llms.txt
- aid: thecarapi:thecarapi-european-classifieds-api
  name: TheCarApi European classifieds API
  description: >-
    A retail price surface of roughly 9.8M live listings gathered from 681 origin portals — national classifieds
    sites, dealer groups and manufacturer stock pages — across 39 European countries: mobile.de, kleinanzeigen.de,
    autoscout24, leboncoin.fr, lacentrale.fr, autosupermarket.it, njuskalo.hr and hundreds more. Every
    listing keeps its origin portal in source_site, so the same feed answers a national question and a
    portal-level one. These are retail listings, not auction inventory: no bidding, no auction end date,
    no detail payload and no gallery, just a single remote thumbnail per listing. They live in their own
    tables with their own vocabulary (seller type, origin portal), which is why they get their own query
    surface instead of a site slug on /api/search. Ended and paid-placement ("promoted") rows are excluded
    from every response, and all three endpoints return 503 while the dataset has not been built yet.
    Scope: theparking — that is the scope name in the path, not the name of a source.
  humanURL: https://thecarapi.com/docs
  baseURL: https://api.thecarapi.com
  tags:
  - European classifieds
  properties:
  - type: OpenAPI
    url: openapi/thecarapi-european-classifieds-api-openapi.yml
  - type: PostmanCollection
    url: https://thecarapi.com/thecarapi.postman_collection.json
  - type: Documentation
    url: https://thecarapi.com/docs
  - type: LLMsTxt
    url: https://thecarapi.com/llms.txt
- aid: thecarapi:thecarapi-filter-facets-api
  name: TheCarApi Filter facets API
  description: >-
    Discover live filter values and counts. Every facet endpoint accepts the search filters, so a facet
    describes whatever slice of inventory you are looking at rather than the whole of it — each dimension
    ignoring only its own filter, so a user can switch brands without the option disappearing. Counts
    and the totals /api/search reports for the same filters cannot disagree. Facet responses cache for
    about 600 seconds, and a filter sidebar can read every flat dimension in one call with /api/facets.
  humanURL: https://thecarapi.com/docs
  baseURL: https://api.thecarapi.com
  tags:
  - Filter facets
  properties:
  - type: OpenAPI
    url: openapi/thecarapi-filter-facets-api-openapi.yml
  - type: PostmanCollection
    url: https://thecarapi.com/thecarapi.postman_collection.json
  - type: Documentation
    url: https://thecarapi.com/docs
  - type: LLMsTxt
    url: https://thecarapi.com/llms.txt
- aid: thecarapi:thecarapi-health-contract-api
  name: TheCarApi Health & contract API
  description: Check service dependencies and inspect the API index.
  humanURL: https://thecarapi.com/docs
  baseURL: https://api.thecarapi.com
  tags:
  - Health & contract
  properties:
  - type: OpenAPI
    url: openapi/thecarapi-health-contract-api-openapi.yml
  - type: PostmanCollection
    url: https://thecarapi.com/thecarapi.postman_collection.json
  - type: Documentation
    url: https://thecarapi.com/docs
  - type: LLMsTxt
    url: https://thecarapi.com/llms.txt
- aid: thecarapi:thecarapi-import-calculator-api
  name: TheCarApi Import calculator API
  description: >-
    Estimate the landed cost of importing a vehicle. These are estimates, not a binding quote.
  humanURL: https://thecarapi.com/docs
  baseURL: https://api.thecarapi.com
  tags:
  - Import calculator
  properties:
  - type: OpenAPI
    url: openapi/thecarapi-import-calculator-api-openapi.yml
  - type: PostmanCollection
    url: https://thecarapi.com/thecarapi.postman_collection.json
  - type: Documentation
    url: https://thecarapi.com/docs
  - type: LLMsTxt
    url: https://thecarapi.com/llms.txt
- aid: thecarapi:thecarapi-market-intelligence-api
  name: TheCarApi Market intelligence API
  description: >-
    Precomputed price snapshots for a brand, model, and year window — one for the Bulgarian retail market,
    one for our own auction inventory. Scope: market. Neither is enabled on a new key by default; ask
    for them. Both are read-only lookups into snapshots built by a pipeline on its own schedule. A 404
    therefore means "no snapshot exists for that window", which is the normal answer for a thin brand/model/year
    combination — not an error to retry. Neither route carries envelope metadata; read X-Request-ID from
    the header.
  humanURL: https://thecarapi.com/docs
  baseURL: https://api.thecarapi.com
  tags:
  - Market Intelligence
  tags_raw:
  - Market intelligence
  properties:
  - type: OpenAPI
    url: openapi/thecarapi-market-intelligence-api-openapi.yml
  - type: PostmanCollection
    url: https://thecarapi.com/thecarapi.postman_collection.json
  - type: Documentation
    url: https://thecarapi.com/docs
  - type: LLMsTxt
    url: https://thecarapi.com/llms.txt
- aid: thecarapi:thecarapi-seo-helpers-api
  name: TheCarApi SEO helpers API
  description: Build popular landing pages and resolve brand/model URL slugs.
  humanURL: https://thecarapi.com/docs
  baseURL: https://api.thecarapi.com
  tags:
  - SEO helpers
  properties:
  - type: OpenAPI
    url: openapi/thecarapi-seo-helpers-api-openapi.yml
  - type: PostmanCollection
    url: https://thecarapi.com/thecarapi.postman_collection.json
  - type: Documentation
    url: https://thecarapi.com/docs
  - type: LLMsTxt
    url: https://thecarapi.com/llms.txt
- aid: thecarapi:thecarapi-top-offers-api
  name: TheCarApi Top offers API
  description: >-
    Live auctions our pipeline judged to be priced below their market reference. Same deals as /api/search?sort=top_offers,
    but each card additionally carries the reference the verdict was made against.
  humanURL: https://thecarapi.com/docs
  baseURL: https://api.thecarapi.com
  tags:
  - Top offers
  properties:
  - type: OpenAPI
    url: openapi/thecarapi-top-offers-api-openapi.yml
  - type: PostmanCollection
    url: https://thecarapi.com/thecarapi.postman_collection.json
  - type: Documentation
    url: https://thecarapi.com/docs
  - type: LLMsTxt
    url: https://thecarapi.com/llms.txt
- aid: thecarapi:thecarapi-vehicle-details-api
  name: TheCarApi Vehicle details API
  description: Fetch a full source payload from cache or, when needed, from the upstream source.
  humanURL: https://thecarapi.com/docs
  baseURL: https://api.thecarapi.com
  tags:
  - Vehicle details
  properties:
  - type: OpenAPI
    url: openapi/thecarapi-vehicle-details-api-openapi.yml
  - type: PostmanCollection
    url: https://thecarapi.com/thecarapi.postman_collection.json
  - type: Documentation
    url: https://thecarapi.com/docs
  - type: LLMsTxt
    url: https://thecarapi.com/llms.txt
- aid: thecarapi:thecarapi-search-and-discovery-api
  name: TheCarApi Search and Discovery API
  description: >-
    Search live auction inventory, then resolve lightweight full-text matches. Ended lots are hidden by
    default; is_active=false / include_ended=true shows them as well as live ones.
  humanURL: https://thecarapi.com/docs
  baseURL: https://api.thecarapi.com
  tags:
  - Search & Discovery
  tags_raw:
  - Search and Discovery
  properties:
  - type: OpenAPI
    url: openapi/thecarapi-search-and-discovery-api-openapi.yml
  - type: PostmanCollection
    url: https://thecarapi.com/thecarapi.postman_collection.json
  - type: Documentation
    url: https://thecarapi.com/docs
  - type: LLMsTxt
    url: https://thecarapi.com/llms.txt
maintainers:
  - FN: TheCarApi Support
    email: api@thecarapi.com
    url: mailto:api@thecarapi.com
generated:
  by: apis.io/add
  model: claude-opus-4-8
  confidence: 95
  at: '2026-09-01T19:53:13.514Z'
common:
- type: CapabilityMap
  url: capabilities/thecarapi-capability-edges.yml
  name: TheCarApi Business Capability Map
- type: Website
  url: https://thecarapi.com/
- type: DomainSecurity
  url: security/thecarapi-domain-security.yml
- type: Authentication
  url: authentication/thecarapi-authentication.yml
- type: OAuthScopes
  url: scopes/thecarapi-scopes.yml
- type: Conventions
  url: conventions/thecarapi-conventions.yml
- type: ErrorCatalog
  url: errors/thecarapi-problem-types.yml
- type: Lifecycle
  url: lifecycle/thecarapi-lifecycle.yml
- type: StatusPage
  url: https://thecarapi.com/status
- type: ChangeLog
  url: https://thecarapi.com/changelog
- type: ChangeLog
  url: changelog/thecarapi-changelog.yml
- type: Plans
  url: plans/thecarapi-plans-pricing.yml
- type: Pricing
  url: https://thecarapi.com/pricing
- type: RateLimits
  url: rate-limits/thecarapi-rate-limits.yml
- type: Conformance
  url: conformance/thecarapi-conformance.yml
- type: Vocabulary
  url: vocabulary/thecarapi-vocabulary.yml
- type: Examples
  url: https://thecarapi.com/docs/code-examples
- type: Examples
  url: examples/thecarapi-examples.yml
- type: DataModel
  url: data-model/thecarapi-data-model.yml
- type: Overlay
  url: overlays/thecarapi-openapi-overlay.yaml
- type: AgentSkill
  url: skills/_index.yml
- type: LLMsTxt
  url: https://thecarapi.com/llms.txt
- type: Postman
  url: https://thecarapi.com/thecarapi.postman_collection.json
- type: DeveloperPortal
  url: https://thecarapi.com/docs
- type: Documentation
  url: https://thecarapi.com/docs
- type: GettingStarted
  url: https://thecarapi.com/docs
- type: APIReference
  url: https://thecarapi.com/docs/thecarapi-api-reference.md
- type: Support
  url: https://thecarapi.com/contact
- type: Blog
  url: https://thecarapi.com/blog
- type: TermsOfService
  url: https://thecarapi.com/terms
- type: PrivacyPolicy
  url: https://thecarapi.com/privacy
x-enrichment:
  date: '2026-09-02'
  status: enriched
  artifacts_added: 0
  pass: local-v1
