Documentation
Welcome to Scrappey
Documentation for the Scrappey web data API. Guides, API references, and copy-paste examples for pay-per-success requests β JS rendering, headless browsing, and session management behind a single API, for content you are authorized to access.
- 150
- Free requests to start
- $0
- Charged on failed requests
- No
- Subscription required
- β
- Balance never expires
Scrappey.com handles the operational side of web data collection β session management, proxy rotation, and headless browser rendering β behind a single API, so you can focus on the content you are authorized to collect. The guides, API reference, and copy-paste examples below cover everything you need to integrate.
Why Scrappey
Built for builders
Robust Data API
A production-grade API that handles session management, proxy rotation, and headless browser rendering so your pipeline stays stable on complex, JS-heavy sites.
Headless Browsing
Reach sites that require cookies, interaction, or multi-step flows. Automate real browser interactions for forms and navigation on content you are authorized to access.
Pay Per Success
No subscription. Failed requests are free, your balance never expires, and you can stop any time β transparent, usage-based pricing.
Integrations
Plug Scrappey into your stack
Drop Scrappey into Claude Code, LangChain, LlamaIndex, n8n, Make, Zapier, Apify, and RapidAPI. Same pay-as-you-go pricing across every integration β use it only for data you are authorized to collect.
n8n
Workflow Automation
Automate data collection across 1,000+ apps with visual workflows. Pre-authenticated Scrappey node.
n8n Template
Ready-to-Use Workflow
Pre-built workflow for collecting data from dynamic, JS-heavy pages you are authorized to access β import and run in seconds.
Make
Automation Platform
Connect Scrappey with 1,000+ apps inside Make's visual scenario builder. No code required.
Zapier
Automation Platform
Wire Scrappey into 7,000+ apps through Zapier. Trigger authorized data collection on a schedule, on webhook, or from any Zap.
LangChain
AI Framework
Official Scrappey connector for LangChain. Drop browser-rendered page retrieval into any chain or agent β clean text ready for your LLM, for content you are authorized to access.
npm install @scrappey/langchainimport { ScrappeyLoader } from "@scrappey/langchain";
const loader = new ScrappeyLoader({
apiKey: process.env.SCRAPPEY_API_KEY!,
url: "https://example.com",
});
const docs = await loader.load();
// β docs[0].pageContent is clean text your LLM can reason overLlamaIndex
RAG Data Loader
LlamaIndex reader that ingests dynamic, JS-heavy pages you are authorized to access straight into your RAG pipeline. Returns Document objects ready to embed.
pip install llama-index-readers-scrappeyfrom llama_index_readers_scrappey import ScrappeyReader
reader = ScrappeyReader(api_key="YOUR_KEY")
docs = reader.load_data(urls=["https://example.com"])
# β docs is a list of llama_index Document objectsClaude Code Skill
AI Agent Skill
Portable SKILL.md bundle that gives Claude Code (and any SKILL.md-compatible agent) browser-rendered page retrieval out of the box β for content you are authorized to collect.
# Drop the skill into your Claude Code skills folder
git clone https://github.com/pim97/scrappey-skill \
~/.claude/skills/scrappey
# Set your API key
export SCRAPPEY_API_KEY="your_key_here"MCP Server
AI Integration
MCP server that bridges any MCP-compatible AI model (Claude, Cursor, etc.) with Scrappey browser automation and session management.
{
"mcpServers": {
"scrappey": {
"command": "npx",
"args": ["-y", "mcp-server-scrappey"],
"env": { "SCRAPPEY_API_KEY": "your_key_here" }
}
}
}Apify
Actor Platform
Scrappey as an Apify actor. Combine browser rendering with Apify's job infrastructure for scalable, authorized data collection.
RapidAPI
API Marketplace
Access Scrappey through RapidAPI with unified authentication and the RapidAPI dashboard.
Glossary
Explore the concepts
Every web-scraping term we use across the docs, linked to the concepts it depends on β 151 terms Β· 407 connections. Search the map, filter by category, and click a node to preview its definition.
Latest updates
Recently Updated
Anti-Bot Handling
> Scrappey combines real browser sessions, proxy rotation, and built-in CAPTCHA solving to handle a wide range of anti-bot protections on the web. Webs...
Error Codes
> Reference table of all Scrappey error codes, their error messages, and what to do when you encounter them. When a request fails, the response has...
Example Use Cases
> A collection of real-world open-source scrapers and automation scripts built with Scrappey, covering industries from SEO and real estate to gaming...
Wrappers
> Use the official Python or Node.js wrapper to interact with the Scrappey API without writing raw HTTP calls. Scrappey offers official wrappers for...
Concurrency limits
> Scrappey gives new accounts up to 200 concurrent threads by default and scales automatically up to 1000, with higher limits available on request. Scr...
Session Management
> Create and destroy persistent browser sessions that retain cookies and browser state, reducing repeated setup and overhead for subsequent requests. T...
Ethics
Responsible use
Scrappey.com is committed to legitimate, lawful use of our service. We strictly prohibit activity that infringes on others' rights, including cybercrime, unauthorized access, and fraud. Accounts found violating our Terms of Service are suspended.
Our platform is built for legitimate business use cases β SEO monitoring, ad verification, market research, price aggregation, academic research, and other lawful data collection where the user has authorization from the content owner or is otherwise permitted by applicable law.
If you believe our service has been used in a way that violates your rights, please contact us with the details. Once verified, we will terminate the offending account's access and cooperate with legitimate requests to the extent permitted by law.
To report abuse or for any inquiries:
[email protected]All pages
Browse the full documentation
Every page in the docs, grouped by section β 64 pages across 4 categories.
Guides
- Example Use Cases
- Wrappers
- Start Captcha Listener
- Wait For Load State
- Direct Request
- Browser request
- Json Post Request
- Post Request
- Retry
- Add Referer
- Record Video
- Mouse Movements
- Mobile Proxy
- Datacenter Proxy
- Premium Proxy
- Wait For Url Load
- Intercept XHR Request
- Deepseek Autoparse
- Autoparse
- Wait For Function
- Dropdown Action
- Click Action
- Type Actions
- Discord Login
- Go To
- Wait For Selector
- Wait
- Solve Captcha
- Execute Javascript
- Keyboard
- Scroll
- While Loop
- Conditional
- Error Codes
- Browser Actions
Get started
Ship your first request today
Start with 150 free requests β no credit card, no subscription.
