> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usegoro.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# mobile.de listings

> Car listings from mobile.de, Germany's largest car marketplace, from a search URL or from make, model, price, year, mileage and location filters. Every listing 

Car listings from mobile.de, Germany's largest car marketplace, from a search URL or from make, model, price, year, mileage and location filters. Every listing comes back with price, mileage, first registration, fuel, power, the ad URL, how many photos it has with the photo URLs, and the seller: dealer or private, name, city, rating, review count, how many cars they list, and the phone numbers, website and email the ad shows.

<Note>Use to find car sellers on mobile.de and qualify them in one call: which dealers carry a given make and price band in an area, how big their stock is, and which ads have few or weak photos (numImagesAvailable, imageUrls), the classic lead list for anyone selling dealers photography, detailing, financing or software. Paste a mobile.de search URL in startUrls to reuse any filter the site offers, or use the structured filters. maxResults sets both how many listings come back and what you pay: one billed row per listing, plus a small fixed start fee per call, so batch a whole search into one call instead of many small ones. Use autoscout24.listings for AutoScout24 (Germany and eight other EU markets) and autovit.listings for Romania.</Note>

## Price

**\$0.001770 per result.** That is the rate you pay for each result the call returns, so the total depends on how many it produces.

Billing follows actual usage, so a call that returns fewer results costs less, and a call that costs nothing to serve is free. `discover` and `inspect` also return a ceiling for your specific request, which is a maximum you will never be charged above.

## Input

| Field        | Type                                                                                                                               | Required | Notes                                                                                                                                                                                                                                                |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `make`       | `string`                                                                                                                           |          | Make as mobile.de names it, e.g. Volkswagen, BMW, Mercedes-Benz.                                                                                                                                                                                     |
| `sort`       | `relevance`, `price_asc`, `price_desc`, `mileage_asc`, `mileage_desc`, `registration_desc`, `registration_asc`, `newest`, `oldest` |          | Order of results. newest surfaces freshly posted ads first. Defaults to `"relevance"`.                                                                                                                                                               |
| `model`      | `string`                                                                                                                           |          | Model name, e.g. Golf. Requires make.                                                                                                                                                                                                                |
| `yearMax`    | `integer`                                                                                                                          |          | Latest first registration year.                                                                                                                                                                                                                      |
| `yearMin`    | `integer`                                                                                                                          |          | Earliest first registration year.                                                                                                                                                                                                                    |
| `zipCode`    | `string`                                                                                                                           |          | German postal code to search around. Pair with radiusKm.                                                                                                                                                                                             |
| `priceMax`   | `integer`                                                                                                                          |          | Maximum price in EUR.                                                                                                                                                                                                                                |
| `priceMin`   | `integer`                                                                                                                          |          | Minimum price in EUR.                                                                                                                                                                                                                                |
| `radiusKm`   | `integer`                                                                                                                          |          | Search radius in km around zipCode.                                                                                                                                                                                                                  |
| `condition`  | `array`                                                                                                                            |          | Vehicle conditions to include.                                                                                                                                                                                                                       |
| `startUrls`  | `array`                                                                                                                            |          | mobile.de SEARCH result URLs, copied from the browser (suchen.mobile.de/fahrzeuge/search.html?...). Carries every filter the site offers. When set, the structured filters below are not needed. Search pages only: a single ad URL returns nothing. |
| `maxResults` | `integer`                                                                                                                          |          | How many listings to return, and the number you pay for: one billed row per listing. Capped at 500 per call. Defaults to `50`.                                                                                                                       |
| `mileageMax` | `integer`                                                                                                                          |          | Maximum mileage in km.                                                                                                                                                                                                                               |
| `sellerType` | `DEALER`, `PRIVATE`                                                                                                                |          | Only dealers or only private sellers. Leave out for both.                                                                                                                                                                                            |

<Note>
  Goro forwards your input to the underlying tool unchanged, so any field the
  tool accepts works here even if it is not listed above.
</Note>

## Example

```bash theme={null}
curl -X POST https://api.usegoro.ai/v1/run \
  -H "Authorization: Bearer $GORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"mobilede.listings","input":{"maxResults":3}}'
```

## Response

One row of the response. Values are illustrative.

```json theme={null}
{
  "make": "Volkswagen",
  "model": "Golf",
  "price": 17670,
  "title": "Volkswagen Golf",
  "powerKw": 180,
  "fuelType": "PETROL",
  "imageUrls": [
    "https://m.mobile.de/yams-proxy/img.classistatic.de/api/v1/mo-prod/images/27/27183272-2ab9-4495-897a-776ecfec438a",
    "https://m.mobile.de/yams-proxy/img.classistatic.de/api/v1/mo-prod/images/88/8861e411-ff7d-48f9-8f10-291ae7444f93"
  ],
  "listingId": "dbe907cc1e2583bba37a6688386e884657eb3215768085d29b54bdfc6f124e14",
  "mileageKm": 103319,
  "sellerName": "Example Autohaus GmbH",
  "sellerType": "Dealer",
  "firstSeenAt": null,
  "canonicalUrl": "https://suchen.mobile.de/auto-inserat/volkswagen-golf-vii-2-0-tsi-gti-performance-bmt-led-acc-pdc-neufahrn-b-freising/461430737.html",
  "sellerEmails": [
    "info@example-dealer.de"
  ],
  "sellerPhones": [
    "+49 000 0000000"
  ],
  "sellerRating": 4.4,
  "sellerCountry": "DE",
  "sellerWebsite": "https://www.example-dealer.de",
  "sellerZipCity": null,
  "firstRegistration": "08/2017",
  "sellerReviewCount": 87,
  "numImagesAvailable": 31,
  "sellerListingsCount": null
}
```
