[Go to site: main page, start]
Skip to content

Proxy Resolution
PRO

One param. Hard targets. Add proxy: true and Microlink routes the request through residential IPs — the unblocker is automatic, no proxy list to manage.

Overview

The unblocker is a single option.

When a target blocks datacenter traffic, the API rejects with EPROXYNEEDED. Pass proxy: true on the same request and Microlink routes through residential IPs automatically — or pass your own proxy URL to bring your pool. Works on every product: screenshot, markdown, extract, run.
  • proxy: true routes through managed residential IPs — nothing to rotate
  • Bypasses Cloudflare, DataDome, Akamai and similar defenses
  • EPROXYNEEDED names the moment a target requires a proxy
  • Works on every product — screenshot, markdown, extract, run
  • BYO proxy: pass a proxy URL string instead of a boolean
Parameters

How proxy routing is controlled.

Examples

Unblock hard targets.

proxy: true routes through residential IPs automatically.
Auto-unblock
import createClient from 'microlink.io'

const microlink = createClient({
  apiKey: process.env.MICROLINK_API_KEY
})

const markdown = await microlink.markdown(
  'https://hard-target.com/article',
  { proxy: true }
)
Related features

Reach and read hard targets.

Antibot Detection

PRO
Know exactly who blocked your request and why — 30+ antibot and CAPTCHA providers.

Custom HTTP Headers

PRO
Forward cookies, tokens and any header to the target page. Keep secrets out of the URL.

Web Scraping

Extract structured JSON from any webpage using CSS selectors. URL → JSON in one request.

Configurable Caching

PRO
Cache responses for 1 minute to 31 days. Cache hits are free and ultra fast.

FAQ

What does proxy: true actually do?

It routes your request through Microlink’s managed residential IP pool instead of a datacenter IP. There is no proxy list to maintain or rotate — Microlink picks and manages the exit for you.

When do I need a proxy?

When a target refuses direct access, the API rejects with EPROXYNEEDED. That error is your signal to retry the same call with proxy: true. It typically appears on sites protected by Cloudflare, DataDome or Akamai.

Is proxy available on the free plan?

The EPROXYNEEDED signal surfaces on every plan so you always know when a target needs a proxy. Actually routing through the residential unblocker with proxy: true is a Pro capability.

Can I bring my own proxy?

Yes. Instead of true, pass a proxy URL string and Microlink routes through your own pool while still handling the browser, retries and errors.

Does proxy compose with other options?

Yes. proxy stacks with headers, ttl and automation options on the same request, so one call can unblock a target, forward a session cookie, and cache the result.