# DriveDrop — Full API & Content Reference

> DriveDrop is an Italian service for booking parking spaces in advance near city centres, airports, train stations, and ports. This document provides full technical details for AI agents and automated systems.

## Service Overview

- **Website**: https://www.drivedrop.it
- **API base**: https://api.drivedrop.it
- **App**: iOS (App Store ID: 6737046738) and Android (Google Play)
- **Contact**: info@drivedrop.it

DriveDrop aggregates parking lots across Italy. Users search by location, select a parking lot, and book in advance at a fixed price. Cancellation is free up to a few hours before arrival.

## Public API Endpoints

### Search parking lots by location

```
GET https://api.drivedrop.it/api/parkings/search?lat={lat}&lng={lng}&radius={radius}&from={from}&to={to}
```

**This is the primary endpoint for finding parking near a location.** Returns parking lots within the specified radius, filtered by availability for the requested time window.

Query parameters:
- `lat` (number, required) — latitude of the target location
- `lng` (number, required) — longitude of the target location
- `radius` (number, optional) — search radius in meters
- `from` (number, optional) — booking start time (Unix timestamp)
- `to` (number, optional) — booking end time (Unix timestamp)

Response:
- `items` (array) — matching parking lots (see fields below)
- `count` (number) — number of results

### List all parking lots

```
GET https://api.drivedrop.it/api/parkings?limit={limit}&cursor={cursor}
```

Returns the full catalogue. Use `limit=200` to fetch all in one call. Use the `next` cursor for pagination.

Query parameters:
- `limit` (number, optional) — max items to return (default 20, max 200)
- `cursor` (string, optional) — pagination cursor from previous response

Response:
- `items` (array) — parking lots (see fields below)
- `count` (number) — items in this page
- `limit` (number) — limit used
- `next` (string, optional) — cursor for next page

### Parking lot item fields (search and list)

- `id` (string) — unique identifier
- `name` (string) — parking lot name
- `address` (string) — street address
- `point` ([longitude, latitude]) — geographic coordinates
- `max_height` (number) — maximum vehicle height in meters
- `images` (string[]) — array of image URLs
- `active` (boolean) — whether the parking is currently active
- `available` (boolean) — whether bookings are open
- `type` ("city" | "airport") — parking type
- `price_h` (number | null) — hourly price in EUR
- `price_d` (number | null) — daily price in EUR
- `plateRequired` (boolean, optional) — whether licence plate is required at entry

### Get parking lot by ID

```
GET https://api.drivedrop.it/api/parkings/{id}
```

Returns full details for a single parking lot. Same fields as above plus:
- `calendar` — weekly opening hours and exceptions
- `email` (string, optional) — contact email

## Destination Pages

Destination landing pages are available at:

```
https://www.drivedrop.it/destinations/{slug}
```

Each page exposes:
- JSON-LD `WebPage` structured data
- JSON-LD `FAQPage` structured data (when FAQs are available)
- Human-readable content about parking in that city/location

### City destinations

| Slug | City |
|------|------|
| parcheggio-roma | Rome |
| parcheggio-milano | Milan |
| parcheggio-firenze | Florence |
| parcheggio-bologna | Bologna |
| parcheggio-napoli | Naples |
| parcheggio-genova | Genoa |
| parcheggio-verona | Verona |
| parcheggio-venezia | Venice |
| parcheggio-torino | Turin |
| parcheggio-bari | Bari |
| parcheggio-siena | Siena |
| parcheggio-como | Como |
| parcheggio-salerno | Salerno |
| parcheggio-sorrento | Sorrento |

### Airport destinations (partial list)

| Slug | Airport |
|------|---------|
| parcheggio-aeroporto-roma-fiumicino | Rome Fiumicino |
| parcheggio-aeroporto-roma-ciampino | Rome Ciampino |
| parcheggio-aeroporto-milano-malpensa | Milan Malpensa |
| parcheggio-aeroporto-milano-linate | Milan Linate |
| parcheggio-aeroporto-milano-orio-al-serio | Milan Orio al Serio |
| parcheggio-aeroporto-firenze-peretola-vespucci | Florence Peretola |
| parcheggio-aeroporto-napoli-capodichino | Naples Capodichino |
| parcheggio-aeroporto-torino-caselle | Turin Caselle |

## Structured Data

All parking detail pages (`/dropper/{slug}`) expose JSON-LD `ParkingFacility` (schema.org) with:
- Name, address, coordinates
- Image (when available)
- Booking URL

All destination pages expose JSON-LD `WebPage` and `FAQPage` (schema.org).

## Sitemap

Full sitemap at: https://www.drivedrop.it/sitemap.xml

Includes all active parking lot pages (priority 0.8, weekly) and destination pages (priority 0.9, monthly).

## API Catalog

Machine-readable API catalog at: https://www.drivedrop.it/.well-known/api-catalog (application/linkset+json, RFC 9727)