# Scrappey

> Scrappey is a pay-per-success web data API: JS rendering, headless browsing, CAPTCHA solving, proxy rotation, and session management behind a single endpoint.

The complete documentation as a single markdown file is available at https://docs.scrappey.com/llms-full.txt. Each page below is also available as raw markdown by prefixing its path with https://docs.scrappey.com/md/.

## Getting Started

- [Welcome to Scrappey](https://docs.scrappey.com/md/welcome): An introduction to Scrappey.com, a web data and browser-automation API returning HTML, cookies, screenshots, and structured data via managed browser sessions.
- [Getting Started](https://docs.scrappey.com/md/getting-started/introduction): An overview of Scrappey.com — a browser-based access proxy that returns rendered HTML and cookies through managed browser sessions.

## API Reference

- [Profiles](https://docs.scrappey.com/md/profiles): Attach a profileId to any request to persist browser configuration, cookies, proxy, and session data across multiple requests.
- [Making Requests](https://docs.scrappey.com/md/api-reference/requests): Send requests through Scrappey by POSTing a URL and optional headers, cookies, or proxy to the API endpoint.
- [Screenshot](https://docs.scrappey.com/md/screenshot): Capture a full-page browser screenshot as base64 or an uploaded public URL, with optional viewport sizing and cookie-banner blocking.
- [request.post](https://docs.scrappey.com/md/request-post): Send a POST request through a real browser session with a form-encoded or JSON body.
- [request.get](https://docs.scrappey.com/md/request-get): Send a GET request through a real browser session with full support for cookies, proxies, local storage, and custom headers.
- [sessions.destroy](https://docs.scrappey.com/md/sessions-destroy): Destroy an active browser session to free resources and prevent session or memory limit overruns.
- [sessions.create](https://docs.scrappey.com/md/sessions-create): Start a persistent browser session that retains cookies and reduces repeated setup work across multi-step browser workflows.
- [proxyCountry](https://docs.scrappey.com/md/proxy-country): All accepted proxyCountry values for targeting Scrappey's rotating proxies to a specific country.
- [request.[others]](https://docs.scrappey.com/md/request-others): Send PUT, DELETE, PATCH, or PUBLISH HTTP requests through a real browser session using the same structure as request.post.
- [Remaining balance](https://docs.scrappey.com/md/remaining-balance): Check how many requests remain in your Scrappey account balance with a simple GET request.
- [Session Management](https://docs.scrappey.com/md/api-reference/sessions): Create and destroy persistent browser sessions that retain cookies and browser state so you avoid repeated setup on every request.
- [Concurrency limits](https://docs.scrappey.com/md/concurrency-limits): Learn how many concurrent threads your Scrappey account supports and how to request higher limits.

## Guides

- [Wrappers](https://docs.scrappey.com/md/wrappers): Use the official Python or Node.js wrapper to integrate Scrappey into your project with minimal boilerplate.
- [Wait For Load State](https://docs.scrappey.com/md/wait-for-load-state): Pause browser execution until a specific load state is reached before continuing with actions or data extraction.
- [Direct Request](https://docs.scrappey.com/md/direct-http-request): Make a lightweight HTTP GET request with browser-compatible TLS settings, without launching a full browser.
- [Browser request](https://docs.scrappey.com/md/browser-request): Execute a fully rendered browser request to handle anti-bot mechanisms and access dynamic or JavaScript-heavy content.
- [Json Post Request](https://docs.scrappey.com/md/json-post-request): Send structured JSON payloads to any endpoint using a real browser session with request.post.
- [Post Request](https://docs.scrappey.com/md/post-request): Send a POST request with form-encoded or JSON body to a target URL through a real browser session.
- [Retry](https://docs.scrappey.com/md/retry): Automatically retry a failed request up to 5 times to improve success rates against timeouts, captchas, or network instability.
- [Add Referer](https://docs.scrappey.com/md/add-referer): Simulate natural browser navigation by adding a referer to your POST request to satisfy anti-bot systems.
- [Record Video](https://docs.scrappey.com/md/record-video): Enable session video recording to capture and replay browser behavior for debugging and traceability.
- [Mouse Movements](https://docs.scrappey.com/md/mouse-movements): Simulate realistic human mouse movement patterns during page rendering to better emulate real user behavior.
- [Mobile Proxy](https://docs.scrappey.com/md/mobile-proxy): Route requests through real 4G/5G mobile carrier IPs to satisfy strict anti-bot measures that track IP reputation.
- [Datacenter Proxy](https://docs.scrappey.com/md/datacenter-proxy): Route requests through a datacenter proxy for faster, lower-cost scraping when anti-bot detection is not a concern.
- [Premium Proxy](https://docs.scrappey.com/md/premium-proxy): Route requests through high-quality residential IPs to handle region restrictions and stricter anti-bot systems.
- [Wait For Url Load](https://docs.scrappey.com/md/wait-for-url-load): Pause browser execution until a specific URL substring is loaded, ensuring page transitions complete before continuing.
- [Intercept XHR Request](https://docs.scrappey.com/md/intercept-xhr): Capture and return the responses of specific fetch() or XHR requests made during a page load using interceptFetchRequest.
- [Deepseek Autoparse](https://docs.scrappey.com/md/deepseek-autoparse): Use the DeepSeek LLM to parse web content and return structured JSON directly from any page.
- [Autoparse](https://docs.scrappey.com/md/autoparse): Automatically parse structured data from any web page using AI — no selectors required.
- [Wait For Function](https://docs.scrappey.com/md/wait-for-function): Pause browser execution until a custom JavaScript expression evaluates to true, with configurable timeout.
- [Dropdown Action](https://docs.scrappey.com/md/dropdown-action): Select an option from a dropdown element on a webpage using a CSS selector with an index or value.
- [Click Action](https://docs.scrappey.com/md/click-action): Simulate a click on a specific page element inside a real browser session using a CSS selector or XPath.
- [Type Actions](https://docs.scrappey.com/md/type-action): Type text into a selected input field on a webpage using the type browser action.
- [Discord Login](https://docs.scrappey.com/md/discord-login): Authenticate with Discord inside a browser session by injecting an authorization token via the discord_login browser action.
- [Go To](https://docs.scrappey.com/md/go-to): Navigate the browser to a new URL during a scraping flow using the goto browser action.
- [Wait For Selector](https://docs.scrappey.com/md/wait-for-selector): Pause browser execution until a specific CSS selector appears in the DOM, with optional timeout and error handling.
- [Wait](https://docs.scrappey.com/md/wait): Pause browser action execution for a specified number of seconds to allow dynamic content, animations, or cooldowns to complete.
- [Execute Javascript](https://docs.scrappey.com/md/execute-javascript): Run custom JavaScript code directly within the page context during a Scrappey browser session.
- [Keyboard](https://docs.scrappey.com/md/keyboard): Simulate keyboard key presses such as Enter, Tab, or Arrow keys during a browser session.
- [Scroll](https://docs.scrappey.com/md/scroll): Simulate scrolling to an element or the bottom of the page to trigger lazy-loaded content during automation.
- [While Loop](https://docs.scrappey.com/md/while-loop): Repeat browser actions in a loop until a JavaScript condition evaluates to false.
- [Conditional](https://docs.scrappey.com/md/conditional): Execute different browser actions based on JavaScript conditions evaluated in the page context.
- [Error Codes](https://docs.scrappey.com/md/guides/error-codes): Reference table of all Scrappey error codes with causes and remediation steps.
- [Browser Actions](https://docs.scrappey.com/md/guides/browser-actions): Automate browser interactions like clicking, typing, scrolling, and solving captchas using the browserActions array.