donedeal.ie APIdonedeal.ie ↗
Search and filter used car and caravan listings from DoneDeal.ie. Filter by price, mileage, keyword, and section. Returns title, price, year, mileage, and location.
curl -X GET 'https://api.parse.bot/scraper/8ac8f002-e3be-40da-a75e-93e4304da8bd/search_listings?sort=price_asc&limit=5&query=golf§ion=cars' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for used vehicle listings on DoneDeal.ie. Supports filtering by price and mileage ranges, keyword search, sorting, and pagination across cars and caravans sections.
| Param | Type | Description |
|---|---|---|
| sort | string | Sort order for results. Accepted values: 'relevance', 'price_asc', 'price_desc', 'date_desc'. |
| limit | integer | Maximum number of listings to return. |
| query | string | Keyword search term (e.g. 'golf', 'campervan', 'toyota'). |
| section | string | Vehicle section to search in. Accepted values: 'cars', 'caravans'. |
| price_to | integer | Maximum price filter in Euro. |
| mileage_to | integer | Maximum mileage filter in km. |
| price_from | integer | Minimum price filter in Euro. |
| mileage_from | integer | Minimum mileage filter in km. |
{
"type": "object",
"fields": {
"ads": "array of listing objects containing id, title, price, price_in_euro, year, mileage, engine, location, publish_date_relative, publish_date, listing_url, seller_type, dealer_name, seller_info, and images",
"total": "integer count of ads returned"
},
"sample": {
"data": {
"ads": [
{
"id": 41704196,
"year": "2009",
"price": "€2,500",
"title": "Vw Golf",
"engine": "2.0 Diesel",
"images": [
"https://media.donedeal.ie/..."
],
"mileage": 352000,
"location": "Clare",
"dealer_name": null,
"listing_url": "https://www.donedeal.ie/cars-for-sale/vw-golf/41704196",
"seller_info": {
"type": "PRIVATE"
},
"seller_type": "PRIVATE",
"publish_date": "2026-05-14 08:10:55",
"price_in_euro": 2500,
"publish_date_relative": "3 hours"
}
],
"total": 5
},
"status": "success"
}
}About the donedeal.ie API
The DoneDeal.ie API exposes 1 endpoint — search_listings — that returns used vehicle listings from Ireland's DoneDeal marketplace. Each listing object includes up to 9 fields: id, title, price, price_in_euro, year, mileage, engine, location, and publish_date_relative. You can filter results by price range, mileage range, section (cars or caravans), and keyword, or sort by relevance, price, or recency.
What the API Returns
The search_listings endpoint returns an array of listing objects under the ads key, along with a total integer indicating how many ads matched the query. Each listing carries a unique id, a human-readable title, price and price_in_euro fields, year, mileage, engine type, seller location, and publish_date_relative — a relative timestamp like "3 hours ago" useful for gauging listing freshness.
Filtering and Sorting
The endpoint accepts price_from and price_to as integer Euro values to bracket price ranges, and mileage_from / mileage_to in kilometres to narrow by vehicle condition. The section parameter restricts results to either cars or caravans. The query parameter accepts keyword strings such as 'golf', 'campervan', or 'toyota' to filter by make, model, or body type. The sort parameter accepts relevance, price_asc, price_desc, or date_desc, and limit controls how many records come back per request.
Coverage and Scope
The API covers listings from DoneDeal.ie, the primary Irish second-hand vehicle marketplace. The two supported sections are cars and caravans. The response fields reflect publicly visible listing data — price, mileage, engine spec, and seller location — without requiring any user authentication. Listing freshness depends on how recently the original listing was posted or updated on DoneDeal.ie.
- Track daily price changes on used Toyota or Volkswagen listings filtered by
queryandprice_to - Build a mileage-aware car search tool using
mileage_fromandmileage_toto surface low-km vehicles - Aggregate caravan listings for a niche marketplace by setting
sectiontocaravansand sorting bydate_desc - Monitor newly posted listings in a given price bracket using
price_from,price_to, andsort=date_desc - Feed vehicle inventory data into a price comparison dashboard using
price_in_euroandyearfields - Power a regional search tool by filtering listings and parsing the
locationfield from each result
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does DoneDeal.ie have an official developer API?+
What does the `search_listings` endpoint return for each listing?+
ads array includes: id, title, price, price_in_euro, year, mileage, engine, location, and publish_date_relative. The total field at the top level gives the count of matching ads returned in that response.Are vehicle sections beyond `cars` and `caravans` covered — for example, motorbikes, trucks, or vans?+
section parameter supports cars and caravans only. You can fork this API on Parse and revise it to add additional DoneDeal sections such as motorbikes or trucks.Does the API return seller contact details or full listing descriptions?+
How fresh is the listing data?+
publish_date_relative field reflects when the listing was posted or last updated on DoneDeal.ie. There is no guaranteed polling interval, so the data reflects DoneDeal.ie at the time of each API call rather than a cached snapshot.