Routing capability · BYOP
Keep your proxy pool.
Let us run the browser.
Already have a proxy provider or an approved set of exit IPs? Use that pool with the same rendering and extraction API, instead of switching to built-in proxy routing.
Available on PAYG, Team S/M/L and Scaling, or with an account override. Not included by default in the free trial.
{
"url": "https://example.com",
"proxy_profile_id": 42,
"formats": [
"markdown"
]
}Replace 42 with a profile ID from your own account.
Connect the pool once, reuse its ID
01 · Save a profile
Check plan access, then add your proxy endpoints in the dashboard. Keep credentials out of source code, shared examples and screenshots.
02 · Reference it in a request
POST the JSON body above to
/api/v1/scrapewith yourx-api-keyheader. The saved profile determines the proxy pool; rendering options remain separate.03 · Check the result
Check the API HTTP status and
success, then readdata.markdown. Inspecttokens_usedand test the pool against your target before increasing volume.
For structured output, add AI or selector extraction. An MCP scrape tool can reference an existing proxy_profile_id; it does not create profiles for you.
A different proxy charge, not a flat total
BYOP replaces the built-in vendor proxy surcharge with +1 token. With default TLS fingerprinting, a basic BYOP fetch is 4 tokens before other features or retries: 1 base + 2 TLS + 1 BYOP.
Rendering and extraction still cost extra. Your proxy provider also bills you separately. Use the actual response charge rather than treating +1 as the whole request price.
Your pool still determines routing quality
Proxy availability, credentials, upstream limits and exit-IP stability remain dependencies. Hosted rendering does not make an unavailable proxy work or guarantee that a target will accept its IP.
Do not combine proxy_profile_id with vendor proxy flags or proxy_country. Keep regional pools in separate profiles when you need control over location.
Before connecting your pool
Which plans have access to BYOP?
BYOP is available on PAYG, Team S, Team M, Team L and Scaling, or with an account override. It is not included by default on Trial, Free or Personal. Check access before setting up a profile.
How is BYOP priced?
BYOP adds 1 token instead of the built-in vendor proxy surcharge. Base request, TLS fingerprinting, rendering, extraction and retry costs still apply. You also pay your own proxy provider separately. The response reports actual usage in tokens_used.
How many proxies can I add?
A profile supports up to 100 proxy endpoints, and an account can have up to 10 profiles. Supported schemes are http, https, socks5 and socks5h. Save the pool in the dashboard, then use its ID as proxy_profile_id.
Can I combine BYOP with country or vendor proxy options?
No. proxy_profile_id is mutually exclusive with proxy_country, use_residential, use_isp and use_mobile. Choose a profile containing the country and proxy type you need instead.
Does a sticky profile guarantee a fixed external IP?
A sticky profile and proxy_sticky request the same proxy endpoint. Your proxy provider must also keep its exit IP stable; an upstream rotating endpoint can still change addresses. Test the complete session behavior with your provider.
Use only proxies and target pages you are authorized to access. A proxy profile does not grant access to restricted content. The Acceptable Use Policy applies to BYOP requests too.
Bring the pool you already use
Check plan eligibility and validate one target before scaling.