Porsche APIfinder.porsche.com ↗
Search Porsche dealer listings, retrieve full specs, equipment lists, pricing, and Carfax history links via the Porsche Finder API.
What is the Porsche API?
The Porsche Finder API provides 4 endpoints covering dealer inventory from finder.porsche.com, including vehicle search, full listing details, filter hit counts, and Carfax history report links. The search_listings endpoint returns paginated summaries with price, mileage, color, transmission, seller info, and image URLs, while get_listing_detail exposes VIN, equipment categories, gallery images, warranty data, and technical specifications for any individual listing.
curl -X GET 'https://api.parse.bot/scraper/e980225b-a3e4-4a14-a553-9cee1d8bfa1b/search_listings?lat=40.7128&lng=-74.0060&model=911&radius=100&location=New+York&condition=new' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for Porsche vehicles by model, category, location, condition and sort order. Returns one page of listing summaries (the site serves a fixed 15 listings per page; there is no per-page size control) with pricing, mileage, color, drivetrain, seller info, and images. Each result includes id and listing_url_slug for drilling into full details via get_listing_detail and get_vehicle_history_report. Pagination is caller-controlled through the page input (1-based; omitted means page 1); active_page and total_pages are reported by the source and has_more tells whether a further page exists. Requesting a page beyond total_pages is a valid empty result: listings is [] and the source reports active_page 0 and total_pages 0. A non-integer or zero/negative page is rejected before any request. One round trip per call.
| Param | Type | Description |
|---|---|---|
| lat | string | Latitude of search center in decimal degrees. |
| lng | string | Longitude of search center in decimal degrees. |
| page | integer | 1-based results page number. Each page holds 15 listings; walk pages until has_more is false or active_page reaches total_pages. |
| sort | string | Sort order for results. Empty string uses the site's default (recommended) ordering. Values offered by the site's sort control: recommended_desc, closest, newest, price_asc, price_desc, mileage_asc, modelYear_asc, modelYear_desc. |
| model | string | Model series to search within. |
| radius | string | Search radius in miles from the search center. |
| category | string | Model category slug to narrow results within a model series (e.g., '911-gt3', '911-turbo-s-coupe', '911-carrera-gts-coupe'). Empty string returns all categories. |
| location | string | Location name used as the search center for geographic filtering. |
| condition | string | Vehicle condition filter: 'new', 'preowned', 'porsche_approved' (certified pre-owned), or empty string for all conditions. |
{
"type": "object",
"fields": {
"page": "integer - the page number that was requested",
"total": "integer - number of listings on this page (at most 15)",
"has_more": "boolean - true when a further page exists after active_page",
"listings": "array of listing summary objects with id, listing_url_slug, title, model, price, mileage, color, transmission, seller, images",
"active_page": "integer - current page number as reported by the source (0 when the requested page is beyond the last page)",
"total_pages": "integer - total pages available as reported by the source (0 when the requested page is beyond the last page)"
},
"sample": {
"data": {
"page": 2,
"total": 15,
"has_more": true,
"listings": [
{
"id": "OG90V9",
"url": "https://finder.porsche.com/us/en-US/details/porsche-911-carrera-preowned-OG90V9",
"vin": "WP0AA2A91MS205721",
"color": "Aventurine Green Metallic",
"model": "992 I",
"price": 122888,
"title": "911 Carrera",
"images": [
"https://images.finder.porsche.com/183b687a-494b-5fe9-a00b-de7605a9d283/960"
],
"seller": {
"name": "Porsche Brooklyn",
"address": "3906 2nd. Avenue \n Brooklyn, NY, 11232",
"seller_id": "1500001908",
"website_url": null,
"formatted_city": "Brooklyn, NY, 11232"
},
"currency": "USD",
"video_id": null,
"body_type": "Coupe",
"condition": "preowned",
"weight_kg": 1505,
"dimensions": {
"width_mm": 2024,
"height_mm": 1298,
"length_mm": 4519
},
"drivetrain": "REAR_WHEEL_DRIVE",
"image_type": "rendered",
"model_year": 2021,
"description": {
"title": "2021 Porsche 911 Carrera",
"subtitle": "Certified Pre-Owned",
"characteristics": [
"Aventurine Green Metallic",
"Black",
"Gasoline"
],
"formatted_price": null
},
"engine_type": "PETROL",
"mileage_unit": "SMI",
"transmission": "PDK (Automatic)",
"accident_free": null,
"interior_name": "Leather Interior in Black with Chalk Stitching and Checkered Sport-Tex Seat Centers",
"mileage_value": 41826,
"interior_color": "Leather Interior In Black With Chalk Stitching And Checkered Sport-tex Seat Centers",
"model_category": "911 Carrera",
"production_date": null,
"warranty_months": 24,
"listing_url_slug": "porsche-911-carrera-preowned-OG90V9",
"first_registration": null,
"is_porsche_approved": true,
"number_of_previous_owners": null
}
],
"active_page": 2,
"total_pages": 16
},
"status": "success"
}
}About the Porsche API
Search and Filter Inventory
The search_listings endpoint accepts geographic inputs (lat, lng, radius, location) alongside model filters (model, category, condition) to return paginated Porsche dealer listings. Each item in the listings array includes a listing_url_slug needed for drilling into full detail. The model parameter accepts values like 911, taycan, cayenne, or macan; the category parameter narrows further to sub-models such as 911-gt3 or 911-turbo-s-coupe. Pagination is tracked via active_page and total_pages.
Full Listing Detail and Equipment
get_listing_detail takes a listing_slug (e.g., porsche-911-turbo-s-my23-preowned-7078KL) and returns a detailed record including vin, price, color, model generation code, and a seller object with dealer name and address. The equipment field is organized into important, special, and standard categories with descriptions. The gallery object includes an image count and categorized image list. A warranty object covers warranty type, duration, and description.
Filter Counts for UI Building
get_filter_counts returns available filter options and their hit counts for a given search configuration — including bodyType, condition, drivetrain, transmission, exteriorColorGroups, interiorColorGroups, modelCategory, and modelGeneration. This endpoint is useful for building dynamic filter interfaces that reflect what inventory actually exists for a given model and location.
Vehicle History
get_vehicle_history_report accepts a listing_id and returns a report_url pointing to the Carfax page for that vehicle. New vehicles without history return null for report_url. The listing ID is surfaced in search_listings results as the id field.
The Porsche API is a managed, monitored endpoint for finder.porsche.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when finder.porsche.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official finder.porsche.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a Porsche inventory aggregator filtered by model category (e.g., 911-gt3) and geographic radius
- Display detailed spec sheets for individual listings using VIN, equipment lists, and technical data from get_listing_detail
- Power a dynamic filter UI using hit counts from get_filter_counts for drivetrain, color, and transmission options
- Attach Carfax history report links to pre-owned listing pages using get_vehicle_history_report
- Track pre-owned 911 pricing across dealer locations by combining search_listings with lat/lng and condition filters
- Compare standard vs. special equipment across multiple Taycan or Macan listings using the equipment object
- Identify dealer inventory density by region using seller city and postal_code fields from listing results
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.