# Otomoto Dealer API Documentation

Scrappa's `GET /api/otomoto/dealer` endpoint returns a Polish vehicle dealer's public profile and inventory categories as JSON.

## What the response contains

The dealer carries `id`, `name`, `business_name`, `subdomain`, `url`, `address`, `opening_hours`, `logo`, `cover_image`, `benefits`, `dealer_title_description` and the `inventory` block with its `categories`.

## Related Otomoto endpoints

- `GET /api/otomoto/search` — find a listing whose `seller.url` carries the dealer subdomain
- `GET /api/otomoto/listing` — the listing whose seller block names the dealer

- **Documentation:** [https://scrappa.co/docs/otomoto-api/otomoto_dealer](https://scrappa.co/docs/otomoto-api/otomoto_dealer)
- **API group:** Otomoto API
- **Endpoint:** `GET https://scrappa.co/api/otomoto/dealer`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `subdomain` | string | Yes | Dealer subdomain from a listing's seller.url, e.g. wincars. |
| `url` | string | No | Full dealer inventory URL. Alternative to subdomain. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/otomoto/dealer?subdomain=wincars"
```

## Example response

```json
{
    "success": true,
    "data": {
        "dealer": {
            "id": "16260395",
            "name": "WINCARS",
            "business_name": "WINCARS",
            "subdomain": "wincars",
            "url": "https://wincars.otomoto.pl/inventory",
            "address": "UL. ALEJA SOLIDARNO\u015aCI 163 , U010",
            "opening_hours": [
                {
                    "day": 0,
                    "is_open": true,
                    "open_at": "11:00",
                    "close_at": "17:00"
                }
            ],
            "logo": "https://ireland.apollo.olxcdn.com/v1/files/eyJmbiI6Im1nOG5xdmFrazBkNjItT1RPTU9UT1BMIn0.nsmYRtOP6T5YA4RtnZ6-qj3-7k3KD7rL5y7XSHUsH4w/image",
            "cover_image": "https://ireland.apollo.olxcdn.com/v1/files/40ne5k9fassd1-OTOMOTOPL/image",
            "benefits": [
                "DEALER_IDENTITY_ELEMENTS",
                "BUSINESS_SITE_PRO"
            ],
            "dealer_title_description": "WINCARS - oficjalny importer samochod\u00f3w z USA i Kanady.",
            "inventory": {
                "categories": [
                    {
                        "value": "29",
                        "label": "Osobowe"
                    }
                ]
            }
        }
    },
    "meta": {
        "endpoint_family": "dealer"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Error | No dealer carries that subdomain. Not billed. |
|  | Error | Otomoto could not be reached. Not billed. |
|  | Error | The upstream service is temporarily unavailable. Please retry shortly. |

## Frequently asked questions

### Where do I get a dealer subdomain?

From the `seller.url` of any listing returned by the Otomoto search or listing endpoint.

### Do I get the dealer phone number?

No. Dealer contact details are removed before the response leaves the service.

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)