Send a URL. Get the page.
The Scraper API fetches any public page through residential proxies, renders JavaScript when the page needs it and retries around blocks. You get HTML or Markdown back and pay only when it works.
What it does
Any public page as HTML or Markdown, with proxies, rendering and retries handled.
HTTP first, browser when needed
With
render=autoa request starts on a fast HTTP client with a real browser fingerprint and moves to headless Chrome only if the page needs it. A second browser engine steps in when Chrome is blocked.Residential proxies by country
Pick the exit country with
country, or keep the same IP for 10 minutes withsession.Blocks are retried, not returned
Challenge pages from the common anti-bot vendors are detected and retried with a new IP, up to 3 attempts within your timeout.
HTML, raw or Markdown
format=markdownreturns the main content as clean Markdown, without navigation, footers or scripts. Good input for an LLM or a RAG index.wait_for, screenshots and iframes
Wait for a CSS selector before the page is captured, get a PNG of the viewport next to the HTML, and include the content of embedded iframes.
Async, batches and webhooks
Send
async: trueand get a signed webhook when the job is done, or submit up to 1,000 URLs at once with Batch.
Example
One HTTP call
POST a URL with your key in the X-API-Key header. The answer has the target's status, headers and body, plus the tier, attempts and credits used.
Official SDKs are coming soon. Until then, any HTTP client works.
Scraper API docscurl https://api.siftzo.com/v1/scrape \
-H "X-API-Key: $SIFTZO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com", "country": "de"}'const res = await fetch("https://api.siftzo.com/v1/scrape", {
method: "POST",
headers: {
"X-API-Key": process.env.SIFTZO_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({ url: "https://example.com", country: "de" }),
signal: AbortSignal.timeout(90_000),
});
const result = await res.json();
if (!res.ok) throw new Error(result.error.code);
console.log(result.target.status_code, result.tier, result.credits);
console.log(result.target.body.slice(0, 200));import os
import requests
res = requests.post(
"https://api.siftzo.com/v1/scrape",
headers={"X-API-Key": os.environ["SIFTZO_API_KEY"]},
json={"url": "https://example.com", "country": "de"},
timeout=90,
)
result = res.json()
res.raise_for_status()
print(result["target"]["status_code"], result["tier"], result["credits"])
print(result["target"]["body"][:200])Reference
Key parameters
urlstringrequired- A public http or https URL.
renderauto | never | alwaysdefaultautoneveris HTTP only,alwaysuses a browser,autodecides and escalates. See Rendering & tiers.countryISO 3166-1 alpha-2- Exit country, for example de.
sessionstring- Keeps the same exit IP for 10 minutes.
formatjson | raw | markdown | raw_markdowndefaultjson- JSON with metadata, the body as-is, or the page as Markdown.
wait_forCSS selector- Browser only. Wait for this element.
screenshotbooleandefaultfalse- Browser only. PNG.
iframesbooleandefaultfalse- Browser only. Include the content of the page's iframes in the HTML.
asyncbooleandefaultfalse- Return a job ID at once. Add
webhook_urlfor a signed callback. timeout_msintegerdefault60000- 5,000–90,000, for the whole request including retries.
Every parameter and response field is in the Scraper API docs.
Credits
What it costs
| Request | Credits |
|---|---|
| HTTP request (render=never) | 1 |
| Browser request (render=always, or auto when needed) | 10 |
| Markdown output (format=markdown) | no extra credits |
| Batch item | same as the scrape it runs |
| Failed request (blocked, timeout, proxy error) | 0 |
You pay for the tier that produced the result, once per request. Only answers with 2xx, 3xx, 404 or 410 are billed.
See plansQuestions
When does a request use a browser?
With render=always, with wait_for, screenshot or iframes, or with render=auto when the HTTP attempt is blocked. Siftzo also remembers domains that need a browser and starts there next time, while checking now and then whether HTTP works again.
What does the Markdown output contain?
The main content of the page: headings, links, lists, tables, code blocks and images, with links made absolute. Navigation, footers, forms and scripts are removed. Markdown costs the same as JSON. See Markdown.
Do I pay for blocked requests?
No. Blocks, timeouts, unreachable targets and proxy errors cost 0 credits, including the retries Siftzo makes for you.
How long are async results kept?
24 hours. Fetch them with GET /v1/jobs/{id}, or have them sent to your webhook.
More from Siftzo
- SERP APIGoogle, Bing and DuckDuckGo results as structured JSON.
- Browser APIA fresh cloud Chrome for your Playwright or Puppeteer code, over CDP.
- Crawl APIFollow the links of a site up to 10,000 pages, always within robots.txt.
- Data APIProducts, articles and page metadata as records with fixed fields.
- AI extractionDescribe the data with a JSON Schema or a prompt and get JSON that matches.
- Proxy accessSiftzo's residential network in your own client, billed per MB.
Try the Scraper API for free
Create an account, copy your key and send a request. No card needed for the Free plan.