FAQ
Frequently asked questions
Signup, pricing, migrating from ScrapingBee, limits, and what we do with what you send us. If something is missing, ask and we'll add it here.
Getting started
Do I need a credit card to sign up?
No. A free account starts with 1,000 credits, gets 250 more every month, and needs only a working email address. We send a six-digit code to confirm it, and that is the entire signup.
How is the free account different from a trial?
It keeps going. You start with 1,000 credits, and 250 more arrive on the 1st of every month for as long as the account exists, banking up to 1,000 if you do not use them. ScrapingBee's comparable free tier is a single 1,000-credit balance that is not replaced once it is spent.
What happens to my free credits if I upgrade, or cancel?
Upgrade while signed in to your key portal, or pay with the same email address, and you keep the same API key, so nothing changes in your code. A paid plan starts its own monthly allowance, and the free balance does not carry over, so there is no point saving it up first. One-time bonus credits from a promo code stay with the key. If you cancel a paid plan, your key keeps working to the end of the period you paid for, then drops back to the free tier, starting again at 1,000 credits with 250 more each month. If a payment fails, the plan keeps working for 72 hours while you fix it in PayPal, and we email you each day.
Can I see it work before creating an account?
Yes. The demo on the home page runs a real scrape against any URL you give it, on the same engine the API uses. No key is asked for, and the page it fetches is not stored.
Migrating from ScrapingBee
What changes when I switch?
The base URL and the key. Change https://app.scrapingbee.com/api/v1/ to https://api.webfetch.io/v1/, use a webfetch key, and the rest of the request is unchanged: every parameter keeps its name, type and default, and the credit table is identical. Read Wf- response headers instead of Spb-.
Are any parameters named the same but behave differently?
The two proxy parameters map to different pools. ScrapingBee's premium_proxy is residential; ours routes static ISP proxies, addresses registered to internet providers that sites trust more than datacenter IPs. Their stealth_proxy is a separate pool with anti-bot hardening (they do not publish the proxy type); ours routes datacenter exits (ISP exits when a site refuses) in a browser hardened against headless detection. See the full comparison.
What is not implemented yet?
The AI extraction parameters (ai_query, ai_extract_rules, ai_selector) and scraping_config. Sending one is reported in Wf-Unknown-Parameters rather than silently ignored, so a call that depends on one fails visibly.
Is there a search API?
Yes, for Google, Bing, Yahoo and Brave, at /api/v1/google and /api/v1/bing and /api/v1/yahoo and /api/v1/brave. They take the parameters of ScrapingBee's Google Search API and return its JSON: ranked organic results, top and bottom ads, related searches and questions. search_type=ads returns the ads only. A light request costs 10 credits and a regular one 15, on every engine. Because every engine's robots.txt disallows its result pages, search needs the robots.txt opt-out on for the key: paid plans turn it on in the key portal, and free accounts request it there, which a person approves. See the Search API overview and reference, or run a search from Scan.
Pricing and billing
How does billing work?
Plans are billed monthly in advance through PayPal. Cancel any time; access continues to the end of the period already paid for, then the key drops back to the free tier, starting again at 1,000 credits. Canceling does not refund a partial month.
Can I change to another plan?
Yes, from your key portal, and your key and renewal date stay the same. Moving up takes effect at once, and you pay only the difference between the two prices for the days left in the current billing period; the new price applies from your next renewal. Moving down takes effect on your next renewal date, with nothing charged now. PayPal shows the amount before you approve it.
Do you offer refunds?
A failed request is never billed in the first place, so there is nothing to refund there. Outside of that: a normal cancellation is not refunded for the unused part of the current period, and an account closed for an acceptable-use breach also ends without a refund for the remainder of the period. See the terms of service.
What does "price locked for life" commit to?
The price you sign up at is the price you keep, for as long as your payment method stays active and the subscription does not lapse. Cancel, or leave a failed payment unfixed for 72 hours, and the lock goes with it; rejoining later is at the price of the day.
Do unused credits roll over to next month?
On a paid plan, no: the allowance resets each month on your renewal date, the day PayPal bills your plan. On the free tier, yes, up to a point: the balance carries over and grows by 250 on the 1st of each month, but stops growing at 1,000. Bonus credits from a signup promo code are separate: one-time, spent only after the free balance or the monthly allowance runs out, and they survive a reset until used. Remaining bonus balance is reported in Wf-Bonus-Credits.
Limits, proxies and rendering
How many requests can I run at once?
A concurrency ceiling per plan: 5 on the free tier, 25 on Starter, up to 400 on Business+. It is a per-key ceiling on simultaneous in-flight requests, and a render_js=false call never holds a slot at all because it never launches a browser.
Can a free request be turned away when the service is busy?
Yes. The free tier is best effort. When paid traffic is heavy and open capacity falls to the share held back for paying customers, a free request gets HTTP 503 with code free_tier_busy and a Retry-After header, usually 30 seconds. Nothing is charged, and it never happens the other way round: paid plans are not turned away to make room for free traffic.
Is there a limit on hitting the same target repeatedly?
Yes, independent of your plan's concurrency. Requests to a single target host are capped per key and across all callers combined, so pointing many keys at one site to get around the limit does not work and is itself a breach of the acceptable use policy.
How much data can one scrape return?
A bandwidth ceiling measured on the wire, not on the returned document, so the assets a page loads count toward it: 5 MB through the stealth pool, 25 MB everywhere else. A page that reaches it still returns what was captured, billed normally, marked Wf-Truncated. Ordinary pages are nowhere near either ceiling.
Can I turn off robots.txt compliance?
On paid plans, yes, with respect_robots=false. It needs a paid plan and the robots.txt opt-out turned on for that key in the key portal, which records your acceptance of the acceptable use policy. It is off until you turn it on, and every use of it is logged per request. The same opt-out turns on the search endpoints. It does not create permission you did not otherwise have. The responsibility for that decision moves onto the key that made it.
Data and support
Do you store the pages I scrape?
No. The response body is streamed back to you and discarded; we do not retain it. A screenshot you ask for is the exception: it is stored for 30 days at an unguessable link, so you can download it. We keep the request's URL, host and outcome, and the IP address it came from, for up to 45 days, for billing and abuse handling. See the privacy page for the complete table.
Who is webfetch.io run by?
Tuxxin LLC, which also operates webshot.site, a screenshot service. More on the about page.
How do I report abuse coming from webfetch?
Email [email protected] with the target host, timestamps with a timezone, and a sample of the requests. We act against the responsible key, and you can ask to have your domain refused for every customer rather than just the one that hit you.
Didn't find it?
The documentation covers every parameter in full; the contact form reaches the team running the API.