# Subito.it Auto Dealer Listings

Search one dealer current listings with the same filters, sorting and offset pagination as search. The dealer user id is resolved through the shop profile. Shop 46788 (AUTO D. S.A.S.) carries 6 ads.

- **Documentation:** [https://scrappa.co/docs/subito-motori-api/subito_motori_dealer_listings](https://scrappa.co/docs/subito-motori-api/subito_motori_dealer_listings)
- **API group:** Subito.it Auto API
- **Endpoint:** `GET https://scrappa.co/api/subito-motori/dealers/{shopId}/listings`

## 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 |
| --- | --- | --- | --- |
| `shopId` | integer | Yes | Shop id from dealer search, e.g. 46788. |
| `uid` | string | No | Optional explicit shop user id; skips the profile lookup when given. |
| `q` | string | No | Optional free text search within the dealer inventory. |
| `sort` | string | No | datedesc, relevance, priceasc or pricedesc. |
| `lim` | integer | No | Listings per page, 1-100. Defaults to 20. |
| `start` | integer | No | Zero-based result offset. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/subito-motori/dealers/{shopId}/listings?shopId=46788&lim=20"
```

## Example response

```json
{
    "success": true,
    "data": {
        "count_all": 6,
        "lines": 6,
        "start": 20,
        "has_more": false,
        "ads": [
            {
                "urn": "id:ad:1dee1017-23f7-4f79-a4ca-ebf584d0e26b:list:664155445",
                "title": "Nissan Patrol GR 2.8 TD",
                "price": {
                    "amount": 13000,
                    "currency": "EUR"
                }
            }
        ]
    },
    "meta": {
        "endpoint_family": "dealer_listings"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A public parameter or range is invalid. This response is not billable. |
| 503 | Service Unavailable | The service could not obtain a complete result. This response is not billable. |

## 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)