Skip to content

One API for Classified Ad Pages

Classified sites combine JavaScript-rendered pages with active bot detection.

OUTPUT FORMATSHTMLJSONMarkdown

A managed scraping API replaces the proxy pool and headless-browser layer with a single HTTP call, so your client only sends a URL and receives a rendered response. This page explains what the API returns, which request controls shape the output, and how credits are counted.

What the API does

The service accepts a classified-ad URL plus your API key and returns a rendered page. Behind that call it rotates proxies, spoofs browser fingerprints and executes JavaScript. You can then parse the response yourself or ask the API to return structured fields. The same request can be tested in a dashboard request builder before you copy a generated snippet into your codebase.

What you can pull from a classified ad

A classified ad page can yield the listing title, price, location, posting date, condition, category, seller name, contact details and the full image gallery. Teams typically use these fields for three jobs: keeping full listing records, gathering job postings, and comparing product prices across markets.

Request controls and what they change

The request controls are the practical decision surface. The table below maps each control to the output or behaviour it affects.

How credits are counted

Credits are consumed per successful request, and the cost depends on which features are enabled. The exact figures are preserved in the form-controls contract module delivered with this page. In short: a base request starts at one credit, JavaScript rendering costs five credits per successful request, and premium proxies cost ten or twenty-five credits depending on whether JavaScript rendering is also enabled. API credits are valid for one month and do not roll over.

When a managed API is the right fit

Use this checklist before committing to a build:

Worked example: one listing, structured output

Suppose you send a single classified-ad URL with render_js=true and an extract_rules map that names the fields you want. The API renders the page in a headless browser, applies your selectors, and returns parsed JSON. A typical response for one ad contains the title, price, location, posting date, condition, seller name and image gallery. You can store that object directly and compare it against other listings without writing a separate parser for each site.

Concurrency limits vs. target throttling

The API enforces concurrency limits per plan; it does not impose a per-target rate limit. If a classified site throttles aggressive request patterns, that is a target-side response, not an API quota. The practical fix is to space out requests or use multiple sessions rather than to upgrade a plan expecting a different per-target limit.

Languages and SDKs

SDKs are published for Python, Node.js, Go, PHP, Ruby and Java, and plain cURL works as well. The dashboard request builder generates snippets in Python, Node, Go, PHP, Ruby or cURL, so you can test a request before adding it to your stack.

Data handling

The service states that it does not collect or store personal data from scraped sites unless the user explicitly requests it. Compliance claims should be checked against your own legal requirements before production use.

Request controls and their effects
ControlWhat it doesCredit impact
render_jsRuns the page in a real headless browser and returns post-render HTML.5 credits per successful request
stealth_proxyRoutes the request through stealth/premium proxies to reduce CAPTCHA and blocking risk.10 or 25 credits depending on JS rendering
country_codeRoutes through a residential IP in the specified country.No separate credit figure supplied
extract_rulesMaps CSS selectors to field names and returns parsed JSON.No separate credit figure supplied
ai_extract_rulesUses a natural-language spec to extract structured fields.No separate credit figure supplied

Credit figures are taken from the form-controls contract module and reflect the captured plan configuration. Check current pricing before purchase.

Frequently asked questions

Can I scrape classified ads without writing code?

Yes. The dashboard request builder lets you paste a URL, set parameters, and copy a generated snippet in Python, Node, Go, PHP, Ruby or cURL.

How do I handle JavaScript on classified pages?

Pass render_js=true. The page runs in a real headless browser, JavaScript executes server-side, and you receive the post-render HTML.

Can I scrape from a specific country?

Yes. Pass country_code on the request to route through a residential IP in that country. This is useful when content varies by geography.

Is there a rate limit per classified site?

The API enforces concurrency limits per plan, not per-target rate limits. If a target throttles aggressive patterns, space out requests or use multiple sessions.

How do I get structured JSON from a classified ad?

You have two routes to parsed JSON. The first is extract_rules: you supply a map of CSS selectors to field names, and the API applies them to the rendered page. The second is ai_extract_rules: you describe the fields you want in natural language and let the AI layer resolve them. Either way, the response arrives already parsed as JSON rather than as raw HTML you must post-process.

Which programming languages can I use?

Any. SDKs are published for Python, Node.js, Go, PHP, Ruby and Java, and plain cURL works too.