Web Scraping API

Web Scraping API

Fetch any public page through one production-ready API. JoyProxy routes traffic across 200+ markets with residential and mobile IPs, emulates real browsers, maintains authenticated sessions, renders JavaScript when needed, and ships structured connectors for Amazon, Google, and YouTube. Credits apply only to successful responses.

Success-only billing Global resi & mobile IPs Intelligent anti-bot bypass Browser emulation & sessions Dynamic page rendering Amazon, Google & YouTube APIs

What is the Web Scraping API?

JoyProxy Web Scraping API is an AI-powered managed scraping API — not a raw proxy list. You send a target URL; we return clean HTML or JSON after handling blocks, fingerprints, and retries on our side.

Unlike rotating proxies, you do not manage headers, sessions, CAPTCHAs, or browser farms.

Ideal when you need production-grade access to public pages without building an anti-bot stack.

From URL to data in one request

1. Buy credits

Purchase an API credit pack from your account balance. Credits never expire.

2. Call the API

Copy your Scraping API Token from API Center and call GET /v1/fetch with the target URL.

3. We unblock

Our stack selects proxies, sets browser fingerprints, renders JS if needed, and retries on failure.

4. Pay on success

Credits are deducted only when the page is successfully retrieved. Failed attempts cost nothing.

Built for real scraping workflows

Anti-bot & WAF bypass

Cloudflare, PerimeterX, and similar protections handled automatically.

JavaScript rendering

Add render=true for SPAs and dynamic content without running your own headless browser.

Residential & mobile IPs

Use super=true for tougher sites that need real-user network signals.

Geo targeting

Pass geoCode=us (or any supported country) for localized results.

Success-based billing

No charge for timeouts, blocks, or empty failures — only successful responses.

Dedicated Scraping API Token

A separate token scoped to /v1/fetch — not shared with proxy extraction or account APIs.

Who uses the Web Scraping API?

E-commerce & pricing

Monitor competitor prices, stock, and catalog pages at scale.

SEO & SERP

Collect rankings, snippets, and localized search results.

Market research

Aggregate public listings, reviews, and directory data.

AI & data pipelines

Feed clean HTML into LLM or ETL workflows without maintaining scrapers.

Important optional parameters

Fine-tune every request without managing proxies, sessions, or browser farms yourself.

ParameterWhat it does
super=trueResidential / mobile IPs for tougher anti-bot sites (10 credits).
geoCodeCountry-level exit IP — 150+ ISO codes (e.g. us, gb, de).
regionalGeoCodeRegional cluster when country is not enough (e.g. eu, asia).
sessionIdSticky session for multi-step flows (login → checkout).
deviceBrowser fingerprint: desktop, mobile, or tablet.
customHeaders + targetHeadersSend custom HTTP headers to the target (GET or POST).
setCookiesInject cookies before the request (logged-in pages).
timeout / retryTimeoutControl how long we wait and retry slow targets.
disableRetryFail fast instead of automatic retries.
outputReturn raw HTML or markdown for LLM pipelines.
transparentResponsePass through target status codes and response headers.

JavaScript render parameters

Set render=true (5 credits), then combine these options for SPAs, lazy-loaded content, and protected pages.

ParameterWhat it does
waitUntilWait for load, DOMContentLoaded, or network idle before capture.
customWaitExtra delay in milliseconds after the page is ready.
waitSelectorWait until a CSS selector appears (e.g. .product-price).
width / heightViewport size for responsive layouts (default 1920×1080).
blockResourcesSkip images, fonts, and ads for faster renders.
returnJSONStructured JSON with HTML, status, and metadata.
screenShotCapture a viewport screenshot (base64 in response).
fullScreenShotFull-page screenshot including below-the-fold content.
particularScreenShotScreenshot a specific element by CSS selector.
playWithBrowserAutomation macros — click, scroll, type before capture.

Built-in scraping plugins

Skip fragile HTML parsing — call dedicated endpoints and get clean JSON from major platforms.

Amazon

from 1 credit / request

Product, pricing, and search data with marketplace geo and zip targeting.

  • PDP — product detail by ASIN
  • Offer listing — sellers & buy-box
  • Search — keyword results with pagination
  • Raw HTML — full page when you need markup
Open API Center playground →

Google suite

from 10 credits / request

SERP, maps, travel, news, and commerce — localized with hl/gl parameters.

  • Search & AI Mode
  • Maps — search, place, reviews
  • Hotels, Flights, Shopping
  • News, Trends, Play Store & more
Open API Center playground →

YouTube

from 10 credits / request

Video search with filters, localization, and pagination — no player scraping.

  • Search by query with sort & filter (sp)
  • hl / gl — language & country
  • device — desktop or mobile results
  • next_page_token for deep pagination
Open API Center playground →

API credit packs

Seven preset packs plus custom volume — from $5 ($0.50/1K) to $1,500 Scale (15M credits, 200 concurrent). Credits never expire.

Credit consumption per successful request

Complexity multipliers apply only when the request succeeds.

Request typeCredits
Standard (datacenter)1 credit
JavaScript rendering (render=true)5 credits
Residential / mobile (super=true)10 credits
Super + render (protected sites)25 credits

Ready to scrape?

Open the Web Scraping API console to buy credits, test in API Center, and copy API examples.

Go to console