Scrappey Web Scraper – Managed Browser & Proxy API
Pricing
Pay per usage
Scrappey Web Scraper – Managed Browser & Proxy API
Scrape data from modern, JavaScript-heavy web pages using the Scrappey.com API integrated with an Apify Actor. A robust solution for complex scraping scenarios — managed browser sessions, proxy rotation, and full browser automation.
Pricing
Pay per usage
Rating
5.0
(2)
Developer
Pim
Maintained by CommunityActor stats
10
Bookmarked
171
Total users
2
Monthly active users
14 days ago
Last modified
Categories
Share
Scrappey Web Scraper for Apify
A web scraping actor for reliable access to modern, JavaScript-heavy websites. Handles automated verification flows, managed browser sessions, proxy rotation, and full browser automation. Powered by the Scrappey.com API.
Features
- Managed Web Access - Reliably retrieve content from dynamic sites that require a real browser environment
- Verification Flow Handling - Automatically work through common challenge and verification steps where access is permitted
- Browser Automation - Full browser control with 20+ action types including click, type, scroll, and JavaScript execution
- Session Management - Maintain cookies and state across multiple requests
- Proxy Support - Built-in proxy rotation with country selection, premium, and mobile proxy options
- All HTTP Methods - Support for GET, POST, PUT, DELETE, and PATCH requests
- Data Extraction - CSS selectors, regex patterns, screenshots, and video recording
Quick Start
Input Configuration
{"scrappeyApiKey": "your-api-key","url": "https://example.com","cmd": "request.get"}
Get your API key at https://scrappey.com
Basic GET Request
{"scrappeyApiKey": "your-api-key","url": "https://httpbin.rs/get","cmd": "request.get"}
POST Request with Data
{"scrappeyApiKey": "your-api-key","url": "https://httpbin.rs/post","cmd": "request.post","postData": {"username": "user","password": "pass"}}
Browser Automation
{"scrappeyApiKey": "your-api-key","url": "https://example.com/login","browserActions": [{ "type": "wait_for_selector", "cssSelector": "#login-form" },{ "type": "type", "cssSelector": "#username", "text": "myuser" },{ "type": "type", "cssSelector": "#password", "text": "mypassword" },{ "type": "click", "cssSelector": "#submit", "waitForSelector": ".dashboard" }]}
Automatic Verification Handling
{"scrappeyApiKey": "your-api-key","url": "https://example.com","automaticallySolveCaptchas": true}
Geo-Targeted Requests
{"scrappeyApiKey": "your-api-key","url": "https://example.com","proxyCountry": "UnitedStates","premiumProxy": true}
Screenshot Capture
{"scrappeyApiKey": "your-api-key","url": "https://example.com","screenshot": true,"screenshotUpload": true}
Input Options
Required
| Option | Type | Description |
|---|---|---|
scrappeyApiKey | string | Your Scrappey API key |
url | string | Target URL |
HTTP Method
| Option | Type | Default | Description |
|---|---|---|---|
cmd | string | request.get | HTTP method: request.get, request.post, request.put, request.delete, request.patch |
postData | object | - | Request body for POST, PUT, PATCH |
requestType | string | browser | browser for full rendering, request for HTTP-only (faster) |
Proxy Configuration
| Option | Type | Description |
|---|---|---|
proxy | string | Custom proxy URL (http://user:pass@ip:port) |
proxyCountry | string | Request a proxy from a specific country (e.g., UnitedStates, Germany) |
premiumProxy | boolean | Use premium residential proxies |
mobileProxy | boolean | Use mobile carrier proxies |
Verification Handling
| Option | Type | Description |
|---|---|---|
automaticallySolveCaptchas | boolean | Automatically work through detected verification steps |
Response Options
| Option | Type | Description |
|---|---|---|
screenshot | boolean | Capture page screenshot |
screenshotUpload | boolean | Upload screenshot to storage |
video | boolean | Record browser session |
cssSelector | string | Extract content by CSS selector |
innerText | boolean | Include page text content |
includeImages | boolean | Include image URLs |
includeLinks | boolean | Include link URLs |
Session and Cookies
| Option | Type | Description |
|---|---|---|
session | string | Session ID for state persistence |
cookiejar | array | Cookies to set before request |
localStorage | object | Local storage data to set |
Output Data
{"url": "https://example.com","cmd": "request.get","verified": true,"statusCode": 200,"currentUrl": "https://example.com","userAgent": "Mozilla/5.0...","cookies": [],"cookieString": "","responseHeaders": {},"requestHeaders": {},"html": "<html>...</html>","innerText": "Page content...","ipInfo": {"country": "United States","city": "New York"},"session": "session-id","timeElapsed": 1234,"screenshot": "base64...","screenshotUrl": "https://...","timestamp": "2025-01-09T12:00:00.000Z"}
Browser Actions
Execute automated browser interactions:
| Action | Description |
|---|---|
click | Click an element |
type | Type text into input |
wait | Wait for milliseconds |
wait_for_selector | Wait for element to appear |
scroll | Scroll to element or bottom |
hover | Hover over element |
keyboard | Press keyboard keys |
dropdown | Select dropdown option |
execute_js | Run JavaScript code |
if | Conditional execution |
while | Loop execution |
goto | Navigate to URL |
Example: Login Flow
{"browserActions": [{ "type": "wait_for_selector", "cssSelector": "#login-form" },{ "type": "type", "cssSelector": "#email", "text": "user@example.com" },{ "type": "type", "cssSelector": "#password", "text": "password123" },{ "type": "click", "cssSelector": "#submit", "waitForSelector": ".dashboard" },{ "type": "execute_js", "code": "document.querySelector('.user-name').innerText" }]}
Error Codes
| Code | Description | Solution |
|---|---|---|
| CODE-0001 | Server overload | Retry with backoff |
| CODE-0002 | Request not completed | Try a different proxy |
| CODE-0007 | Proxy error | Check proxy credentials |
| CODE-0010 | Access not completed | Use a premium proxy |
| CODE-0029 | Too many sessions | Wait for cleanup |
| CODE-0032 | Verification not completed | Retry request |
Local Development
Setup
git clone https://github.com/pim97/apify-scrappeycd apify-scrappeynpm install
Run Locally
# Set input in storage/key_value_stores/default/INPUT.jsonnpm run start:dev
Run Tests
$npm test
Build
$npm run build
Deploy to Apify
apify loginapify push
CI/CD
The repository includes GitHub Actions for automatic deployment:
- Tests run on every push and pull request
- Deployment to Apify triggers on:
- Push to main/master branch
- New release published
Set APIFY_TOKEN secret in your repository settings.
Resources
Support
License
MIT License


