> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get listing details

> Full AutoScout24 vehicle specifications, equipment, photos, pricing and public seller contacts.

**Credits:** 10 per successful listing detail. Removed/missing listings and failed requests are unbilled. Cache hits can cost zero; use `X-Credits-Used` for the actual charge.

Supply exactly one `url` or `listing_id` from [vehicle search](https://docs.scrapebadger.com/api-reference/endpoint/autoscout24/search.md). A full HTTPS listing URL determines its supported market. A UUID without `market` defaults to Germany (`de`); an explicit market must match the URL host. Use de, at, be, es, fr, it, lu or nl. Swiss listings use a separate platform and are unsupported.

```bash theme={null}
curl --get 'https://scrapebadger.com/v1/autoscout24/listing' \
  --data-urlencode 'url=LISTING_URL_FROM_SEARCH' \
  -H 'X-API-Key: YOUR_API_KEY'
```

```bash CLI theme={null}
scrapebadger autoscout24 listing --url LISTING_URL_FROM_SEARCH
scrapebadger autoscout24 listing --listing-id UUID --market it
```

The hosted MCP tool is `autoscout24_get_listing`. Python: `await client.autoscout24.get_listing(url=listing_url)`. Node: `await client.autoscout24.getListing({url: listingUrl})`.

## Response

The envelope contains `market`, `source_url`, `listing` and `latency_ms`. The listing includes identity/title/canonical URL, readable description and source description HTML; numeric price/currency/mileage/power, month-precision registration, make/model/variant/version and basic specifications.

`vehicle` retains complete useful native specifications and `rawData`, including taxonomy, drivetrain, body/interior, dimensions, condition, damage, roadworthiness, previous owners, maintenance, service and inspection, plus optional energy/WLTP/battery and environmental fields. Values absent upstream remain null or empty; an absent accident flag does not mean accident-free. Preserve raw/formatted values, units and fallback measurement basis.

`equipment` preserves source groups and entries, including localized labels. Native equipment `id` can itself be a localized label; stable raw codes, when supplied, remain in `vehicle.rawData.equipment`. `images` includes the full native photo collection. `header_image` can be a different responsive size of the first photo. Optional media includes YouTube, 360 viewer, vehicle report and partner links.

`prices` preserves public/dealer/suggested prices, gross/net amounts, VAT/deductibility, negotiation/on-request/final-price flags and median/evaluation ranges. Source bands are preserved even when their boundaries overlap or appear inconsistent. These are source asking-price assessments, not a reconstructed price history.

`seller`, `ratings` and `location` preserve publicly supplied company/contact names, typed phone entries, dealer links/logo, rating/count/category/recommendation data, address and coordinates. `whatsapp_number`, leasing, warranty, financing/insurance, availability, delivery, seals and online purchase are optional. No buyer message, contact action or private account access is performed. Host locale and seller location are independent.

`first_registration` has month precision (`YYYY-MM`); source first-of-month placeholders do not establish an actual registration day. Date-only availability retains its date without a fabricated Unix instant. Actual created/availability timestamps have ISO UTC and Unix pairs (`created_at/created_utc`, `available_at/available_utc`).

## Errors and handoff

The returned UUID must match the requested listing. Removed or missing source listings return an unbilled `404`; malformed locators, unsupported hosts, ambiguous URL plus UUID and market mismatches return `422`. Blocked, incomplete or inconsistent source data returns an unbilled `503`, never a successful empty object. Retain `X-Request-ID` for diagnostics.

Detail returns one entity and has no pagination or search filters. Search pagination remains pages 1–200 using `next_page`. Listing content and availability can change after a search result was fetched. See [credits and pricing](https://docs.scrapebadger.com/credits-and-pricing.md) for current plan prices.


## OpenAPI

````yaml GET /v1/autoscout24/listing
openapi: 3.1.0
info:
  title: AutoScout24 API
  version: 0.1.0
servers:
  - url: https://scrapebadger.com
security:
  - ApiKeyAuth: []
paths:
  /v1/autoscout24/listing:
    get:
      tags:
        - AutoScout24
      summary: Get listing
      description: >-
        Full public vehicle specifications, equipment, photos, price and seller
        data.


        Exactly one of url or listing_id is required. Supported markets match

        /markets. Successful detail costs 10 credits; removed or missing
        listings

        return an unbilled 404. Invalid inputs return 422 and source failures
        503.
      operationId: autoscout24_get_listing
      parameters:
        - name: url
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 2048
              - type: 'null'
            description: >-
              Full HTTPS listing URL from search results. Supply url or
              listing_id, not both.
            title: Url
          description: >-
            Full HTTPS listing URL from search results. Supply url or
            listing_id, not both.
        - name: listing_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                minLength: 36
                maxLength: 36
              - type: 'null'
            description: Listing UUID from search results; requires no SEO slug.
            title: Listing Id
          description: Listing UUID from search results; requires no SEO slug.
        - name: market
          in: query
          required: false
          schema:
            anyOf:
              - enum:
                  - de
                  - at
                  - be
                  - es
                  - fr
                  - it
                  - lu
                  - nl
                type: string
              - type: 'null'
            description: >-
              Inferred from URL, otherwise de. Explicit market must match the
              URL host.
            title: Market
          description: >-
            Inferred from URL, otherwise de. Explicit market must match the URL
            host.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AutoScout24ListingResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    AutoScout24ListingResponse:
      properties:
        market:
          type: string
          title: Market
        source_url:
          type: string
          title: Source Url
        listing:
          $ref: '#/components/schemas/AutoScout24ListingDetail'
        latency_ms:
          type: integer
          title: Latency Ms
      type: object
      required:
        - market
        - source_url
        - listing
        - latency_ms
      title: AutoScout24ListingResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    AutoScout24ListingDetail:
      properties:
        id:
          type: string
          title: Id
        title:
          type: string
          title: Title
        url:
          type: string
          title: Url
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        description_html:
          anyOf:
            - type: string
            - type: 'null'
          title: Description Html
        status:
          anyOf:
            - type: string
            - type: 'null'
          title: Status
        currency:
          type: string
          title: Currency
          default: EUR
        price:
          anyOf:
            - type: number
            - type: 'null'
          title: Price
        price_formatted:
          anyOf:
            - type: string
            - type: 'null'
          title: Price Formatted
        net_price:
          anyOf:
            - type: number
            - type: 'null'
          title: Net Price
        vat_rate:
          anyOf:
            - type: number
            - type: 'null'
          title: Vat Rate
        is_vat_deductible:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Vat Deductible
        is_negotiable:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Negotiable
        is_price_on_request:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Price On Request
        is_final_price:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Final Price
        median_price:
          anyOf:
            - type: number
            - type: 'null'
          title: Median Price
        price_evaluation:
          anyOf:
            - type: integer
            - type: 'null'
          title: Price Evaluation
        price_details:
          additionalProperties: true
          type: object
          title: Price Details
        prices:
          additionalProperties: true
          type: object
          title: Prices
        super_deal:
          additionalProperties: true
          type: object
          title: Super Deal
        make:
          anyOf:
            - type: string
            - type: 'null'
          title: Make
        model:
          anyOf:
            - type: string
            - type: 'null'
          title: Model
        variant:
          anyOf:
            - type: string
            - type: 'null'
          title: Variant
        version:
          anyOf:
            - type: string
            - type: 'null'
          title: Version
        mileage_km:
          anyOf:
            - type: integer
            - type: 'null'
          title: Mileage Km
        first_registration:
          anyOf:
            - type: string
            - type: 'null'
          title: First Registration
          description: Month precision, YYYY-MM; no invented day or timestamp.
        registration_year:
          anyOf:
            - type: integer
            - type: 'null'
          title: Registration Year
        registration_month:
          anyOf:
            - type: integer
            - type: 'null'
          title: Registration Month
        power_kw:
          anyOf:
            - type: number
            - type: 'null'
          title: Power Kw
        power_hp:
          anyOf:
            - type: number
            - type: 'null'
          title: Power Hp
        displacement_cc:
          anyOf:
            - type: integer
            - type: 'null'
          title: Displacement Cc
        transmission:
          anyOf:
            - type: string
            - type: 'null'
          title: Transmission
        body_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Body Type
        fuel:
          anyOf:
            - type: string
            - type: 'null'
          title: Fuel
        fuel_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Fuel Type
        seats:
          anyOf:
            - type: integer
            - type: 'null'
          title: Seats
        doors:
          anyOf:
            - type: integer
            - type: 'null'
          title: Doors
        vehicle:
          additionalProperties: true
          type: object
          title: Vehicle
          description: >-
            Complete useful native specifications, including rawData, energy and
            history.
        equipment:
          additionalProperties:
            items: {}
            type: array
          type: object
          title: Equipment
        images:
          items:
            type: string
          type: array
          title: Images
        header_image:
          anyOf:
            - type: string
            - type: 'null'
          title: Header Image
        image_alt_text:
          anyOf:
            - type: string
            - type: 'null'
          title: Image Alt Text
        is_cover_image_placeholder:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Cover Image Placeholder
        cover_image_attractiveness:
          anyOf:
            - type: number
            - type: 'null'
          title: Cover Image Attractiveness
        youtube_link:
          anyOf:
            - type: string
            - type: 'null'
          title: Youtube Link
        twinner_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Twinner Url
        has_360_view:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Has 360 View
        three_sixty:
          title: Three Sixty
        vehicle_report:
          title: Vehicle Report
        partner_integrations:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Partner Integrations
        seller:
          additionalProperties: true
          type: object
          title: Seller
        location:
          additionalProperties: true
          type: object
          title: Location
        ratings:
          additionalProperties: true
          type: object
          title: Ratings
        rating:
          anyOf:
            - type: number
            - type: 'null'
          title: Rating
        rating_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Rating Count
        recommend_percentage:
          anyOf:
            - type: number
            - type: 'null'
          title: Recommend Percentage
        whatsapp_number:
          anyOf:
            - type: string
            - type: 'null'
          title: Whatsapp Number
        identifier:
          additionalProperties: true
          type: object
          title: Identifier
        article_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Article Type
        vehicle_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Vehicle Type
        is_new:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is New
        is_deliverable:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Deliverable
        availability:
          additionalProperties: true
          type: object
          title: Availability
        available_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Available At
        available_utc:
          anyOf:
            - type: number
            - type: 'null'
          title: Available Utc
        created_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Created At
        created_utc:
          anyOf:
            - type: number
            - type: 'null'
          title: Created Utc
        leasing_details:
          title: Leasing Details
        warranty:
          title: Warranty
        has_warranty:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Has Warranty
        financing_flags:
          title: Financing Flags
        financing_and_insurance:
          title: Financing And Insurance
        online_purchase:
          title: Online Purchase
        seals:
          items: {}
          type: array
          title: Seals
        special_conditions:
          items: {}
          type: array
          title: Special Conditions
        search_result_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Search Result Type
        ad_tier:
          anyOf:
            - type: string
            - type: 'null'
          title: Ad Tier
        applied_ad_tier:
          anyOf:
            - type: string
            - type: 'null'
          title: Applied Ad Tier
        has_premium_listing_treatment:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Has Premium Listing Treatment
        is_trending:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Trending
        is_listing_boost:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Listing Boost
        statistics:
          additionalProperties: true
          type: object
          title: Statistics
        interaction_statistics:
          additionalProperties: true
          type: object
          title: Interaction Statistics
      type: object
      required:
        - id
        - title
        - url
      title: AutoScout24ListingDetail
      description: >-
        Full public listing with normalized values and native specifications.


        Native objects preserve optional equipment, energy, history and
        commercial

        fields. Missing seller-entered values remain unknown, rather than false.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.