Overview
One API for crawling, scraping, search, screenshots, and AI extraction. Bearer auth, JSON in, JSON out, optional streaming.
How it works
Every request runs three stages concurrently. A 500-page crawl typically completes in under 20 seconds. Every response includes a costs object and timing data so you can benchmark it yourself.
API Endpoints
All endpoints accept JSON and return JSON. Authenticate with a Bearer token.
| Method | Path | Description |
|---|---|---|
POST | /crawl | Start from a URL and follow links to discover and fetch multiple pages. |
POST | /scrape | Fetch a single page and return its content in any format. |
POST | /search | Search the web and optionally scrape the results. |
POST | /screenshot | Capture a full-page screenshot as base64 PNG. |
POST | /fetch/{domain}/{path} | AI-configured per-website scraper with cached configs. (Alpha) |
GET | /data/scraper-directory | Browse optimized scraper configs for popular websites. |
HTTP | proxy.spider.cloud | Route requests through intelligent residential and ISP proxies. |
WS | browser.spider.cloud | Connect a Playwright or Puppeteer client to a cloud browser via CDP. |
Request modes
Pick how Spider fetches each page. See Conceptsfor the trade-offs.
smartDefaulthttpFastbrowserJS / SPAProxy mode
Route any Spider request through proxy.spider.cloud and Spider picks the pool, rotates IPs, and handles geo-routing. Use country_code to target a country and proxy to pick a pool. Works with Crawl, Scrape, Screenshot, Search, and Links. See the Proxy API referencefor pricing.
residentialReal-user IPs across 100+ countries.ispStable datacenter IPs — highest throughput.Browser cloud
Full cloud browsers over a CDP WebSocket at wss://browser.spider.cloud/v1/browser?token=YOUR-API-KEY. Connect Playwright or Puppeteer with connectOverCDP(). Sessions include built-in stealth, proxy rotation, and optional session recording. 100 concurrent browsers on every plan. See the Browser API referenceor grab the spider-browsernpm package.
Credits
Usage is measured in credits at $1 per 10,000 credits. Each page has a base cost; Chrome rendering, proxy usage, and AI extraction add on top. Failed requests, timeouts, and blocked pages cost zero. Every response includes a costs object with a per-request breakdown — see the live balance on the usage page.
- developerspricingSpider Pricing and Plans: What You Pay and WhyA clear breakdown of Spider's pay-as-you-go pricing, per-endpoint costs, volume discounts, and how billing actually works for web scraping and browser automation.4 min
- developersself-hostingrustSelf-Hosting Spider: Using the Open Source Rust CrateBuild your own web crawler with the open source spider Rust crate. Quick start, Docker setup, configuration, and when to upgrade to the cloud API.5 min
- developersopen-sourcerustThe Spider Open Source EcosystemA guide to all open source Spider projects: the core crawler, browser client, HTML transformer, TLS fingerprinting, and more. Quick-start examples for each.5 min
- SERPweb-scrapingWeb Search API (SERP) - Search and ScrapeQuery the web and scrape results in one call with Spider's web search API. Covers parameters, geo-targeting, time filters, pagination, and code examples.5 min
- web-scrapingheadless-browsertechnologyScaling Headless Chrome for High-Performance ApplicationsPractical strategies for scaling headless Chrome, from container orchestration to Rust-based CDP handlers and ALB configuration.3 min
- discordAIDiscord Real-Time Data RetrievalSet up Spider Bot on your Discord server to fetch and analyze web data using slash commands.1 min
- AIBuild an AI Agent from ScratchBuild a research agent that searches the web with Spider, evaluates results, and forms answers with OpenAI.7 min
- developmentSet Up Automated Free Website Static SearchAdd full-text static search to any website using Spider and Pagefind.5 min
- AISpeedy Resilient Web Scraper for RAG AI: Part 1Choosing your scraper, cleaning HTML for RAG, deduplicating content, and testing on a single site before scaling up.8 min
- AISpeedy Resilient Web Scraper for RAG AI: Part 2Scaling web scraping for RAG pipelines. Error-first design, retry strategies, and handling failures at volume.15 min
- web-scrapingCrawling Authenticated PagesTwo methods for crawling pages behind login walls: cookies and execution scripts.2 min
- web-scrapingProxy Mode - HTTP, HTTPS & SOCKS5 EndpointsRoute scraping traffic through the Spider proxy over HTTP, HTTPS, or SOCKS5. Rotating datacenter and residential proxies, same credits as the standard API.2 min
- AIScrape & Crawl Agent with Microsoft's AutogenSet up an Autogen agent that scrapes and crawls websites using the Spider API.5 min
- outreachAutomated Cold Email Outreach Using SpiderExtract company info from inbound emails, scrape their website with Spider, and generate personalized replies with RAG.6 min
- AIStock Research Assistant Using crewAI and SpiderBuild a crewAI research pipeline that uses Spider to scrape financial data and write stock analysis reports.9 min
- AILangChain + Groq + Spider Integration GuideCrawl multiple URLs with Spider's LangChain loader, then summarize the results with Groq and Llama 3.5 min
- developersweb-scrapingWebsite ArchivingArchive web pages with Spider. Capture full page resources, automate regular crawls, and store content for long-term access.2 min
- outreachExtract LeadsExtract contact information from any website using Spider's AI-powered pipeline. Emails, phone numbers, and more.2 min
- developersweb-scrapingSpider API: Crawl, Scrape & Search the WebSpider API turns any URL into markdown, HTML, or JSON in one request. See endpoints, code examples, and how to start crawling or scraping the web today.3 min
- developersweb-scrapingWeb Crawling & Scraping with SpiderSet up Spider, run your first crawl, and scale your scraping to production with request modes, proxies, streaming, and clean markdown for LLM pipelines.5 min