Finder APIporsche.finder.com ↗
Search pre-owned Porsche 911 listings from finder.porsche.com. Filter by year, mileage, exterior and interior color. Returns pricing, specs, dealer info, and images.
What is the Finder API?
The Porsche Finder API provides access to pre-owned Porsche 911 listings from the official finder.porsche.com catalog through a single endpoint, search_911_carrera, which returns up to 15 listings per page with over a dozen fields per listing including pricing, vehicle specs, dealer information, and images. Filters for production year range, maximum mileage, and exterior and interior color groups let you narrow results precisely without post-processing.
curl -X GET 'https://api.parse.bot/scraper/59f3efc1-78e7-4437-b5fc-4d6d43aeae48/search_911_carrera?production_year_to=2024&production_year_from=2022&exterior_color_groups=ext-black' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace porsche-finder-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Porsche Finder SDK — search pre-owned 911 listings with filters."""
from parse_apis.porsche_finder_com_api import PorscheFinder, ExteriorColorGroup, InteriorColorGroup, InputFormatInvalid
client = PorscheFinder()
# Browse recent low-mileage 911s in black, capped at 5 results.
for listing in client.listings.search(
exterior_color=ExteriorColorGroup.EXT_BLACK,
mileage_to="15000",
limit=5,
):
print(f"{listing.title} ({listing.model_year}) — ${listing.price:,.0f}, {listing.mileage_value} mi")
print(f" VIN: {listing.vin} Dealer: {listing.dealer_name}, {listing.dealer_location}")
# Narrow further: 2022-2024 models with a red interior; take the first hit.
try:
hit = client.listings.search(
production_year_from="2022",
production_year_to="2024",
interior_color=InteriorColorGroup.INT_RED,
limit=1,
).first()
except InputFormatInvalid as e:
# Raised when a filter value has an invalid format (e.g. non-numeric mileage).
print(f"Bad filter input: {e.message}")
hit = None
if hit is not None:
print(f"\nFirst red-interior match: {hit.title}, {hit.exterior_color}")
print(f" {hit.transmission}, {hit.drivetrain}, warranty {hit.warranty_months} mo")
print(f" Details: {hit.details_url}")
print("\nexercised: listings.search")
Search pre-owned Porsche 911 listings with optional filters for production year range, maximum mileage, maximum price, exterior color group, and interior color group. Returns paginated results with 15 listings per page. Each listing includes pricing, vehicle specs, dealer info, and images. Results are sorted by the site's recommended order. Pagination is controlled by the page parameter; omitting it returns page 1.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. Each page returns up to 15 listings. |
| price_to | string | Maximum price in USD, e.g. '150000'. Omit for no price cap. |
| mileage_to | string | Maximum mileage in miles, e.g. '30000'. Omit for no mileage cap. |
| production_year_to | string | Maximum production year filter, e.g. '2024'. Omit for no upper year bound. |
| production_year_from | string | Minimum production year filter, e.g. '2020'. Omit for no lower year bound. |
| exterior_color_groups | string | Exterior color group filter. Omit for all colors. |
| interior_color_groups | string | Interior color group filter. Omit for all colors. |
{
"type": "object",
"fields": {
"listings": "Array of pre-owned 911 listing objects",
"active_page": "Current page number",
"total_pages": "Total number of available pages"
},
"sample": {
"data": {
"listings": [
{
"id": "V4N5K2",
"vin": "WP0BA2A91RS228105",
"model": "992 I",
"price": 182220,
"title": "911 Targa 4",
"body_type": "Targa",
"condition": "preowned",
"image_url": "https://images.finder.porsche.com/5f494776-0c2c-47ce-8525-e3ca4cb1f4b2/960",
"drivetrain": "ALL_WHEEL_DRIVE",
"model_year": 2024,
"dealer_name": "Porsche Gold Coast",
"details_url": "https://finder.porsche.com/us/en-US/details/porsche-911-targa-4-preowned-V4N5K2",
"engine_type": "PETROL",
"mileage_unit": "SMI",
"transmission": "PDK (Automatic)",
"mileage_value": 3939,
"exterior_color": "Jet Black Metallic",
"interior_color": "Leather Interior In Black/bordeaux Red",
"model_category": "911 Targa 4",
"price_currency": "USD",
"dealer_location": "Jericho, NY, 11753",
"warranty_months": 24,
"listing_url_slug": "porsche-911-targa-4-preowned-V4N5K2"
}
],
"active_page": 1,
"total_pages": 7
},
"status": "success"
}
}About the Finder API
What the API Returns
The search_911_carrera endpoint returns paginated arrays of pre-owned Porsche 911 listings sourced from finder.porsche.com. Each response includes listings, active_page, and total_pages, giving you the data needed to walk through the full result set. Individual listing objects contain pricing details, vehicle specifications, dealer contact information, and image URLs.
Filtering Options
You can narrow results using any combination of the available query parameters: production_year_from and production_year_to define a model-year window (e.g., 2020 to 2024); mileage_to sets a maximum odometer cap in miles; exterior_color_groups and interior_color_groups filter by color group. All parameters are optional — omitting them returns the full unfiltered inventory across all available 911 Carrera listings.
Pagination Behavior
Each page returns a fixed 15 listings. The total_pages field in every response tells you how many pages exist for a given filter combination, and active_page confirms which page you are currently viewing. To retrieve all matching listings, increment the page parameter from 1 through total_pages.
Source Coverage
The API covers only the Porsche 911 Carrera model line as listed on the official Porsche Finder. Listings reflect pre-owned vehicles; new inventory is not included. Coverage is limited to what finder.porsche.com publishes, including vehicles across the dealer network that participates in that platform.
The Finder API is a managed, monitored endpoint for porsche.finder.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when porsche.finder.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 porsche.finder.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 price-tracking tool that monitors Porsche 911 asking prices over time using the pricing fields returned per listing.
- Create a color-availability dashboard by querying
exterior_color_groupsandinterior_color_groupsfilters to map supply by color combination. - Aggregate dealer inventory data from the dealer info fields to compare 911 stock across geographic regions.
- Filter low-mileage 911 listings using
mileage_toto surface certified pre-owned candidates below a set threshold. - Generate year-over-year depreciation estimates by combining
production_year_from/production_year_tofilters with returned pricing data. - Power a vehicle comparison tool by pulling specs and images from multiple paginated result pages for side-by-side display.
| 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.
Does Porsche have an official developer API for finder.porsche.com?+
What vehicle data does each listing object include?+
search_911_carrera includes pricing, vehicle specifications (such as production year and mileage), exterior and interior color details, dealer information, and image URLs. The listing fields reflect what finder.porsche.com exposes for each vehicle in its pre-owned catalog.Does the API cover Porsche models other than the 911 Carrera?+
Can I filter by price range or specific 911 variants like the Targa or Turbo?+
How many listings can I retrieve per request, and is there a limit to total pages?+
search_911_carrera returns up to 15 listings. The total_pages field in the response reflects how many pages exist for the active filter combination. There is no fixed cap on total pages — it depends on live inventory at the time of the request.