Skip to content

Kleinanzeigen Ad Data Through One Scraping API

Kleinanzeigen ad pages carry the fields most teams actually need: title, asking price, location, posting date, condition, category, seller name and the image gallery.

OUTPUT FORMATSHTMLJSONMarkdown

This page explains how a hosted scraping API returns those fields from a single URL, which request options change the output, and what each option costs in credits.

What a Kleinanzeigen request returns

You hand over a kleinanzeigen.de ad URL. The service renders the page in a real browser, rotates residential proxies, and returns either rendered HTML ready for your own parser or parsed JSON when you supply extraction rules. The ad-level fields available per page are title, asking price, location, posting date, condition, category, seller name, contact details and the image gallery. Listing-level monitoring adds price drops, time on market and re-postings, which is the practical basis for German classifieds market signals without pulling seller contact data.

Three jobs this API is built for

Price extraction is the most common: pull asking prices across listings for lead generation or competitor comparison. Change tracking is the second: watch a set of listings for price drops, how long items stay listed, and re-postings. Description extraction is the third: collect the free-text body of ads for market analysis and trend spotting. Each of these maps to the same request shape — one URL in, rendered page or structured fields out — so the difference is in what you parse and how often you poll.

Field and control map

The request options below are the ones that change what comes back. Use this as a quick reference before you write your first call.

How credits are consumed

Requests start at 1 credit each. Enabling JavaScript rendering costs 5 credits per successful request. Premium proxies cost 10 credits without JS rendering and 25 with it. Stealth proxy costs 75 credits. Credits are valid for one month and do not roll over. A worked example: 1,000 ad pages with JS rendering and premium proxies at 25 credits each would consume 25,000 credits — comfortably inside the Hobby tier's 75,000 monthly allowance, but well beyond the 1,000 free signup credits.

Plan tiers at a glance

Standard plans run from Hobby at $19/month (75,000 credits, 25 concurrent requests) through Freelance at $49/month (250,000 credits, 50 concurrent), Startup at $99/month (1,000,000 credits, 100 concurrent) and Business at $249/month (3,000,000 credits, 200 concurrent). Enterprise plans begin at $999/month for 14,000,000 credits and 500 concurrent requests and scale to $5,799/month for 120,000,000 credits and 900 concurrent requests. JavaScript rendering, rotating and premium proxies, geotargeting, and screenshots with extraction rules are included on every tier. Priority email support, a dedicated account manager and team management appear only from the Business tier upward. All prices exclude VAT.

From signup to first response

Create an account to receive an API key and 1,000 free credits. Install the SDK for your stack — Python, Node, Go, PHP, Ruby and Java are published, and plain cURL works too. Send a GET request with your API key and a kleinanzeigen.de URL. The service renders JavaScript, rotates residential proxies and returns rendered HTML. Add render_js for JavaScript-heavy pages, stealth_proxy when CAPTCHAs appear, country_code to route through a residential IP in a specific country, and ai_extract_rules for natural-language field extraction. To get JSON back rather than raw markup, you have two routes: hand over a selector map through extract_rules, or describe the fields you want in plain language through ai_extract_rules. Either way the service does the parsing and returns the finished object.

Two different limits, two different fixes

The API enforces concurrency limits per plan, not per-target rate limits. That means a 429-style response from the API itself usually means you have more in-flight requests than your tier allows — reduce parallelism or upgrade. A block or throttle from Kleinanzeigen itself is a different problem: the target is rejecting the pattern, not the volume. In that case, space out requests, rotate sessions, or enable stealth_proxy. Treating the two as the same failure leads to wasted credits and unnecessary upgrades.

Before you commit: a short checklist

Confirm the ad fields you need are on the page you plan to request — some Kleinanzeigen categories omit condition or contact details. Decide whether you need rendered HTML (you will parse it yourself) or parsed JSON (you supply selectors or a natural-language spec). Estimate monthly credits from your page volume multiplied by the per-option cost, and compare against the plan tiers above. Check whether your use case needs geotargeting to a specific country, since content can vary by geo. Finally, confirm your polling frequency is compatible with the target's tolerance, not just your plan's concurrency limit.

Request option to output map
OptionWhat it changesCredit impact
render_jsRenders JavaScript before returning the page5 credits per successful request
premium_proxyRoutes through premium residential proxies10 credits without JS, 25 with JS
stealth_proxyHandles CAPTCHA-protected pages75 credits
country_codeRoutes through a residential IP in the specified countryIncluded on all plans
extract_rulesCSS selectors mapped to field names; returns parsed JSONIncluded on all plans
ai_extract_rulesNatural-language spec for field extraction; returns parsed JSONIncluded on all plans

Credit figures are per successful request and reflect the captured pricing at the time of writing. Verify current rates before budgeting.

Frequently asked questions

Do I need a Kleinanzeigen account to use this API?

No external account is required. You sign up for an API key, which comes with 1,000 free credits and no card, then send the ad URL. The service handles rendering and proxies on its side.

Can I request Kleinanzeigen pages from a specific country?

Yes. Pass country_code on the request and it routes through a residential IP in that country. This matters when the content shown varies by geography.

Is there a rate limit per target site?

The API applies concurrency limits per plan rather than per-target rate limits. If the target itself throttles aggressive patterns, space out requests or use multiple sessions.

How do I get structured JSON instead of HTML?

You have two ways to get JSON back. With extract_rules, you map CSS selectors to the field names you want. With ai_extract_rules, you describe the fields in plain language instead. Either way, the service does the parsing and hands you back a finished JSON object.

Which programming languages are supported?

Published SDKs cover Python, Node.js, Go, PHP, Ruby and Java. Plain cURL also works, so any stack that can make an HTTP request is supported.

What does it cost to scrape Kleinanzeigen?

Signup includes 1,000 free credits with no card. Paid plans start at $19/month. Per-request credit cost depends on options: 5 credits for JS rendering, 25 for premium_proxy with JS, and 75 for stealth_proxy.