Proxy Routing: Built-In, Regional, and Custom Proxies
Every AdsCrawl browser runs through a proxy. Learn how to use built-in residential proxies, route by country, or supply your own proxy server.
Every browser that AdsCrawl runs — whether a browser task, a Remote CDP session, or a cloud browser — is routed through a proxy. Residential proxies are built into the platform, so you get sensible defaults out of the box without any configuration. When you need traffic to appear from a specific country, or when your workflow requires a dedicated proxy service, AdsCrawl gives you precise control through two optional fields: countryCode and proxy.
The three proxy modes
Omitted — automatic trusted proxy
If you send a browser task or create a CDP session without specifying countryCode or proxy, AdsCrawl automatically assigns a random trusted residential proxy. This is the simplest option and works well when geographic location does not matter.
countryCode — managed regional proxy
Set countryCode to a two-letter ISO region code to prefer a trusted proxy exit in that region. If no trusted proxy is available in the requested region, AdsCrawl falls back to a dynamic proxy automatically.Set countryCode to "GLOBAL" to use a dynamic exit that rotates across 15 popular regions — useful when you want geographic diversity without pinning to one country.
When using countryCode, also set locale and timezoneId to match the target region. For example, pair "DE" with locale: "de-DE" and timezoneId: "Europe/Berlin" so the browser’s fingerprint matches the proxy exit location.
countryCode is not available for API key callers starting cloud browsers. API key cloud browser starts require an explicit proxy object on every request. Session/JWT Bearer callers can use countryCode for cloud browser starts.
proxy — bring your own proxy
Provide a proxy object to route the browser through your own HTTP or SOCKS5 proxy server. Use this when you have a dedicated proxy service, need sticky sessions, or require a specific IP.HTTP proxy with credentials:
Never remove the proxy field to work around a proxy error. Proxy failures must not fall back to a direct connection — AdsCrawl enforces this at the infrastructure level to protect your real IP and maintain proxy hygiene. If your proxy is unreachable, fix the configuration or wait for service recovery before retrying.
When a managed proxy allocation fails, the start or task request is rejected immediately. When a custom proxy is unreachable, the request fails with a 502 or 503 error. Inspect the error code, correct the proxy configuration, and retry.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"AdsCrawl","description":"Connect with Playwright, Puppeteer, or CDP and run jobs in a full browser environment with residential proxy routing—built for dynamic pages, authenticated sessions, and sites that stop basic scrapers.","colors":{"primary":"#0071e3","light":"#7c7c7e","dark":"#070707"},"logo":{"light":"https://media.brand.dev/4640f1e9-6451-460f-a082-f8c2438d4f3b.svg","dark":"https://mintcdn.com/adscrawl/MOJftQlB9dh80Xox/images/AdsCrawl-Mainlogo2.svg?fit=max\u0026auto=format\u0026n=MOJftQlB9dh80Xox\u0026q=85\u0026s=10300c0754e1fe5c5861c09a260e7d28","href":"https://www.adscrawl.net/"},"favicon":{"light":"https://mintcdn.com/adscrawl/En06nz0S4G8hWrQZ/images/AdsCrawl-Dock4.svg?fit=max\u0026auto=format\u0026n=En06nz0S4G8hWrQZ\u0026q=85\u0026s=c26faf96d0aa9e550d718670e196b8e7","dark":"https://mintcdn.com/adscrawl/En06nz0S4G8hWrQZ/images/AdsCrawl-Dock4.svg?fit=max\u0026auto=format\u0026n=En06nz0S4G8hWrQZ\u0026q=85\u0026s=c26faf96d0aa9e550d718670e196b8e7"},"api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","javascript","python","go"]},"mdx":{"auth":{"method":"key","name":"x-api-key"},"server":"https://api.adscrawl.net"}},"navbar":{"primary":{"type":"button","label":"Start for Free","href":"https://app.adscrawl.net/register/"}},"footer":{"socials":{"github":"https://github.com/AdsCrawl","x":"https://x.com/Adscrawl"}},"seo":{"metatags":{"canonical":"https://docs.adscrawl.net"}},"integrations":{"ga4":{"measurementId":"G-F0ZW9VMNR2"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","vscode","mcp","cursor"],"display":"header"},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","default":true,"href":"introduction"},{"language":"zh","href":"zh"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"adscrawl","hasAudioNarration":false,"actualSubdomain":"adscrawl","customDomains":["docs.adscrawl.net"],"gitSource":{"type":"github","owner":"adscrawl","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6aedc312644e5d1cbd4c966e","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"zh","tag":"文档","count":24},{"language":"en","tag":"Documentation","count":23},{"language":"en","tag":"API Reference","count":22},{"language":"zh","tag":"API 参考","count":22},{"language":"zh","tag":"快速上手","count":12},{"language":"en","tag":"Get Started","count":11},{"language":"en","tag":"SDKs \u0026 Integrations","count":8},{"language":"zh","tag":"SDK 与集成","count":8},{"language":"en","tag":"Cloud Browsers","count":6},{"language":"en","tag":"Guides","count":6},{"language":"zh","tag":"云浏览器","count":6},{"language":"zh","tag":"使用指南","count":6},{"language":"en","tag":"Remote CDP","count":5},{"language":"en","tag":"Browser Tasks","count":5},{"language":"zh","tag":"远程 CDP","count":5},{"language":"zh","tag":"浏览器任务","count":5},{"language":"en","tag":"AI Scrapers","count":4},{"language":"en","tag":"Core Concepts","count":4},{"language":"zh","tag":"AI Scrapers","count":4},{"language":"zh","tag":"核心概念","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"concepts/proxies","slug":"/concepts/proxies","pageMetadata":{"title":"Proxy Routing: Built-In, Regional, and Custom Proxies","sidebarTitle":"Proxies","description":"Every AdsCrawl browser runs through a proxy. Learn how to use built-in residential proxies, route by country, or supply your own proxy server.","href":"/concepts/proxies"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Every AdsCrawl browser runs through a proxy. Learn how to use built-in residential proxies, route by country, or supply your own proxy server.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Note,Table,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Every browser that AdsCrawl runs — whether a browser task, a Remote CDP session, or a cloud browser — is routed through a proxy. Residential proxies are built into the platform, so you get sensible defaults out of the box without any configuration. When you need traffic to appear from a specific country, or when your workflow requires a dedicated proxy service, AdsCrawl gives you precise control through two optional fields: `,_jsx(_components.code,{children:`countryCode`}),` and `,_jsx(_components.code,{children:`proxy`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`the-three-proxy-modes`,children:`The three proxy modes`}),`\n`,_jsx(Heading,{level:`3`,id:`omitted-—-automatic-trusted-proxy`,children:`Omitted — automatic trusted proxy`}),`\n`,_jsxs(_components.p,{children:[`If you send a browser task or create a CDP session without specifying `,_jsx(_components.code,{children:`countryCode`}),` or `,_jsx(_components.code,{children:`proxy`}),`, AdsCrawl automatically assigns a random trusted residential proxy. This is the simplest option and works well when geographic location does not matter.`]}),`\n`,_jsxs(Heading,{level:`3`,id:`countrycode-—-managed-regional-proxy`,children:[_jsx(_components.code,{children:`countryCode`}),` — managed regional proxy`]}),`\n`,_jsxs(_components.p,{children:[`Set `,_jsx(_components.code,{children:`countryCode`}),` to a two-letter ISO region code to prefer a trusted proxy exit in that region. If no trusted proxy is available in the requested region, AdsCrawl falls back to a dynamic proxy automatically.`]}),`\n`,_jsxs(_components.p,{children:[`Set `,_jsx(_components.code,{children:`countryCode`}),` to `,_jsx(_components.code,{children:`\"GLOBAL\"`}),` to use a dynamic exit that rotates across 15 popular regions — useful when you want geographic diversity without pinning to one country.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com/article\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"contentMode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"markdown\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"countryCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"DE\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Supported country codes include:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Region`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`US`})}),_jsx(_components.td,{children:`United States`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`BR`})}),_jsx(_components.td,{children:`Brazil`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`DE`})}),_jsx(_components.td,{children:`Germany`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`SG`})}),_jsx(_components.td,{children:`Singapore`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`JP`})}),_jsx(_components.td,{children:`Japan`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`CA`})}),_jsx(_components.td,{children:`Canada`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`AU`})}),_jsx(_components.td,{children:`Australia`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GLOBAL`})}),_jsx(_components.td,{children:`Dynamic — 15 popular regions`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`When using `,_jsx(_components.code,{children:`countryCode`}),`, also set `,_jsx(_components.code,{children:`locale`}),` and `,_jsx(_components.code,{children:`timezoneId`}),` to match the target region. For example, pair `,_jsx(_components.code,{children:`\"DE\"`}),` with `,_jsx(_components.code,{children:`locale: \"de-DE\"`}),` and `,_jsx(_components.code,{children:`timezoneId: \"Europe/Berlin\"`}),` so the browser’s fingerprint matches the proxy exit location.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`countryCode`}),` is `,_jsx(_components.strong,{children:`not available`}),` for API key callers starting cloud browsers. API key cloud browser starts require an explicit `,_jsx(_components.code,{children:`proxy`}),` object on every request. Session/JWT Bearer callers can use `,_jsx(_components.code,{children:`countryCode`}),` for cloud browser starts.`]})}),`\n`,_jsxs(Heading,{level:`3`,id:`proxy-—-bring-your-own-proxy`,children:[_jsx(_components.code,{children:`proxy`}),` — bring your own proxy`]}),`\n`,_jsxs(_components.p,{children:[`Provide a `,_jsx(_components.code,{children:`proxy`}),` object to route the browser through your own HTTP or SOCKS5 proxy server. Use this when you have a dedicated proxy service, need sticky sessions, or require a specific IP.`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`HTTP proxy with credentials:`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"proxy\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"server\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"http://proxy.example.com:8080\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"username\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"proxy-user\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"password\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"proxy-password\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`SOCKS5 proxy using split fields:`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"proxy\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"protocol\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"socks5\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"host\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"proxy.example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"port\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1080`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"username\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"proxy-user\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"password\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"proxy-password\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Unauthenticated proxy:`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"proxy\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"server\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"http://proxy.example.com:8080\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`custom-proxy-format-rules`,children:`Custom proxy format rules`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Use `,_jsx(_components.code,{children:`server`}),` for a full URL (`,_jsx(_components.code,{children:`http://host:port`}),` or `,_jsx(_components.code,{children:`socks5://host:port`}),`), `,_jsx(_components.strong,{children:`or`}),` use `,_jsx(_components.code,{children:`protocol`}),` + `,_jsx(_components.code,{children:`host`}),` + `,_jsx(_components.code,{children:`port`}),` — never both in the same request`]}),`\n`,_jsx(_components.li,{children:`Ports must be integers or integer strings between 1 and 65535`}),`\n`,_jsxs(_components.li,{children:[`Do `,_jsx(_components.strong,{children:`not`}),` embed credentials in the URL — pass `,_jsx(_components.code,{children:`username`}),` and `,_jsx(_components.code,{children:`password`}),` as separate fields`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`username`}),` and `,_jsx(_components.code,{children:`password`}),` must be supplied together; omit both for an unauthenticated proxy`]}),`\n`,_jsxs(_components.li,{children:[`No path, query string, or fragment is allowed in `,_jsx(_components.code,{children:`server`})]}),`\n`]}),`\n`,_jsxs(Heading,{level:`2`,id:`combining-countrycode-and-proxy`,children:[`Combining `,_jsx(_components.code,{children:`countryCode`}),` and `,_jsx(_components.code,{children:`proxy`})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`countryCode`}),` and `,_jsx(_components.code,{children:`proxy`}),` are mutually exclusive. Passing both in the same request returns `,_jsx(_components.code,{children:`400 COUNTRY_PROXY_CONFLICT`}),`. Choose one:`]}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Use countryCode`,numberOfLines:`4`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"countryCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"JP\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Use proxy`,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"proxy\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"server\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"http://proxy.example.com:8080\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"username\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"user\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"password\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pass\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`example-countrycode-in-a-post-/html-request`,children:`Example: countryCode in a POST /html request`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`12`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`12`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -sS`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.adscrawl.net/html\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"content-type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: YOUR_API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"url\": \"https://example.com/article\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"contentMode\": \"markdown\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"countryCode\": \"US\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"locale\": \"en-US\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"timezoneId\": \"America/New_York\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"userAgentMode\": \"random\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"userAgentOs\": \"windows\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Request body`,numberOfLines:`9`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com/article\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"contentMode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"markdown\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"countryCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"US\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"locale\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"en-US\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timezoneId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"America/New_York\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"userAgentMode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"random\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"userAgentOs\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"windows\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`proxy-failure-behavior`,children:`Proxy failure behavior`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[`Never remove the `,_jsx(_components.code,{children:`proxy`}),` field to work around a proxy error.`]}),` Proxy failures must not fall back to a direct connection — AdsCrawl enforces this at the infrastructure level to protect your real IP and maintain proxy hygiene. If your proxy is unreachable, fix the configuration or wait for service recovery before retrying.`]})}),`\n`,_jsxs(_components.p,{children:[`When a managed proxy allocation fails, the start or task request is rejected immediately. When a custom proxy is unreachable, the request fails with a `,_jsx(_components.code,{children:`502`}),` or `,_jsx(_components.code,{children:`503`}),` error. Inspect the error code, correct the proxy configuration, and retry.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Proxy Routing: Built-In, Regional, and Custom Proxies","sidebarTitle":"Proxies","description":"Every AdsCrawl browser runs through a proxy. Learn how to use built-in residential proxies, route by country, or supply your own proxy server.","href":"/concepts/proxies"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"The three proxy modes","slug":"the-three-proxy-modes","depth":2,"children":[{"title":"Omitted — automatic trusted proxy","slug":"omitted-—-automatic-trusted-proxy","depth":3,"children":[]},{"title":"countryCode — managed regional proxy","slug":"countrycode-—-managed-regional-proxy","depth":3,"children":[]},{"title":"proxy — bring your own proxy","slug":"proxy-—-bring-your-own-proxy","depth":3,"children":[]},{"title":"Custom proxy format rules","slug":"custom-proxy-format-rules","depth":3,"children":[]}]},{"title":"Combining countryCode and proxy","slug":"combining-countrycode-and-proxy","depth":2,"children":[]},{"title":"Example: countryCode in a POST /html request","slug":"example-countrycode-in-a-post-/html-request","depth":2,"children":[]},{"title":"Proxy failure behavior","slug":"proxy-failure-behavior","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/adscrawl/06c522f789ce028e/salesmartly.js"],"subdomain":"adscrawl","siteName":"AdsCrawl","title":"Proxy Routing: Built-In, Regional, and Custom Proxies - AdsCrawl","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/concepts/proxies","matchLevel":0},"zh":{"href":"/zh/concepts/proxies","matchLevel":1}}},"lastModified":"2026-09-28T11:28:30.179Z","originalFileLocation":"concepts/proxies.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Every AdsCrawl browser runs through a proxy. Learn how to use built-in residential proxies, route by country, or supply your own proxy server.\">\u003cmeta data-mint-head name=\"application-name\" content=\"AdsCrawl\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/adscrawl/K83IBBeEnE6-2SmN/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/adscrawl/K83IBBeEnE6-2SmN/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/adscrawl/K83IBBeEnE6-2SmN/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/adscrawl/K83IBBeEnE6-2SmN/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/adscrawl/K83IBBeEnE6-2SmN/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/adscrawl/K83IBBeEnE6-2SmN/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/adscrawl/K83IBBeEnE6-2SmN/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/adscrawl/K83IBBeEnE6-2SmN/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/adscrawl/K83IBBeEnE6-2SmN/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Proxy Routing: Built-In, Regional, and Custom Proxies - AdsCrawl\">\u003cmeta data-mint-head property=\"og:description\" content=\"Every AdsCrawl browser runs through a proxy. Learn how to use built-in residential proxies, route by country, or supply your own proxy server.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"AdsCrawl\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.adscrawl.net/concepts/proxies\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://adscrawl.mintlify.site/_mintlify/api/og/v2?division=Core+Concepts\u0026amp;title=Proxy+Routing%3A+Built-In%2C+Regional%2C+and+Custom+Proxies\u0026amp;description=Every+AdsCrawl+browser+runs+through+a+proxy.+Learn+how+to+use+built-in+residential+proxies%2C+route+by+country%2C+or+supply+your+own+proxy+server.\u0026amp;theme=77f75d39b9b0c121a2092b55\u0026amp;signature=c6820cba483c7df16633f9b79caa1197231893b333341a83c4c47e45c2081f16\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Proxy Routing: Built-In, Regional, and Custom Proxies - AdsCrawl\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Every AdsCrawl browser runs through a proxy. Learn how to use built-in residential proxies, route by country, or supply your own proxy server.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://adscrawl.mintlify.site/_mintlify/api/og/v2?division=Core+Concepts\u0026amp;title=Proxy+Routing%3A+Built-In%2C+Regional%2C+and+Custom+Proxies\u0026amp;description=Every+AdsCrawl+browser+runs+through+a+proxy.+Learn+how+to+use+built-in+residential+proxies%2C+route+by+country%2C+or+supply+your+own+proxy+server.\u0026amp;theme=77f75d39b9b0c121a2092b55\u0026amp;signature=c6820cba483c7df16633f9b79caa1197231893b333341a83c4c47e45c2081f16\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/adscrawl/K83IBBeEnE6-2SmN/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"AdsCrawl\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0071e3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.adscrawl.net/concepts/proxies\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/concepts/proxies.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.adscrawl.net/concepts/proxies\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.adscrawl.net/zh/concepts/proxies\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.adscrawl.net/concepts/proxies\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.adscrawl.net/#organization\",\"name\":\"AdsCrawl\",\"url\":\"https://docs.adscrawl.net\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://media.brand.dev/4640f1e9-6451-460f-a082-f8c2438d4f3b.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.adscrawl.net#website\",\"name\":\"AdsCrawl\",\"url\":\"https://docs.adscrawl.net\",\"publisher\":{\"@id\":\"https://docs.adscrawl.net/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.adscrawl.net/concepts/proxies#webpage\",\"url\":\"https://docs.adscrawl.net/concepts/proxies\",\"name\":\"Proxy Routing: Built-In, Regional, and Custom Proxies\",\"description\":\"Every AdsCrawl browser runs through a proxy. Learn how to use built-in residential proxies, route by country, or supply your own proxy server.\",\"dateModified\":\"2026-09-28T11:28:30.179Z\",\"isPartOf\":{\"@id\":\"https://docs.adscrawl.net#website\"},\"breadcrumb\":{\"@id\":\"https://docs.adscrawl.net/concepts/proxies#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.adscrawl.net/concepts/proxies#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Core Concepts\",\"item\":\"https://docs.adscrawl.net/concepts/browser-tasks\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Proxy Routing: Built-In, Regional, and Custom Proxies\",\"item\":\"https://docs.adscrawl.net/concepts/proxies\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.adscrawl.net/concepts/proxies#article\",\"headline\":\"Proxy Routing: Built-In, Regional, and Custom Proxies\",\"name\":\"Proxy Routing: Built-In, Regional, and Custom Proxies\",\"description\":\"Every AdsCrawl browser runs through a proxy. Learn how to use built-in residential proxies, route by country, or supply your own proxy server.\",\"url\":\"https://docs.adscrawl.net/concepts/proxies\",\"mainEntityOfPage\":{\"@id\":\"https://docs.adscrawl.net/concepts/proxies#webpage\"},\"dateModified\":\"2026-09-28T11:28:30.179Z\",\"publisher\":{\"@id\":\"https://docs.adscrawl.net/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.adscrawl.net#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"AdsCrawl\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"AdsCrawl\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/concepts/proxies.md","siteName":"AdsCrawl","nav":{"global":null,"languages":[{"language":"en","default":true,"tabs":[{"tab":"Documentation","groups":[{"group":"Get Started","pages":[{"title":"AdsCrawl: Browser Automation API for Scraping the Web","sidebarTitle":"Introduction","href":"/introduction"},{"title":"Quick Start: Make Your First AdsCrawl API Request Today","sidebarTitle":"Quick Start","href":"/quickstart"},{"title":"API Keys, Session JWTs, and CDP Tokens in AdsCrawl","sidebarTitle":"Authentication","href":"/authentication"},{"group":"SDKs \u0026 Integrations","pages":[{"title":"AdsCrawl SDKs and Integrations","sidebarTitle":"Overview","href":"/sdks/overview"},{"title":"JavaScript and TypeScript SDK for AdsCrawl","sidebarTitle":"JavaScript","href":"/sdks/javascript"},{"title":"Python SDK for AdsCrawl","sidebarTitle":"Python","href":"/sdks/python"},{"title":"Go SDK for AdsCrawl","sidebarTitle":"Go","href":"/sdks/go"},{"title":"Ruby SDK for AdsCrawl","sidebarTitle":"Ruby","href":"/sdks/ruby"},{"title":"PHP SDK for AdsCrawl","sidebarTitle":"PHP","href":"/sdks/php"},{"title":"AdsCrawl Codex Plugin","sidebarTitle":"Codex Plugin","href":"/sdks/codex"},{"title":"AdsCrawl MCP server","sidebarTitle":"MCP server","href":"/sdks/mcp"}]}]},{"group":"Core Concepts","pages":[{"title":"Browser Tasks: HTML, Screenshots, and Data Extraction","sidebarTitle":"Browser Tasks","href":"/concepts/browser-tasks"},{"title":"Remote CDP: Connect Any CDP Client to a Cloud Browser","sidebarTitle":"Remote CDP","href":"/concepts/remote-cdp"},{"title":"Cloud Browsers: Persistent, Reusable Browser Profiles","sidebarTitle":"Cloud Browsers","description":"Save browser profiles with cookies, fingerprints, and proxy settings that persist across sessions — launch, stop, and reuse them as many times as you need.","href":"/concepts/cloud-browsers"},{"title":"Proxy Routing: Built-In, Regional, and Custom Proxies","sidebarTitle":"Proxies","href":"/concepts/proxies"}]},{"group":"Guides","pages":[{"title":"Fetch Rendered HTML, Markdown, and JSON from Any Page","sidebarTitle":"Fetch HTML","description":"Use POST /html to retrieve fully rendered page content as raw HTML, clean Markdown, or structured JSON — no browser management required.","href":"/guides/fetch-html"},{"title":"Extract Structured Data from JavaScript-Heavy Pages","sidebarTitle":"Extract Data","href":"/guides/extract-data"},{"title":"Capture Full-Page and Element Screenshots with AdsCrawl","sidebarTitle":"Screenshots","href":"/guides/screenshots"},{"title":"Automate Browsers with Playwright via Remote CDP Sessions","sidebarTitle":"Playwright Automation","href":"/guides/playwright-automation"},{"title":"Create and Manage Persistent Cloud Browser Sessions","sidebarTitle":"Cloud Browser Sessions","href":"/guides/cloud-browser-sessions"},{"sidebarTitle":"Website scraper examples","title":"Python Website Scraper Examples","href":"/guides/scraper-examples"}]},{"group":"Pricing \u0026 Limits","pages":[{"title":"AdsCrawl Pricing: Free, Hobby, Starter, and Pro Plans","sidebarTitle":"Pricing","href":"/pricing"},{"title":"AdsCrawl Credits, Rate Limits, and Concurrency Caps","sidebarTitle":"Credits \u0026 Limits","href":"/credits-and-limits"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]}]},{"language":"zh","pages":[{"title":"zh","href":"/zh/concepts/proxies"}]}]},"basePath":"","title":"Proxy Routing: Built-In, Regional, and Custom Proxies - AdsCrawl","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}