nvNeuralVerge
E-commerce & Marketplaces

Kleinanzeigen Search Data — Keyword, Category, Price & Condition Filters

Send a keyword and this source searches Kleinanzeigen and returns matching ads as data: title, price, location, shipping availability and image, with filters to narrow the query.

Example response
{
  "session_id": "11111111-1111-1111-1111-111111111111",
  "kind": "kleinanzeigen_listings_search",
  "keyword": "fahrrad",
  "max_items": 2,
  "start_page": 1,
  "partial": false,
  "human": "# Kleinanzeigen listings search\n\n- **Keyword:** fahrrad\n- **Starting page:** 1\n- **Max items:** 2\n- **Records returned:** 2\n- **Proxy traffic:** 120.6 KB",
  "machine": {
    "total_items": 2,
    "first_item": {
      "id": "3474575215",
      "title": "Canyon Neuron CF 9 SL Mountainbike 2024 Kashima Carbon Rahmen L",
      "url": "https://www.kleinanzeigen.de/s-anzeige/canyon-neuron-cf-9-sl-mountainbike-2024-kashima-carbon-rahmen-l/3474575215-217-2187",
      "price": 2888,
      "currency": "EUR",
      "old_price": 3480,
      "is_negotiable": true,
      "is_free": false,
      "description": "Ich biete mein neuwertiges Canyon Neuron CF 9 SL Mountainbike aus dem Modelljahr 2024 an. Dieses...",
      "postal_code": "06484",
      "state": "Sachsen-Anhalt",
      "city": "Quedlinburg",
      "posted_at": null,
      "shipping_available": true,
      "image": "https://img.kleinanzeigen.de/api/v1/prod-ads/images/8a/8abf7ccb-10a5-41ed-8a94-95db73f64672?rule=$_59.AUTO",
      "image_count": 1
    },
    "items": [
      {
        "id": "3474575215",
        "title": "Canyon Neuron CF 9 SL Mountainbike 2024 Kashima Carbon Rahmen L",
        "url": "https://www.kleinanzeigen.de/s-anzeige/canyon-neuron-cf-9-sl-mountainbike-2024-kashima-carbon-rahmen-l/3474575215-217-2187",
        "price": 2888,
        "currency": "EUR",
        "old_price": 3480,
        "is_negotiable": true,
        "is_free": false,
        "description": "Ich biete mein neuwertiges Canyon Neuron CF 9 SL Mountainbike aus dem Modelljahr 2024 an. Dieses...",
        "postal_code": "06484",
        "state": "Sachsen-Anhalt",
        "city": "Quedlinburg",
        "posted_at": null,
        "shipping_available": true,
        "image": "https://img.kleinanzeigen.de/api/v1/prod-ads/images/8a/8abf7ccb-10a5-41ed-8a94-95db73f64672?rule=$_59.AUTO",
        "image_count": 1
      },
      {
        "id": "3521420108",
        "title": "2024 Gazelle Eclipse T11 Bosch Performance CX Top",
        "url": "https://www.kleinanzeigen.de/s-anzeige/2024-gazelle-eclipse-t11-bosch-performance-cx-top/3521420108-217-1309",
        "price": 3299,
        "currency": "EUR",
        "old_price": null,
        "is_negotiable": false,
        "is_free": false,
        "description": "Budget Bikes Hoeve Ihre E Bike shop mit nur qualität E Bikes von bekannte hersteller, Biete...",
        "postal_code": "48599",
        "state": "Nordrhein-Westfalen",
        "city": "Gronau (Westfalen)",
        "posted_at": null,
        "shipping_available": true,
        "image": "https://img.kleinanzeigen.de/api/v1/prod-ads/images/5e/5e5fcb67-3b8a-4b3c-b47f-8a2d59778eee?rule=$_59.AUTO",
        "image_count": 20
      }
    ],
    "proxy_traffic_bytes": 123464
  },
  "total_points": 2
}
You send
A search keyword, with optional category, price, condition, seller-type, shipping and sort filters
You get back
Matching ads with title, price, location, shipping availability and image
Coverage
Active Kleinanzeigen ads matching the query.
Price
1 point per returned result, up to 500 per request — $1 per 1,000
Billed per record actually returned, capped by max_items. A search that matches nothing costs nothing.
Comparison

Ways to get this data

Three approaches teams use today, and where each one runs into trouble.

ApproachWhat it takesCostTrade-off
Checking it by handType the keyword, set filters, scroll and copyFree, and slowNobody keeps a market overview current this way
Building a scraperWrite it, host it, and repair it when the results page changesEngineering timeA maintenance commitment for something that isn't your product
NeuralVergeOne request, keyword and filters as parameters$1 per 1,000, misses not billedA broad keyword returns a broad, and more expensive, result set
Response

What you get back

Every field in the response shown above.

FieldTypeDescription
total_itemsnumberHow many ads were returned in this batch (capped by max_items).
first_itemobjectThe first ad of the batch, with the same fields as an entry in items.
itemsarrayThe matching ads.
idstringKleinanzeigen ad ID.
titlestringAd title.
urlstringDirect link to the ad.
pricenumberAsking price.
currencystringISO currency code.
old_pricenumberPrevious price, when reduced.
is_negotiablebooleanWhether the price is marked as negotiable.
is_freebooleanWhether the ad is offered for free.
descriptionstringShort excerpt of the description.
postal_codestringPostal code of the ad's location.
statestringFederal state.
citystringCity.
posted_atstringPosting date, or null when the search result doesn't show one.
shipping_availablebooleanWhether the ad offers shipping.
imagestringPrimary image URL.
image_countnumberNumber of images on the ad.
Integration

How to run it

The same lookup works from the app, the API, or as a tool an agent can call mid-task.

max_items defaults to 25 and goes up to 500. Use start_page to continue from where a previous request stopped. Results carry a short description; run Kleinanzeigen listing for the full ad.

curl -X POST https://api.neuralverge.ai/functions/v1/run-kleinanzeigen-listings-search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "keyword": "fahrrad", "max_items": 2 }'
Use cases

What teams use it for

Where this field shows up in an actual workflow.

Price monitoring

Track what a model sells for by running the same keyword and filters on a schedule.

Sourcing

Find private-seller or commercial listings of a product category, sorted by price or distance.

Demand research

Use offer_type wanted to see what people are looking for.

Feeding a lookup

Take ad IDs from the results and run Kleinanzeigen listing for full details.

Coverage & limits

Coverage, freshness and limits

What this source covers, how fresh it is, and where it stops.

Coverage

Active Kleinanzeigen ads matching the query.

Freshness

Read at request time.

Handling

This source returns publicly visible search results, stamped with the keyword it was run for and a session id you can trace.

What it will not do
  • —Results reflect the moment of the request; ads are added, sold and removed constantly.
  • —Descriptions in search results are short excerpts, and posted_at can be empty.
  • —Keywords are matched as Kleinanzeigen matches them, so use German terms for best results.
FAQ

Questions, answered

category_id, min_price, max_price, condition, offer_type, seller_type, shipping, carrier, buy_now and sort, all optional.

Related

Related sources

Try kleinanzeigen listings search on your own data

One request format across every source in the catalog.

Get started