markt.de

Publish a new ad on the signed-in markt.de account. Beyond the shared fields, a category asks for its own (mileage, room count, size); those go in `attributes` under the portal's field names.

Live endpoint. Credit cost: 1 (1 request = 1 credit).

post/v1/markt/listings

Request

  • Base URL: https://api.scraper-api.com
  • URL: https://api.scraper-api.com/v1/markt/listings
  • Auth: API key in header x-api-key

Headers

x-session-idstring required
Example:b6f0a1c2d3e4f5a6b7c8d9e0f1a2b3c4

The session id returned by login. Sent as the x-session-id header.

Request body

titlestring required

Headline of the ad.

descriptionstring required

Body text of the ad.

category_idstring

The portal's own category id, taken from its category picker. It has to be a LEAF category: markt.de answers a branch, or an id in the shorter form its public category pages use, with "Die Kategorie … konnte nicht zugeordnet werden" and publishes nothing. On Quoka the price field belongs to the category, so an ad with a price needs one.

pricestring

Asking price in EUR, as a plain number.

price_type'FIXED' | 'NEGOTIABLE' | 'FREE' | 'ON_REQUEST'

How the price is meant, where the portal offers a choice. Not every portal offers every one: neither markt.de nor Quoka has ON_REQUEST, and both answer with the choices they do have rather than publishing an ad with no price.

locationstring

Postcode, or postcode and city, of the ad. Quoka resolves it through its own place lookup and refuses one it does not know; add the district to pick a specific one (30159 Mitte).

ad_type'OFFER' | 'REQUEST'

An offer, or a wanted ad.

phonestring

Contact phone number to publish with the ad.

attributesstring

Category-specific form fields, keyed by the portal's own field name. Which ones a category asks for comes back from the portal when the category is picked.

publish'true' | 'false'

Publish the ad immediately, or park it as a draft where the portal offers both.

captcha_tokenstring

reCAPTCHA token, where the portal's form demands one.

Example request

{
  "title": "E-bike Cube Stereo hybrid 120",
  "description": "Kaum gefahren, Rechnung liegt bei.",
  "category_id": "2301150000",
  "price": "1450",
  "location": "44787 Bochum",
  "phone": "+4915112345678",
  "attributes": "{\"mileage\":\"12000\",\"condition\":\"used\"}",
  "captcha_token": "03AGdBq26…"
}

Response

Platform-native JSON payload (ScrapeCreators-compatible).

Changes

No recorded changes to this operation across all 1 revision of this API.