# Scrappey

> Scrappey is an HTTP API for programmatic web data retrieval. A single endpoint accepts JSON requests and returns structured JSON responses, with support for JavaScript rendering, headless browser automation, configurable proxy routing, geographic targeting, and persistent sessions across requests.

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, an authorized browser-workflow API returning rendered HTML, cookies, screenshots, and structured data.
- [Getting Started](https://docs.scrappey.com/md/getting-started/introduction): An overview of Scrappey.com, an authorized browser-workflow 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 consistent 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 render dynamic or JavaScript-heavy content with session reliability for authorized workflows.
- [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 session reliability against timeouts, verification flows, or network instability.
- [Add Referer](https://docs.scrappey.com/md/add-referer): Add a Referer header to your POST request to reflect the navigation path during authorized browser workflows.
- [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): Perform pointer movement actions during authorized browser workflows.
- [Mobile Proxy](https://docs.scrappey.com/md/mobile-proxy): Route requests through real 4G/5G mobile carrier IPs to preserve expected browser navigation context on sites that track IP reputation.
- [Datacenter Proxy](https://docs.scrappey.com/md/datacenter-proxy): Route requests through a datacenter proxy for faster, lower-cost authorized workflows where residential IP reputation is not required.
- [Premium Proxy](https://docs.scrappey.com/md/premium-proxy): Route requests through high-quality residential IPs to handle region restrictions and verification flows during authorized browser workflows.
- [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): Inspect permitted network responses generated by authorized browser sessions by capturing specific fetch() or XHR requests during a page load.
- [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.
- [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 waiting using the browserActions array.