Reef AI: ask for any data. Try it
This page is the markt.de parameter reference. What the data is used for, a real sample and pricing are on markt.de API: what you get →
Classifieds & Second-hand

markt.de API & Scraper: parameters and responses

This is the reference for the 4 markt.de endpoints under /marktde/v1 (search, detail, categories and locations) and their 13 parameters. Each endpoint lists its parameters, required or optional, with allowed values and defaults, and comes with a cURL, Python and JavaScript call; every response uses the same { ok, data, meta, error } envelope.

markt.de API returns live markt.de data as clean JSON for markt.de The primary endpoint, search, returns listings[] — {id, url, title, description, price{amount_eur, currency, formatted, label, negotiable}, location{postal_code, city}, posted….

4 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

Developers reach for it when they need to read second-hand listings, asking prices, seller inventory and country-specific listing ids without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a markt.de scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, detail, categories, locations. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/marktde/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "fahrrad"
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "marktde",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 749.3,
    "record_count": 20,
    "bytes": 153899,
    "cache_hit": false,
    "completeness_pct": 100,
    "stop_reason": "max_pages",
    "locale": "de-DE",
    "promoted_rows": 0,
    "charged_credits": 1,
    "version": "1.0.1",
    "request_id": "ef51bedf833345c2",
    "queue_ms": 1.6,
    "fetched_at": "2026-11-03T17:32:08.845Z"
  },
  "data": {
    "listings": [
      {
        "id": "be06bf14",
        "url": "https://www.markt.de/herrenfahrrad-24-gang/a/be06bf14/",
        "title": "Herrenfahrrad 24 Gang",
        "description": "Biete hier mein gutes gebr.Herrenrad mit 24 Gang Schaltung,nachgerüsteter LED Scheinwerfer,Tachometer und Kilometerzähler,Sattelstütze,sowie Fahrradständer und Schloss",
        "price": {
          "amount_eur": 300,
          "currency": "EUR",
          "formatted": "300 €",
          "label": "VB",
          "negotiable": true
        },
        "location": {
          "postal_code": "48249",
          "city": "Dülmen",
          "formatted": "48249 Dülmen"
        },
        "posted": "Heute, vor 29 Min.",
        "category": "Citybikes",
        "image_url": "https://imagecache.markt.de/AcVGuSyAj_tXKkxgQfcR_3Kd3Tg=/260x340/images_classifieds/bf/f4/0e51-5fd2-47ec-8096-cfe8986b9cc1/image",
        "image_count": 1,
        "seller": {
          "member_tier": "Basis",
          "online": null
        },
        "promoted": false
      },
      {
        "id": "76edca4e",
        "url": "https://www.markt.de/puky-kinderfahrrad-16-zoll/a/76edca4e/",
        "title": "Puky Kinderfahrrad 16 Zoll",
        "description": "Schönes Puky Fahrrad in blau mit Piraten Motiv Das Fahrrad wurde 3 mal ganz kurz gefahren. Also eigentlich Neu",
        "price": {
          "amount_eur": 200,
          "currency": "EUR",
          "formatted": "200 €",
          "label": "Festpreis",
          "negotiable": null
        },
        "location": {
          "postal_code": "85716",
          "city": "Unterschleißheim",
          "formatted": "85716 Unterschleißheim"
        },
        "posted": "Heute, 17:26",
        "category": "Kinderfahrräder",
        "image_url": "https://imagecache.markt.de/13z6uHpDKiPKoPMAfzzmn5qntfM=/260x340/images_classifieds/39/0c/9dcd-df5b-4914-9c10-717bbae59733/image",
        "image_count": 1,
        "seller": {
          "member_tier": "Basis",
          "online": null
        },
        "promoted": false
      },
      {
        "id": "9008b363",
        "url": "https://www.markt.de/ergotec-swell-re-70-stem/a/9008b363/",
        "title": "Ergotec Swell-RE 70 Stem",
        "description": "Neu Der Ergotec Swell-R 70 Ahead ist ein stabiler, winkelverstellbarer, 3D-geschmiedeter Aluminium-Ahead-Vorbau. Er verfügt über eine 4-Schrauben-Lenker-Klemmung und einen 31,8mm Lenker-Klemmdurchmess...",
        "price": {
          "amount_eur": 45,
          "currency": "EUR",
          "formatted": "45 €",
          "label": "VB",
          "negotiable": true
        },
        "location": {
          "postal_code": "53879",
          "city": "Euskirchen",
          "formatted": "53879 Euskirchen"
        },
        "posted": "Heute, 17:00",
        "category": "Mountainbikes",
        "image_url": "https://imagecache.markt.de/CskZ8_1JH9CvBgKkUkTisO1Jctc=/260x340/images_classifieds/94/50/fed4-2162-4ec5-96f3-53b9f669e829/image",
        "image_count": 4,
        "seller": {
          "member_tier": "Basis",
          "online": null
        },
        "promoted": false
      }
    ],
    "total": 9925,
    "page": 1,
    "page_size": 20,
    "has_more": true,
    "next_page": 2,
    "filters_applied": {},
    "canonical_url": "https://www.markt.de/suche/fahrrad/"
  }
}
Actions

What the markt.de API does

ActionDescriptionConcrete use caseKey params
searchSearch markt.de classifieds by keyword and/or category, restricted by place + radius, price range, ad type (private / commercial / wanted), price type (fixed / negotiable / free / swap) and sort order. Returns the ads on one page with markt.de's true total. Every filter is confirmed against markt.de's own canonical URL first: a place or category markt.de does not know is REFUSED instead of being silently dropped (which would return the whole catalogue). A search with no matches returns zero rows and ok:true — that is an answer; one with fewer than 20 matches returns exactly those, never markt.de's unrelated fill-up ads.Price-intelligence teams call search to search markt.de classifieds by keyword and/or category, restricted by place + radius, price r….query, category, location, radius, price_min, ...
detailOne markt.de ad in full, by ad id or ad URL: title, price (with markt.de's own machine price as a cross-check), full description, the seller's attribute table (e.g. Hersteller / Farbe / Zimmer), category breadcrumb, place, posting time and every photo. A removed or unknown ad returns NOT_FOUND.Classifieds aggregators call detail to get one markt.de ad in full, by ad id or ad URL.id, url
categoriesmarkt.de's category tree one level at a time, WITH a live ad count per child — so you can pick a `category` id for search and see how many ads it holds. Called with no parent it returns the ten top-level categories; with a parent id it returns that category's children; with a query it returns how the matches for that keyword split across categories.Resale and arbitrage tools call categories to get markt.de's category tree one level at a time, WITH a live ad count per child.parent, query
locationsGerman place autocomplete straight from markt.de: free text in, markt.de's own spellings out (cities, districts, Landkreise, Bundesländer). Feed a returned name to search's `location` — search only accepts places markt.de knows.Lead-generation teams call locations to get german place autocomplete straight from markt.de.query
Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/marktde/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"fahrrad"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.marktde.search with {"query":"fahrrad"}.
Use cases

Who uses this API and why

  • Price-intelligence teams use markt.de to search markt.de classifieds by keyword and/or category, restricted by place + radius, price r….
  • Classifieds aggregators use markt.de to get one markt.de ad in full, by ad id or ad URL.
  • Resale and arbitrage tools use markt.de to get markt.de's category tree one level at a time, WITH a live ad count per child.
  • Lead-generation teams use markt.de to get german place autocomplete straight from markt.de.
FAQ

Questions developers ask before integrating

What is the markt.de API?

markt.de API is a ReefAPI endpoint group for markt.de It returns live JSON through POST requests under /marktde/v1.

Is the markt.de API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. markt.de calls use the same shared credit balance as every other ReefAPI engine.

Do I need a markt.de login or account?

No login to markt.de is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the markt.de data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the markt.de API use?

markt.de actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call markt.de from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call marktde actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the markt.de API a markt.de scraper?

It is the managed alternative to a DIY markt.de scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same markt.de back as clean JSON.

Why does my markt.de scraper keep getting blocked?

Most markt.de scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.

docs / marktde

markt.de

markt.de

base /marktde/v14 endpoints
post/marktde/v1/detail1 credit

One markt.de ad in full, by ad id or ad URL: title, price (with markt.de's own machine price as a cross-check), full description, the seller's attribute table (e.g. Hersteller / Farbe / Zimmer), category breadcrumb, place, posting time and every photo. A removed or unknown ad returns NOT_FOUND.

ParameterAllowed / rangeDescription
idoptional—The 8-character ad id — the /a/<id>/ part of an ad URL, and the `id` of every search result. detail needs id OR url.
urloptional—Full markt.de ad URL.
Try in playground →
post/marktde/v1/categories1 credit

markt.de's category tree one level at a time, WITH a live ad count per child — so you can pick a `category` id for search and see how many ads it holds. Called with no parent it returns the ten top-level categories; with a parent id it returns that category's children; with a query it returns how the matches for that keyword split across categories.

ParameterAllowed / rangeDescription
parentoptional—Category id whose children to list (from a previous categories call). Omit for the top level.
queryoptional—Optional keyword — the counts then describe how that keyword's matches are distributed over the categories.
Try in playground →
post/marktde/v1/locations1 credit

German place autocomplete straight from markt.de: free text in, markt.de's own spellings out (cities, districts, Landkreise, Bundesländer). Feed a returned name to search's `location` — search only accepts places markt.de knows.

ParameterAllowed / rangeDescription
queryrequired—Partial or full place name.
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.