Load one page in a browser that is already running and return it in the requested formats. The browser runs behind a residential proxy of your region with a desktop fingerprint, solves the challenge pages and captchas it meets and keeps no cookies or storage between requests. One URL per request. A request is charged when its response carries the page: browser time in 10-second steps, plus the page’s traffic and the captcha solves it uses. The amounts are in receipt. See Scraping API.
POST
/
scrape
A valid request URL is required to generate request examples
What to return. html is cleaned, raw_html is the full rendered DOM, cookies is the jar after the scrape.
Available options:
html,
raw_html,
markdown,
links,
screenshot,
cookies
only_main_content
boolean
default:true
Drop page chrome from html and markdown: header, nav, footer and aside elements, plus blocks whose class or id names a sidebar, menu, breadcrumb, cookie banner, modal, ad or share widget. A block that holds #main stays.
screenshot
boolean
default:false
Shorthand for adding screenshot to formats.
screenshot_options
ScreenshotOptions · object
Show child attributes
block_resources
enum<string>[]
What the page does not download: image, media, font and stylesheet by resource type, media with the audio and video a player streams; iframe: frames from other sites; ads: ads, analytics and cookie banners. Captcha and anti-bot frames always load. Omitted: image, media, font, iframe and ads, or nothing when a screenshot is requested. An empty list blocks nothing.
Available options:
image,
media,
font,
stylesheet,
iframe,
ads
cookies
stringobject[]
Cookies set before navigation: the JSON shape the cookies format returns, or Netscape text.
wait
number
default:0
Extra wait in seconds after navigation.
Required range: 0 <= x <= 60
wait_until
enum<string>
default:domcontentloaded
Available options:
domcontentloaded,
load,
networkidle,
commit
wait_for
string
CSS or XPath selector to wait for after navigation. Passes when any element matching it is visible.
timeout
integer
default:30000
Navigation and selector timeout in milliseconds.
auto_captcha_solve
boolean
default:true
Pass every challenge page and solve every captcha the page shows, paid types included; each solve adds 10 to 60 seconds and is a captcha charge whatever its outcome. False solves nothing and reports what stood in the way in challenge.
Steps run on the loaded page with human emulation, in order. The first failure ends the request with action_failed.
Maximum array length: 10
Move the mouse to the element and click it.
ClickAction
TypeAction
PressAction
ScrollAction
WaitAction
SolveAction
Show child attributes
Response
Successful response
success
boolean
required
data
object
required
Show child attributes
msg
string
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Surfsky","description":"Surfsky cloud browser for automation and scraping","colors":{"primary":"#111111","light":"#ffffff","dark":"#767676"},"logo":{"light":"https://mintcdn.com/llcfzecyberfinity/sOzW2rg1MprciyvQ/images/logo-light.svg?fit=max\u0026auto=format\u0026n=sOzW2rg1MprciyvQ\u0026q=85\u0026s=c6cc1d7d380cb1803815c2369dc6f6c2","dark":"https://mintcdn.com/llcfzecyberfinity/sOzW2rg1MprciyvQ/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=sOzW2rg1MprciyvQ\u0026q=85\u0026s=de57992e58089755f7cd4f3d518da18f","href":"https://surfsky.io"},"favicon":{"light":"https://mintcdn.com/llcfzecyberfinity/sOzW2rg1MprciyvQ/images/favicon-light.svg?fit=max\u0026auto=format\u0026n=sOzW2rg1MprciyvQ\u0026q=85\u0026s=435f78bbb4fbb8acbf012947b73cbaf4","dark":"https://mintcdn.com/llcfzecyberfinity/sOzW2rg1MprciyvQ/images/favicon-dark.svg?fit=max\u0026auto=format\u0026n=sOzW2rg1MprciyvQ\u0026q=85\u0026s=26f98ca931286a0355c2f45a1ea9a892"},"appearance":{"default":"dark"},"background":{"color":{"light":"#ffffff","dark":"#111111"}},"navbar":{"links":[{"href":"https://surfsky.io","label":"Go to Website"}],"primary":{"type":"button","label":"Get Started","href":"https://surfsky.io/signin"}},"footer":{"socials":{"x":"https://x.com/surfskyio","github":"https://github.com/surfskyio","youtube":"https://www.youtube.com/@surfskyio","linkedin":"https://www.linkedin.com/company/surfskyio"}},"seo":{"metatags":{"canonical":"https://docs.surfsky.io","google-site-verification":"J4sdCp8jl5MCOHehI0AOmiPBlLduJLMGQrT4pTNwvU4","msvalidate.01":"C003BE57DE9AE70B5829DB3858FF8609"}},"integrations":{"gtm":{"tagId":"GTM-NX966VJC"}},"contextual":{"options":["copy","view","chatgpt","claude","download-spec"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"llcfzecyberfinity","hasAudioNarration":false,"actualSubdomain":"llcfzecyberfinity","customDomains":["docs.surfsky.io"],"gitSource":{"type":"github","owner":"surfskyio","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afae8d6e515a9eaa9be7db3","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API reference","count":42},{"language":"default","tag":"Documentation","count":41},{"language":"default","tag":"Profiles","count":14},{"language":"default","tag":"CAPTCHA guides","count":12},{"language":"default","tag":"Proxies","count":11},{"language":"default","tag":"Connect your tools","count":8},{"language":"default","tag":"Get started","count":6},{"language":"default","tag":"SDKs","count":6},{"language":"default","tag":"Browser sessions","count":5},{"language":"default","tag":"Statistics","count":5}]},"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":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#content-area span[id]:empty{display:block;scroll-margin-top:var(--scroll-mt, 8rem)}"}]}
{"page":{"pagePath":"api-reference/scrape/scrape-a-page","slug":"/api-reference/scrape/scrape-a-page","pageMetadata":{"title":"Scrape a page","description":"Load one page in a browser that is already running and return it in the requested formats. The browser runs behind a residential proxy of your region with a desktop fingerprint, solves the challenge pages and captchas it meets and keeps no cookies or storage between requests. One URL per request. A request is charged when its response carries the page: browser time in 10-second steps, plus the page's traffic and the captcha solves it uses. The amounts are in `receipt`. See [Scraping API](/quickstart/scraping_api).","deprecated":null,"version":null,"sidebarTitle":"Scrape a page","openapi":"/api-reference/openapi.json post /scrape","href":"/api-reference/scrape/scrape-a-page","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Load one page in a browser that is already running and return it in the requested formats. The browser runs behind a residential proxy of your region with a desktop fingerprint, solves the challenge pages and captchas it meets and keeps no cookies or storage between requests. One URL per request. A request is charged when its response carries the page: browser time in 10-second steps, plus the page’s traffic and the captcha solves it uses. The amounts are in \", _jsx(_components.code, {\n children: \"receipt\"\n }), \". See \", _jsx(_components.a, {\n href: \"/quickstart/scraping_api\",\n children: \"Scraping API\"\n }), \".\"]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Scrape a page","description":"Load one page in a browser that is already running and return it in the requested formats. The browser runs behind a residential proxy of your region with a desktop fingerprint, solves the challenge pages and captchas it meets and keeps no cookies or storage between requests. One URL per request. A request is charged when its response carries the page: browser time in 10-second steps, plus the page's traffic and the captcha solves it uses. The amounts are in `receipt`. See [Scraping API](/quickstart/scraping_api).","deprecated":null,"version":null,"sidebarTitle":"Scrape a page","openapi":"/api-reference/openapi.json post /scrape","href":"/api-reference/scrape/scrape-a-page","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["scrape"],"summary":"Scrape a page","operationId":"scrape_scrape_post","requestBody":"73319924-b355-424c-9794-9f25f68eb6b8","responses":{"200":"9b1e8640-c4c0-42d8-8594-d71656467ab9","400":"1cf78fa6-a94c-402e-8634-652924d33db8","401":"b19c7e01-44d5-4566-973d-9d6e8be9d837","402":"9f030c50-ae43-44a7-b190-e567473e631e","403":"5e7074e5-c3a2-4aad-afea-2646f0e0110b","422":"ff1ec06b-dc0b-47a3-ab7c-83d7b63a5976","429":"ea2b135b-a66d-4487-bcb7-00358f4dc1a3"},"description":"Load one page in a browser that is already running and return it in the requested formats. The browser runs behind a residential proxy of your region with a desktop fingerprint, solves the challenge pages and captchas it meets and keeps no cookies or storage between requests. One URL per request. A request is charged when its response carries the page: browser time in 10-second steps, plus the page's traffic and the captcha solves it uses. The amounts are in `receipt`. See [Scraping API](/quickstart/scraping_api).","x-mint":{"href":"/api-reference/scrape/scrape-a-page"},"method":"post","type":"path","servers":["8b6ae1ef-fca0-430e-b391-4de47f9a12bc"],"security":["a62a6bff-e3ee-4ed0-a213-7ef26ba2c6e9"],"path":"/scrape","baseUrlOptions":["{baseUrl}"],"title":"Scrape a page","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Page URL to visit.","isRequired":true,"uniqueKey":"url","typeLabel":"string\u003curi>"},"formats":{"type":"array","items":{"type":"string","enum":["html","raw_html","markdown","links","screenshot","cookies"],"uniqueKey":"formats.items.[INDEX]","typeLabel":"enum\u003cstring>"},"default":["html"],"description":"What to return. html is cleaned, raw_html is the full rendered DOM, cookies is the jar after the scrape.","uniqueKey":"formats","typeLabel":"enum\u003cstring>[]"},"only_main_content":{"type":"boolean","default":true,"description":"Drop page chrome from html and markdown: header, nav, footer and aside elements, plus blocks whose class or id names a sidebar, menu, breadcrumb, cookie banner, modal, ad or share widget. A block that holds #main stays.","uniqueKey":"only_main_content","typeLabel":"boolean"},"screenshot":{"type":"boolean","default":false,"description":"Shorthand for adding screenshot to formats.","uniqueKey":"screenshot","typeLabel":"boolean"},"screenshot_options":{"properties":{"full_page":{"type":"boolean","title":"Full Page","default":true,"uniqueKey":"screenshot_options.full_page","typeLabel":"boolean"},"format":{"type":"string","enum":["png","jpeg"],"title":"Format","default":"png","uniqueKey":"screenshot_options.format","typeLabel":"enum\u003cstring>"},"quality":{"oneOf":[{"type":"integer","title":"Quality","description":"jpeg only","maximum":100,"minimum":1,"uniqueKey":"screenshot_options.quality.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Quality","description":"jpeg only","uniqueKey":"screenshot_options.quality.oneOf.1","typeLabel":"null"}],"uniqueKey":"screenshot_options.quality","typeLabel":"integer | null"}},"additionalProperties":false,"type":"object","title":"ScreenshotOptions","uniqueKey":"screenshot_options","typeLabel":"ScreenshotOptions · object"},"block_resources":{"type":"array","items":{"type":"string","enum":["image","media","font","stylesheet","iframe","ads"],"uniqueKey":"block_resources.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"What the page does not download: image, media, font and stylesheet by resource type, media with the audio and video a player streams; iframe: frames from other sites; ads: ads, analytics and cookie banners. Captcha and anti-bot frames always load. Omitted: image, media, font, iframe and ads, or nothing when a screenshot is requested. An empty list blocks nothing.","uniqueKey":"block_resources","typeLabel":"enum\u003cstring>[]"},"cookies":{"oneOf":[{"type":"string","description":"Cookies set before navigation: the JSON shape the cookies format returns, or Netscape text.","uniqueKey":"cookies.oneOf.0","typeLabel":"string"},{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"cookies.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"Cookies set before navigation: the JSON shape the cookies format returns, or Netscape text.","uniqueKey":"cookies.oneOf.1","typeLabel":"object[]"}],"uniqueKey":"cookies","typeLabel":"string | object[]"},"wait":{"type":"number","minimum":0,"maximum":60,"default":0,"description":"Extra wait in seconds after navigation.","uniqueKey":"wait","typeLabel":"number"},"wait_until":{"type":"string","enum":["domcontentloaded","load","networkidle","commit"],"default":"domcontentloaded","uniqueKey":"wait_until","typeLabel":"enum\u003cstring>"},"wait_for":{"type":"string","description":"CSS or XPath selector to wait for after navigation. Passes when any element matching it is visible.","uniqueKey":"wait_for","typeLabel":"string"},"timeout":{"type":"integer","exclusiveMinimum":0,"default":30000,"description":"Navigation and selector timeout in milliseconds.","uniqueKey":"timeout","typeLabel":"integer"},"auto_captcha_solve":{"type":"boolean","default":true,"description":"Pass every challenge page and solve every captcha the page shows, paid types included; each solve adds 10 to 60 seconds and is a captcha charge whatever its outcome. False solves nothing and reports what stood in the way in challenge.","uniqueKey":"auto_captcha_solve","typeLabel":"boolean"},"actions":{"type":"array","items":{"oneOf":[{"type":"object","title":"ClickAction","description":"Move the mouse to the element and click it.","required":["type","selector"],"properties":{"type":{"type":"string","const":"click","title":"Type","isRequired":true,"uniqueKey":"actions.items.[INDEX].oneOf.0.type","typeLabel":"string"},"selector":{"type":"string","title":"Selector","isRequired":true,"uniqueKey":"actions.items.[INDEX].oneOf.0.selector","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"actions.items.[INDEX].oneOf.0","typeLabel":"ClickAction · object"},{"type":"object","title":"TypeAction","description":"Click the element and type the text key by key.","required":["type","selector","text"],"properties":{"type":{"type":"string","const":"type","title":"Type","isRequired":true,"uniqueKey":"actions.items.[INDEX].oneOf.1.type","typeLabel":"string"},"selector":{"type":"string","title":"Selector","isRequired":true,"uniqueKey":"actions.items.[INDEX].oneOf.1.selector","typeLabel":"string"},"text":{"type":"string","title":"Text","isRequired":true,"uniqueKey":"actions.items.[INDEX].oneOf.1.text","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"actions.items.[INDEX].oneOf.1","typeLabel":"TypeAction · object"},{"type":"object","title":"PressAction","description":"Press one key, such as Enter or Tab.","required":["type","key"],"properties":{"type":{"type":"string","const":"press","title":"Type","isRequired":true,"uniqueKey":"actions.items.[INDEX].oneOf.2.type","typeLabel":"string"},"key":{"type":"string","title":"Key","isRequired":true,"uniqueKey":"actions.items.[INDEX].oneOf.2.key","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"actions.items.[INDEX].oneOf.2","typeLabel":"PressAction · object"},{"type":"object","title":"ScrollAction","description":"Scroll the element into view, or one screen up or down.","required":["type"],"properties":{"type":{"type":"string","const":"scroll","title":"Type","isRequired":true,"uniqueKey":"actions.items.[INDEX].oneOf.3.type","typeLabel":"string"},"selector":{"oneOf":[{"type":"string","title":"Selector","uniqueKey":"actions.items.[INDEX].oneOf.3.selector.oneOf.0","typeLabel":"string"},{"type":"null","title":"Selector","uniqueKey":"actions.items.[INDEX].oneOf.3.selector.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.items.[INDEX].oneOf.3.selector","typeLabel":"string | null"},"direction":{"oneOf":[{"type":"string","title":"Direction","enum":["up","down"],"uniqueKey":"actions.items.[INDEX].oneOf.3.direction.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Direction","uniqueKey":"actions.items.[INDEX].oneOf.3.direction.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.items.[INDEX].oneOf.3.direction","typeLabel":"enum\u003cstring> | null"}},"additionalProperties":false,"uniqueKey":"actions.items.[INDEX].oneOf.3","typeLabel":"ScrollAction · object"},{"type":"object","title":"WaitAction","description":"Wait for an element, or for a pause in milliseconds.","required":["type"],"properties":{"type":{"type":"string","const":"wait","title":"Type","isRequired":true,"uniqueKey":"actions.items.[INDEX].oneOf.4.type","typeLabel":"string"},"ms":{"oneOf":[{"type":"integer","title":"Ms","maximum":60000,"minimum":0,"uniqueKey":"actions.items.[INDEX].oneOf.4.ms.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Ms","uniqueKey":"actions.items.[INDEX].oneOf.4.ms.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.items.[INDEX].oneOf.4.ms","typeLabel":"integer | null"},"selector":{"oneOf":[{"type":"string","title":"Selector","uniqueKey":"actions.items.[INDEX].oneOf.4.selector.oneOf.0","typeLabel":"string"},{"type":"null","title":"Selector","uniqueKey":"actions.items.[INDEX].oneOf.4.selector.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.items.[INDEX].oneOf.4.selector","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"actions.items.[INDEX].oneOf.4","typeLabel":"WaitAction · object"},{"type":"object","title":"SolveAction","description":"Solve the captcha the page carries at this point, whatever auto_captcha_solve says.","required":["type"],"properties":{"type":{"type":"string","const":"solve","title":"Type","isRequired":true,"uniqueKey":"actions.items.[INDEX].oneOf.5.type","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"actions.items.[INDEX].oneOf.5","typeLabel":"SolveAction · object"}],"uniqueKey":"actions.items.[INDEX]","typeLabel":"ClickAction · object | TypeAction · object | PressAction · object | ScrollAction · object | WaitAction · object | SolveAction · object"},"maxItems":10,"description":"Steps run on the loaded page with human emulation, in order. The first failure ends the request with action_failed.","uniqueKey":"actions","typeLabel":"(ClickAction · object | TypeAction · object | PressAction · object | ScrollAction · object | WaitAction · object | SolveAction · object)[]"}},"required":["url"],"uniqueKey":"","typeLabel":"object"},"examples":{"markdown":{"title":"markdown","summary":"Markdown of the main content","value":{"url":"https://example.com","formats":["markdown"]}},"actions":{"title":"actions","summary":"A search typed into the page","value":{"url":"https://duckduckgo.com/","formats":["links"],"actions":[{"type":"click","selector":"textarea[name=q]"},{"type":"type","selector":"textarea[name=q]","text":"surfsky"},{"type":"press","key":"Enter"},{"type":"wait","selector":"article"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"9b1e8640-c4c0-42d8-8594-d71656467ab9":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"data":{"type":"object","properties":{"url":{"type":"string","isRequired":true,"uniqueKey":"data.url","typeLabel":"string"},"final_url":{"type":"string","description":"URL after redirects and solves.","isRequired":true,"uniqueKey":"data.final_url","typeLabel":"string"},"status":{"type":"integer","description":"Target website HTTP status after redirects and solves; 0 when navigation has no response.","isRequired":true,"uniqueKey":"data.status","typeLabel":"integer"},"status_text":{"type":"string","isRequired":true,"uniqueKey":"data.status_text","typeLabel":"string"},"title":{"type":"string","isRequired":true,"uniqueKey":"data.title","typeLabel":"string"},"content_type":{"type":"string","isRequired":true,"uniqueKey":"data.content_type","typeLabel":"string"},"challenge":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["challenge_page","block_page","page_captcha"],"isRequired":true,"uniqueKey":"data.challenge.oneOf.0.kind","typeLabel":"enum\u003cstring>"},"captcha":{"oneOf":[{"type":"string","description":"The captcha's type; null on a challenge page without one.","isRequired":true,"uniqueKey":"data.challenge.oneOf.0.captcha.oneOf.0","typeLabel":"string"},{"type":"null","description":"The captcha's type; null on a challenge page without one.","isRequired":true,"uniqueKey":"data.challenge.oneOf.0.captcha.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.challenge.oneOf.0.captcha","typeLabel":"string | null"},"solved":{"type":"boolean","description":"Whether the obstacle was passed: the page behind a challenge page was reached, or the page captcha was solved.","isRequired":true,"uniqueKey":"data.challenge.oneOf.0.solved","typeLabel":"boolean"},"cost":{"type":"string","description":"Captcha charges of the whole request as a money string; \"0\" when nothing was charged.","isRequired":true,"uniqueKey":"data.challenge.oneOf.0.cost","typeLabel":"string"}},"required":["kind","captcha","solved","cost"],"description":"The last obstacle the request met; null when nothing stood in the way.","isRequired":true,"uniqueKey":"data.challenge.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"kind":{"type":"string","enum":["challenge_page","block_page","page_captcha"]},"captcha":{"oneOf":[{"type":"string","description":"The captcha's type; null on a challenge page without one."},{"type":"null","description":"The captcha's type; null on a challenge page without one."}]},"solved":{"type":"boolean","description":"Whether the obstacle was passed: the page behind a challenge page was reached, or the page captcha was solved."},"cost":{"type":"string","description":"Captcha charges of the whole request as a money string; \"0\" when nothing was charged."}},"required":["kind","captcha","solved","cost"],"description":"The last obstacle the request met; null when nothing stood in the way.","isRequired":true,"uniqueKey":"data.challenge.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.challenge","typeLabel":"object | null"},"metadata":{"type":"object","properties":{"description":{"oneOf":[{"type":"string","uniqueKey":"data.metadata.description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.metadata.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.metadata.description","typeLabel":"string | null"},"language":{"oneOf":[{"type":"string","uniqueKey":"data.metadata.language.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.metadata.language.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.metadata.language","typeLabel":"string | null"},"canonical_url":{"oneOf":[{"type":"string","uniqueKey":"data.metadata.canonical_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.metadata.canonical_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.metadata.canonical_url","typeLabel":"string | null"},"og_title":{"oneOf":[{"type":"string","uniqueKey":"data.metadata.og_title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.metadata.og_title.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.metadata.og_title","typeLabel":"string | null"},"og_description":{"oneOf":[{"type":"string","uniqueKey":"data.metadata.og_description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.metadata.og_description.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.metadata.og_description","typeLabel":"string | null"},"og_image":{"oneOf":[{"type":"string","uniqueKey":"data.metadata.og_image.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.metadata.og_image.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.metadata.og_image","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"data.metadata","typeLabel":"object"},"receipt":{"type":"object","properties":{"session_uuid":{"type":"string","description":"The request's session in the billing API.","uniqueKey":"data.receipt.session_uuid","typeLabel":"string"},"billed_seconds":{"type":"integer","description":"Browser time in 10-second steps; 0 when the request is not billed.","uniqueKey":"data.receipt.billed_seconds","typeLabel":"integer"},"billed_minutes":{"type":"number","description":"billed_seconds in minutes, to two decimals.","uniqueKey":"data.receipt.billed_minutes","typeLabel":"number"},"traffic_bytes":{"type":"integer","uniqueKey":"data.receipt.traffic_bytes","typeLabel":"integer"},"browser_cost":{"type":"string","uniqueKey":"data.receipt.browser_cost","typeLabel":"string"},"traffic_cost":{"type":"string","uniqueKey":"data.receipt.traffic_cost","typeLabel":"string"},"captcha_cost":{"type":"string","description":"Captcha solves of the whole request, charged whatever became of the page.","uniqueKey":"data.receipt.captcha_cost","typeLabel":"string"},"total_cost":{"type":"string","description":"Browser time, traffic and captcha solves together, in USD.","uniqueKey":"data.receipt.total_cost","typeLabel":"string"}},"description":"What the request cost, as the ledger records it. Absent when the request never reached a browser.","uniqueKey":"data.receipt","typeLabel":"object"},"content":{"type":"string","description":"Cleaned HTML, with the html format.","uniqueKey":"data.content","typeLabel":"string"},"raw_html":{"type":"string","description":"The full rendered DOM, with the raw_html format.","uniqueKey":"data.raw_html","typeLabel":"string"},"markdown":{"type":"string","uniqueKey":"data.markdown","typeLabel":"string"},"links":{"type":"array","items":{"type":"string","uniqueKey":"data.links.items.[INDEX]","typeLabel":"string"},"description":"Absolute URLs, deduplicated, with the links format.","uniqueKey":"data.links","typeLabel":"string[]"},"screenshot":{"type":"string","contentEncoding":"base64","description":"Image data, with the screenshot format; omitted when capture fails.","uniqueKey":"data.screenshot","typeLabel":"string"},"cookies":{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"data.cookies.items.[INDEX]","typeLabel":"object"},"description":"The jar after the scrape, with the cookies format.","uniqueKey":"data.cookies","typeLabel":"object[]"}},"required":["url","final_url","status","status_text","title","content_type","challenge","metadata"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"},"msg":{"type":"string","uniqueKey":"msg","typeLabel":"string"}},"required":["success","data"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"data":{"url":"\u003cstring>","final_url":"\u003cstring>","status":123,"status_text":"\u003cstring>","title":"\u003cstring>","content_type":"\u003cstring>","challenge":{"kind":"challenge_page","captcha":"\u003cstring>","solved":true,"cost":"\u003cstring>"},"metadata":{"description":"\u003cstring>","language":"\u003cstring>","canonical_url":"\u003cstring>","og_title":"\u003cstring>","og_description":"\u003cstring>","og_image":"\u003cstring>"},"receipt":{"session_uuid":"\u003cstring>","billed_seconds":123,"billed_minutes":123,"traffic_bytes":123,"browser_cost":"\u003cstring>","traffic_cost":"\u003cstring>","captcha_cost":"\u003cstring>","total_cost":"\u003cstring>"},"content":"\u003cstring>","raw_html":"\u003cstring>","markdown":"\u003cstring>","links":["\u003cstring>"],"screenshot":"\u003cstring>","cookies":[{}]},"msg":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"1cf78fa6-a94c-402e-8634-652924d33db8":{"description":"The page could not be fetched; code names the cause and data carries the page the browser was left on","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":false,"uniqueKey":"success","typeLabel":"boolean"},"msg":{"type":"string","uniqueKey":"msg","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"data":{"oneOf":[{}],"uniqueKey":"data","typeLabel":"any"},"detail":{"oneOf":[{}],"uniqueKey":"detail","typeLabel":"any"},"error":{"oneOf":[{}],"uniqueKey":"error","typeLabel":"any"}},"description":"Error fields vary for forwarded responses. Check HTTP status and code when present.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"msg":"\u003cstring>","code":"\u003cstring>","data":"\u003cunknown>","detail":"\u003cunknown>","error":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"},"b19c7e01-44d5-4566-973d-9d6e8be9d837":{"description":"Missing or invalid API token","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":false,"uniqueKey":"success","typeLabel":"boolean"},"msg":{"type":"string","uniqueKey":"msg","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"data":{"oneOf":[{}],"uniqueKey":"data","typeLabel":"any"},"detail":{"oneOf":[{}],"uniqueKey":"detail","typeLabel":"any"},"error":{"oneOf":[{}],"uniqueKey":"error","typeLabel":"any"}},"description":"Error fields vary for forwarded responses. Check HTTP status and code when present.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"msg":"\u003cstring>","code":"\u003cstring>","data":"\u003cunknown>","detail":"\u003cunknown>","error":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"},"9f030c50-ae43-44a7-b190-e567473e631e":{"description":"Empty balance (insufficient_balance)","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":false,"uniqueKey":"success","typeLabel":"boolean"},"msg":{"type":"string","uniqueKey":"msg","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"data":{"oneOf":[{}],"uniqueKey":"data","typeLabel":"any"},"detail":{"oneOf":[{}],"uniqueKey":"detail","typeLabel":"any"},"error":{"oneOf":[{}],"uniqueKey":"error","typeLabel":"any"}},"description":"Error fields vary for forwarded responses. Check HTTP status and code when present.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"msg":"\u003cstring>","code":"\u003cstring>","data":"\u003cunknown>","detail":"\u003cunknown>","error":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"},"5e7074e5-c3a2-4aad-afea-2646f0e0110b":{"description":"Account or feature access denied","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":false,"uniqueKey":"success","typeLabel":"boolean"},"msg":{"type":"string","uniqueKey":"msg","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"data":{"oneOf":[{}],"uniqueKey":"data","typeLabel":"any"},"detail":{"oneOf":[{}],"uniqueKey":"detail","typeLabel":"any"},"error":{"oneOf":[{}],"uniqueKey":"error","typeLabel":"any"}},"description":"Error fields vary for forwarded responses. Check HTTP status and code when present.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"msg":"\u003cstring>","code":"\u003cstring>","data":"\u003cunknown>","detail":"\u003cunknown>","error":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"},"ff1ec06b-dc0b-47a3-ab7c-83d7b63a5976":{"description":"Request validation failed","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":false,"uniqueKey":"success","typeLabel":"boolean"},"msg":{"type":"string","uniqueKey":"msg","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"data":{"oneOf":[{}],"uniqueKey":"data","typeLabel":"any"},"detail":{"oneOf":[{}],"uniqueKey":"detail","typeLabel":"any"},"error":{"oneOf":[{}],"uniqueKey":"error","typeLabel":"any"}},"description":"Error fields vary for forwarded responses. Check HTTP status and code when present.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"msg":"\u003cstring>","code":"\u003cstring>","data":"\u003cunknown>","detail":"\u003cunknown>","error":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"},"ea2b135b-a66d-4487-bcb7-00358f4dc1a3":{"description":"Request rate or browser slots exhausted (rate_limits_reached, parallel_browsers_limit_reached)","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":false,"uniqueKey":"success","typeLabel":"boolean"},"msg":{"type":"string","uniqueKey":"msg","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"data":{"oneOf":[{}],"uniqueKey":"data","typeLabel":"any"},"detail":{"oneOf":[{}],"uniqueKey":"detail","typeLabel":"any"},"error":{"oneOf":[{}],"uniqueKey":"error","typeLabel":"any"}},"description":"Error fields vary for forwarded responses. Check HTTP status and code when present.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"msg":"\u003cstring>","code":"\u003cstring>","data":"\u003cunknown>","detail":"\u003cunknown>","error":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"a62a6bff-e3ee-4ed0-a213-7ef26ba2c6e9":{"ApiToken":{"type":"apiKey","in":"header","name":"X-Cloud-Api-Token","description":"API token from your dashboard.","scopes":[],"schemeName":"ApiToken"}}},"servers":{"8b6ae1ef-fca0-430e-b391-4de47f9a12bc":{"url":"{baseUrl}","variables":{"baseUrl":{"default":"https://YOUR_API_HOST","description":"API base URL from your Surfsky dashboard, including https://."}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Cloud-Api-Token","description":"API token from your dashboard.","scopes":[],"schemeName":"ApiToken"},"schema":{"title":"X-Cloud-Api-Token","type":"string","description":"API token from your dashboard.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiToken","name":"X-Cloud-Api-Token"}],"title":"ApiToken"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"llcfzecyberfinity","siteName":"Surfsky","title":"Scrape a page - Surfsky","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T15:49:59.074Z","originalFileLocation":"api-reference/scrape/scrape-a-page.mdx"},"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=\"dark\"}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=\"Load one page in a browser that is already running and return it in the requested formats. The browser runs behind a residential proxy of your region with a desktop fingerprint, solves the challenge pages and captchas it meets and keeps no cookies or storage between requests. One URL per request. A request is charged when its response carries the page: browser time in 10-second steps, plus the page\u0026#x27;s traffic and the captcha solves it uses. The amounts are in receipt. See Scraping API.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Surfsky\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/llcfzecyberfinity/SHqOt5EXHexpipeW/_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/llcfzecyberfinity/SHqOt5EXHexpipeW/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/llcfzecyberfinity/SHqOt5EXHexpipeW/_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/llcfzecyberfinity/SHqOt5EXHexpipeW/_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/llcfzecyberfinity/SHqOt5EXHexpipeW/_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/llcfzecyberfinity/SHqOt5EXHexpipeW/_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/llcfzecyberfinity/SHqOt5EXHexpipeW/_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/llcfzecyberfinity/SHqOt5EXHexpipeW/_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/llcfzecyberfinity/SHqOt5EXHexpipeW/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Scrape a page - Surfsky\">\u003cmeta data-mint-head property=\"og:description\" content=\"Load one page in a browser that is already running and return it in the requested formats. The browser runs behind a residential proxy of your region with a desktop fingerprint, solves the challenge pages and captchas it meets and keeps no cookies or storage between requests. One URL per request. A request is charged when its response carries the page: browser time in 10-second steps, plus the page\u0026#x27;s traffic and the captcha solves it uses. The amounts are in receipt. See Scraping API.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Surfsky\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.surfsky.io/api-reference/scrape/scrape-a-page\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://llcfzecyberfinity.mintlify.site/_mintlify/api/og/v2?division=Scrape\u0026amp;title=Scrape+a+page\u0026amp;description=Load+one+page+in+a+browser+that+is+already+running+and+return+it+in+the+requested+formats.+The+browser+runs+behind+a+residential+proxy+of+your+region+with+a+des\u0026amp;theme=2b8a00d4453be936bbc3823c\u0026amp;signature=e7303ee0d2cde6c4a591448833fbc405a930f8b28507aa8110ccd489ed55dc1c\">\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=\"Scrape a page - Surfsky\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Load one page in a browser that is already running and return it in the requested formats. The browser runs behind a residential proxy of your region with a desktop fingerprint, solves the challenge pages and captchas it meets and keeps no cookies or storage between requests. One URL per request. A request is charged when its response carries the page: browser time in 10-second steps, plus the page\u0026#x27;s traffic and the captcha solves it uses. The amounts are in receipt. See Scraping API.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://llcfzecyberfinity.mintlify.site/_mintlify/api/og/v2?division=Scrape\u0026amp;title=Scrape+a+page\u0026amp;description=Load+one+page+in+a+browser+that+is+already+running+and+return+it+in+the+requested+formats.+The+browser+runs+behind+a+residential+proxy+of+your+region+with+a+des\u0026amp;theme=2b8a00d4453be936bbc3823c\u0026amp;signature=e7303ee0d2cde6c4a591448833fbc405a930f8b28507aa8110ccd489ed55dc1c\">\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/llcfzecyberfinity/SHqOt5EXHexpipeW/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Surfsky\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#111111\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"J4sdCp8jl5MCOHehI0AOmiPBlLduJLMGQrT4pTNwvU4\">\u003cmeta data-mint-head name=\"msvalidate.01\" content=\"C003BE57DE9AE70B5829DB3858FF8609\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.surfsky.io/api-reference/scrape/scrape-a-page\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/scrape/scrape-a-page.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.surfsky.io/#organization\",\"name\":\"Surfsky\",\"url\":\"https://docs.surfsky.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/llcfzecyberfinity/sOzW2rg1MprciyvQ/images/logo-light.svg?fit=max\u0026auto=format\u0026n=sOzW2rg1MprciyvQ\u0026q=85\u0026s=c6cc1d7d380cb1803815c2369dc6f6c2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.surfsky.io#website\",\"name\":\"Surfsky\",\"url\":\"https://docs.surfsky.io\",\"publisher\":{\"@id\":\"https://docs.surfsky.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.surfsky.io/api-reference/scrape/scrape-a-page#webpage\",\"url\":\"https://docs.surfsky.io/api-reference/scrape/scrape-a-page\",\"name\":\"Scrape a page\",\"description\":\"Load one page in a browser that is already running and return it in the requested formats. The browser runs behind a residential proxy of your region with a desktop fingerprint, solves the challenge pages and captchas it meets and keeps no cookies or storage between requests. One URL per request. A request is charged when its response carries the page: browser time in 10-second steps, plus the page's traffic and the captcha solves it uses. The amounts are in receipt. See Scraping API.\",\"dateModified\":\"2026-11-12T15:49:59.074Z\",\"isPartOf\":{\"@id\":\"https://docs.surfsky.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.surfsky.io/api-reference/scrape/scrape-a-page#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.surfsky.io/api-reference/scrape/scrape-a-page#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Surfsky\",\"item\":\"https://docs.surfsky.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Scrape a page\",\"item\":\"https://docs.surfsky.io/api-reference/scrape/scrape-a-page\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.surfsky.io/api-reference/scrape/scrape-a-page#apireference\",\"headline\":\"Scrape a page\",\"name\":\"Scrape a page\",\"description\":\"Load one page in a browser that is already running and return it in the requested formats. The browser runs behind a residential proxy of your region with a desktop fingerprint, solves the challenge pages and captchas it meets and keeps no cookies or storage between requests. One URL per request. A request is charged when its response carries the page: browser time in 10-second steps, plus the page's traffic and the captcha solves it uses. The amounts are in receipt. See Scraping API.\",\"url\":\"https://docs.surfsky.io/api-reference/scrape/scrape-a-page\",\"mainEntityOfPage\":{\"@id\":\"https://docs.surfsky.io/api-reference/scrape/scrape-a-page#webpage\"},\"dateModified\":\"2026-11-12T15:49:59.074Z\",\"publisher\":{\"@id\":\"https://docs.surfsky.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.surfsky.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Surfsky\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Surfsky\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/scrape/scrape-a-page.md","siteName":"Surfsky","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/sdk"}]},{"tab":"API reference","groups":[{"group":"Using the API","pages":[{"title":"API overview","href":"/api-reference"},{"title":"Errors","description":"Read API error responses, choose a retry policy, and diagnose request or browser failures.","href":"/errors"}]},{"group":"Scrape","pages":[{"title":"Scrape a page","deprecated":null,"version":null,"sidebarTitle":"Scrape a page","openapi":"/api-reference/openapi.json post /scrape","href":"/api-reference/scrape/scrape-a-page"}]},{"group":"Profiles","pages":[{"title":"Start one-time session","description":"Start a browser without a saved profile. The response returns connection fields at the top level. Use the returned internal_uuid to stop the session. Supply a proxy or VPN, or use a pool available to your account. Shared HTTP cache can be enabled separately from profile storage. See [the session guide](/sessions).","deprecated":null,"version":null,"sidebarTitle":"Start one time session","openapi":"/api-reference/openapi.json post /profiles/one_time","href":"/api-reference/profiles/start-one-time-session"},{"title":"Create profile","deprecated":null,"version":null,"sidebarTitle":"Create profile","openapi":"/api-reference/openapi.json post /profiles","href":"/api-reference/profiles/create-profile"},{"title":"List profiles","deprecated":null,"version":null,"sidebarTitle":"List profiles","openapi":"/api-reference/openapi.json get /profiles","href":"/api-reference/profiles/list-profiles"},{"title":"Get profile","deprecated":null,"version":null,"sidebarTitle":"Get profile","openapi":"/api-reference/openapi.json get /profiles/{profile_uuid}","href":"/api-reference/profiles/get-profile"},{"title":"Update profile","deprecated":null,"version":null,"sidebarTitle":"Update profile","openapi":"/api-reference/openapi.json patch /profiles/{profile_uuid}","href":"/api-reference/profiles/update-profile"},{"title":"Delete profile","deprecated":null,"version":null,"sidebarTitle":"Delete profile","openapi":"/api-reference/openapi.json delete /profiles/{profile_uuid}","href":"/api-reference/profiles/delete-profile"},{"title":"Delete profiles","deprecated":null,"version":null,"sidebarTitle":"Delete profiles","openapi":"/api-reference/openapi.json delete /profiles","href":"/api-reference/profiles/delete-profiles"},{"title":"Start profile","deprecated":null,"version":null,"sidebarTitle":"Start profile","openapi":"/api-reference/openapi.json post /profiles/{profile_uuid}/start","href":"/api-reference/profiles/start-profile"},{"title":"Stop session","deprecated":null,"version":null,"sidebarTitle":"Stop session","openapi":"/api-reference/openapi.json post /profiles/{internal_uuid}/stop","href":"/api-reference/profiles/stop-session"},{"title":"Stop all sessions","deprecated":null,"version":null,"sidebarTitle":"Stop all sessions","openapi":"/api-reference/openapi.json post /profiles/stop","href":"/api-reference/profiles/stop-all-sessions"},{"title":"List active sessions","deprecated":null,"version":null,"sidebarTitle":"List active sessions","openapi":"/api-reference/openapi.json get /profiles/active","href":"/api-reference/profiles/list-active-sessions"},{"title":"Scrape page","deprecated":null,"version":null,"sidebarTitle":"Scrape page","openapi":"/api-reference/openapi.json post /profiles/{internal_uuid}/scrape","href":"/api-reference/profiles/scrape-page"},{"title":"Export cookies","deprecated":null,"version":null,"sidebarTitle":"Export cookies","openapi":"/api-reference/openapi.json get /profiles/{profile_uuid}/cookies","href":"/api-reference/profiles/export-cookies"},{"title":"Import cookies","deprecated":null,"version":null,"sidebarTitle":"Import cookies","openapi":"/api-reference/openapi.json post /profiles/{profile_uuid}/cookies","href":"/api-reference/profiles/import-cookies"}]},{"group":"Proxies","pages":[{"title":"List proxy pools","deprecated":null,"version":null,"sidebarTitle":"List proxy pools","openapi":"/api-reference/openapi.json get /proxies/pools","href":"/api-reference/proxies/list-proxy-pools"},{"title":"List premium countries","deprecated":null,"version":null,"sidebarTitle":"List premium countries","openapi":"/api-reference/openapi.json get /proxies/countries","href":"/api-reference/proxies/list-premium-countries"},{"title":"List premium regions","deprecated":null,"version":null,"sidebarTitle":"List premium regions","openapi":"/api-reference/openapi.json get /proxies/regions/{country}","href":"/api-reference/proxies/list-premium-regions"},{"title":"List premium cities","deprecated":null,"version":null,"sidebarTitle":"List premium cities","openapi":"/api-reference/openapi.json get /proxies/cities/{country}/{region}","href":"/api-reference/proxies/list-premium-cities"},{"title":"List premium ASNs","deprecated":null,"version":null,"sidebarTitle":"List premium asns","openapi":"/api-reference/openapi.json get /proxies/asns/{country}","href":"/api-reference/proxies/list-premium-asns"},{"title":"List shared countries","deprecated":null,"version":null,"sidebarTitle":"List shared countries","openapi":"/api-reference/openapi.json get /proxies/shared/countries","href":"/api-reference/proxies/list-shared-countries"},{"title":"Get traffic quota","deprecated":null,"version":null,"sidebarTitle":"Get traffic quota","openapi":"/api-reference/openapi.json get /proxies/quota","href":"/api-reference/proxies/get-traffic-quota"},{"title":"Get premium quota","deprecated":null,"version":null,"sidebarTitle":"Get premium quota","openapi":"/api-reference/openapi.json get /proxies/premium/quota","href":"/api-reference/proxies/get-premium-quota"},{"title":"Get premium traffic stats","deprecated":null,"version":null,"sidebarTitle":"Get premium traffic stats","openapi":"/api-reference/openapi.json get /proxies/premium/stats","href":"/api-reference/proxies/get-premium-traffic-stats"},{"title":"Get shared quota","deprecated":null,"version":null,"sidebarTitle":"Get shared quota","openapi":"/api-reference/openapi.json get /proxies/shared/quota","href":"/api-reference/proxies/get-shared-quota"},{"title":"Get shared traffic stats","deprecated":null,"version":null,"sidebarTitle":"Get shared traffic stats","openapi":"/api-reference/openapi.json get /proxies/shared/stats","href":"/api-reference/proxies/get-shared-traffic-stats"}]},{"group":"Fingerprints","pages":[{"title":"List renderers","deprecated":null,"version":null,"sidebarTitle":"List renderers","openapi":"/api-reference/openapi.json get /fingerprint/renderers","href":"/api-reference/fingerprints/list-renderers"},{"title":"List screens","deprecated":null,"version":null,"sidebarTitle":"List screens","openapi":"/api-reference/openapi.json get /fingerprint/screens","href":"/api-reference/fingerprints/list-screens"},{"title":"List device models","deprecated":null,"version":null,"sidebarTitle":"List device models","openapi":"/api-reference/openapi.json get /fingerprint/device_models","href":"/api-reference/fingerprints/list-device-models"}]},{"group":"Extensions","pages":[{"title":"Upload extension","deprecated":null,"version":null,"sidebarTitle":"Upload extension","openapi":"/api-reference/openapi.json post /extensions","href":"/api-reference/extensions/upload-extension"},{"title":"List extensions","deprecated":null,"version":null,"sidebarTitle":"List extensions","openapi":"/api-reference/openapi.json get /extensions","href":"/api-reference/extensions/list-extensions"},{"title":"Get extension","deprecated":null,"version":null,"sidebarTitle":"Get extension","openapi":"/api-reference/openapi.json get /extensions/{extension_uuid}","href":"/api-reference/extensions/get-extension"},{"title":"Update extension","deprecated":null,"version":null,"sidebarTitle":"Update extension","openapi":"/api-reference/openapi.json patch /extensions/{extension_uuid}","href":"/api-reference/extensions/update-extension"},{"title":"Delete extension","deprecated":null,"version":null,"sidebarTitle":"Delete extension","openapi":"/api-reference/openapi.json delete /extensions/{extension_uuid}","href":"/api-reference/extensions/delete-extension"}]},{"group":"Statistics","pages":[{"title":"Get balance","deprecated":null,"version":null,"sidebarTitle":"Get balance","openapi":"/api-reference/openapi.json get /billing/balance","href":"/api-reference/billing/get-balance"},{"title":"Get usage","deprecated":null,"version":null,"sidebarTitle":"Get usage","openapi":"/api-reference/openapi.json get /billing/usage","href":"/api-reference/billing/get-usage"},{"title":"List session receipts","deprecated":null,"version":null,"sidebarTitle":"List session receipts","openapi":"/api-reference/openapi.json get /billing/sessions","href":"/api-reference/billing/list-session-receipts"},{"title":"Get session receipt","deprecated":null,"version":null,"sidebarTitle":"Get session receipt","openapi":"/api-reference/openapi.json get /billing/sessions/{session_uuid}","href":"/api-reference/billing/get-session-receipt"},{"title":"List ledger entries","deprecated":null,"version":null,"sidebarTitle":"List ledger entries","openapi":"/api-reference/openapi.json get /billing/ledger","href":"/api-reference/billing/list-ledger-entries"}]},{"group":"Site reports","pages":[{"title":"Report a blocked site","deprecated":null,"version":null,"sidebarTitle":"Report a blocked site","openapi":"/api-reference/openapi.json post /site-reports","href":"/api-reference/site-reports/report-a-blocked-site"}]}]}]},"basePath":"","title":"Scrape a page - Surfsky","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","CodeSnippet-eoRjC4Le.js","getApiPlaygroundDisplay-CZyAPlR2.js","Page-Cr9IwkK7.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}