# Scrapfly Documentation ## Table of Contents ### Dashboard - [Intro](https://scrapfly.io/docs) - [Project](https://scrapfly.io/docs/project) - [Account](https://scrapfly.io/docs/account) - [Workspace & Team](https://scrapfly.io/docs/workspace-and-team) - [Billing](https://scrapfly.io/docs/billing) ### Products #### MCP Server - [Getting Started](https://scrapfly.io/docs/mcp/getting-started) - [Tools & API Spec](https://scrapfly.io/docs/mcp/tools) - [Authentication](https://scrapfly.io/docs/mcp/authentication) - [Examples & Use Cases](https://scrapfly.io/docs/mcp/examples) - [FAQ](https://scrapfly.io/docs/mcp/faq) ##### Integrations - [Overview](https://scrapfly.io/docs/mcp/integrations) - [Claude Desktop](https://scrapfly.io/docs/mcp/integrations/claude-desktop) - [Claude Code](https://scrapfly.io/docs/mcp/integrations/claude-code) - [ChatGPT](https://scrapfly.io/docs/mcp/integrations/chatgpt) - [Cursor](https://scrapfly.io/docs/mcp/integrations/cursor) - [Cline](https://scrapfly.io/docs/mcp/integrations/cline) - [Windsurf](https://scrapfly.io/docs/mcp/integrations/windsurf) - [Zed](https://scrapfly.io/docs/mcp/integrations/zed) - [Roo Code](https://scrapfly.io/docs/mcp/integrations/roo-code) - [VS Code](https://scrapfly.io/docs/mcp/integrations/vscode) - [LangChain](https://scrapfly.io/docs/mcp/integrations/langchain) - [LlamaIndex](https://scrapfly.io/docs/mcp/integrations/llamaindex) - [CrewAI](https://scrapfly.io/docs/mcp/integrations/crewai) - [OpenAI](https://scrapfly.io/docs/mcp/integrations/openai) - [n8n](https://scrapfly.io/docs/mcp/integrations/n8n) - [Make](https://scrapfly.io/docs/mcp/integrations/make) - [Zapier](https://scrapfly.io/docs/mcp/integrations/zapier) - [Vapi AI](https://scrapfly.io/docs/mcp/integrations/vapi) - [Agent Builder](https://scrapfly.io/docs/mcp/integrations/agent-builder) - [Custom Client](https://scrapfly.io/docs/mcp/integrations/custom-client) #### Web Scraping API - [Getting Started](https://scrapfly.io/docs/scrape-api/getting-started) - [API Specification]() - [Monitoring](https://scrapfly.io/docs/monitoring) - [Customize Request](https://scrapfly.io/docs/scrape-api/custom) - [Debug](https://scrapfly.io/docs/scrape-api/debug) - [Unblocker (formerly ASP)](https://scrapfly.io/docs/scrape-api/unblocker) - [Proxy](https://scrapfly.io/docs/scrape-api/proxy) - [Proxy Mode](https://scrapfly.io/docs/scrape-api/proxy-mode) - [Proxy Mode - Screaming Frog](https://scrapfly.io/docs/scrape-api/proxy-mode/screaming-frog) - [Proxy Mode - Apify](https://scrapfly.io/docs/scrape-api/proxy-mode/apify) - [(Auto) Data Extraction](https://scrapfly.io/docs/scrape-api/extraction) - [Javascript Rendering](https://scrapfly.io/docs/scrape-api/javascript-rendering) - [Javascript Scenario](https://scrapfly.io/docs/scrape-api/javascript-scenario) - [SSL](https://scrapfly.io/docs/scrape-api/ssl) - [DNS](https://scrapfly.io/docs/scrape-api/dns) - [Cache](https://scrapfly.io/docs/scrape-api/cache) - [Batch (Multi-URL Scraping)](https://scrapfly.io/docs/scrape-api/batch) - [Session](https://scrapfly.io/docs/scrape-api/session) - [Webhook](https://scrapfly.io/docs/scrape-api/webhook) - [Schedule](https://scrapfly.io/docs/scrape-api/schedule) - [Screenshot](https://scrapfly.io/docs/scrape-api/screenshot) - [Errors](https://scrapfly.io/docs/scrape-api/errors) - [Timeout](https://scrapfly.io/docs/scrape-api/understand-timeout) - [Throttling](https://scrapfly.io/docs/throttling) - [Troubleshoot](https://scrapfly.io/docs/scrape-api/troubleshoot) - [Billing](https://scrapfly.io/docs/scrape-api/billing) - [FAQ](https://scrapfly.io/docs/scrape-api/faq) #### Crawler API - [Getting Started](https://scrapfly.io/docs/crawler-api/getting-started) - [API Specification]() - [Retrieving Results](https://scrapfly.io/docs/crawler-api/results) - [WARC Format](https://scrapfly.io/docs/crawler-api/warc-format) - [Data Extraction](https://scrapfly.io/docs/crawler-api/extraction-rules) - [Search](https://scrapfly.io/docs/crawler-api/search) - [Prompt & Extract](https://scrapfly.io/docs/crawler-api/prompt) - [Auto Refresh](https://scrapfly.io/docs/crawler-api/refresh) - [Webhook](https://scrapfly.io/docs/crawler-api/webhook) - [Schedule](https://scrapfly.io/docs/crawler-api/schedule) - [Billing](https://scrapfly.io/docs/crawler-api/billing) - [Errors](https://scrapfly.io/docs/crawler-api/errors) - [Troubleshoot](https://scrapfly.io/docs/crawler-api/troubleshoot) - [FAQ](https://scrapfly.io/docs/crawler-api/faq) #### Screenshot API - [Getting Started](https://scrapfly.io/docs/screenshot-api/getting-started) - [API Specification]() - [Accessibility Testing](https://scrapfly.io/docs/screenshot-api/accessibility) - [Webhook](https://scrapfly.io/docs/screenshot-api/webhook) - [Schedule](https://scrapfly.io/docs/screenshot-api/schedule) - [Billing](https://scrapfly.io/docs/screenshot-api/billing) - [Errors](https://scrapfly.io/docs/screenshot-api/errors) #### Extraction API - [Getting Started](https://scrapfly.io/docs/extraction-api/getting-started) - [API Specification]() - [Rules Template](https://scrapfly.io/docs/extraction-api/rules-and-template) - [LLM Extraction](https://scrapfly.io/docs/extraction-api/llm-prompt) - [AI Auto Extraction](https://scrapfly.io/docs/extraction-api/automatic-ai) - [Webhook](https://scrapfly.io/docs/extraction-api/webhook) - [Billing](https://scrapfly.io/docs/extraction-api/billing) - [Errors](https://scrapfly.io/docs/extraction-api/errors) - [FAQ](https://scrapfly.io/docs/extraction-api/faq) #### Data API #### Proxy Saver - [Getting Started](https://scrapfly.io/docs/proxy-saver/getting-started) - [Fingerprints](https://scrapfly.io/docs/proxy-saver/fingerprints) - [Optimizations](https://scrapfly.io/docs/proxy-saver/optimizations) - [SSL Certificates](https://scrapfly.io/docs/proxy-saver/certificates) - [Protocols](https://scrapfly.io/docs/proxy-saver/protocols) - [Pacfile](https://scrapfly.io/docs/proxy-saver/pacfile) - [Secure Credentials](https://scrapfly.io/docs/proxy-saver/security) - [Billing](https://scrapfly.io/docs/proxy-saver/billing) #### Cloud Browser API - [Getting Started](https://scrapfly.io/docs/cloud-browser-api/getting-started) - [Proxy & Geo-Targeting](https://scrapfly.io/docs/cloud-browser-api/proxy) - [Unblock API](https://scrapfly.io/docs/cloud-browser-api/unblock) - [Captcha Solver](https://scrapfly.io/docs/cloud-browser-api/captcha-solver) - [File Downloads](https://scrapfly.io/docs/cloud-browser-api/file-downloads) - [Session Resume](https://scrapfly.io/docs/cloud-browser-api/session-resume) - [Human-in-the-Loop](https://scrapfly.io/docs/cloud-browser-api/human-in-the-loop) - [Debug Mode](https://scrapfly.io/docs/cloud-browser-api/debug-mode) - [Browser Extensions](https://scrapfly.io/docs/cloud-browser-api/extensions) - [Credential Vault](https://scrapfly.io/docs/cloud-browser-api/credential-vault) - [Native Browser MCP](https://scrapfly.io/docs/cloud-browser-api/mcp) - [DevTools Protocol](https://scrapfly.io/docs/cloud-browser-api/cdp-reference) ##### Integrations - [Puppeteer](https://scrapfly.io/docs/cloud-browser-api/puppeteer) - [Playwright](https://scrapfly.io/docs/cloud-browser-api/playwright) - [Selenium](https://scrapfly.io/docs/cloud-browser-api/selenium) - [Vercel Agent Browser](https://scrapfly.io/docs/cloud-browser-api/agent-browser) - [Browser Use](https://scrapfly.io/docs/cloud-browser-api/browser-use) - [Stagehand](https://scrapfly.io/docs/cloud-browser-api/stagehand) - [1Password](https://scrapfly.io/docs/cloud-browser-api/1password) - [Billing](https://scrapfly.io/docs/cloud-browser-api/billing) - [Errors](https://scrapfly.io/docs/cloud-browser-api/errors) ### Tools - [Antibot Detector](https://scrapfly.io/docs/tools/antibot-detector) ### SDK - [Golang](https://scrapfly.io/docs/sdk/golang) - [Python](https://scrapfly.io/docs/sdk/python) - [Rust](https://scrapfly.io/docs/sdk/rust) - [TypeScript](https://scrapfly.io/docs/sdk/typescript) - [Scrapy](https://scrapfly.io/docs/sdk/scrapy) ### Integrations - [Getting Started](https://scrapfly.io/docs/integration/getting-started) - [LangChain](https://scrapfly.io/docs/integration/langchain) - [LlamaIndex](https://scrapfly.io/docs/integration/llamaindex) - [CrewAI](https://scrapfly.io/docs/integration/crewai) - [Zapier](https://scrapfly.io/docs/integration/zapier) - [Make](https://scrapfly.io/docs/integration/make) - [n8n](https://scrapfly.io/docs/integration/n8n) ### Academy - [Overview](https://scrapfly.io/academy) - [Web Scraping Overview](https://scrapfly.io/academy/scraping-overview) - [Tools](https://scrapfly.io/academy/tools-overview) - [Reverse Engineering](https://scrapfly.io/academy/reverse-engineering) - [Static Scraping](https://scrapfly.io/academy/static-scraping) - [HTML Parsing](https://scrapfly.io/academy/html-parsing) - [Dynamic Scraping](https://scrapfly.io/academy/dynamic-scraping) - [Hidden API Scraping](https://scrapfly.io/academy/hidden-api-scraping) - [Headless Browsers](https://scrapfly.io/academy/headless-browsers) - [Hidden Web Data](https://scrapfly.io/academy/hidden-web-data) - [JSON Parsing](https://scrapfly.io/academy/json-parsing) - [Data Processing](https://scrapfly.io/academy/data-processing) - [Scaling](https://scrapfly.io/academy/scaling) - [Walkthrough Summary](https://scrapfly.io/academy/walkthrough-summary) - [Scraper Blocking](https://scrapfly.io/academy/scraper-blocking) - [Proxies](https://scrapfly.io/academy/proxies) --- # Billing Overview [The billing page](https://scrapfly.io/dashboard/billing) provides an overview of your subscription, current invoice, past invoices, billing information, and existing credit card details. 1. 2. 3. ##### Overview Page ##### Invoices Page ##### Invoice Page [ Previous ](#doc_carousel) [ Next ](#doc_carousel) [See in Your dashboard](https://scrapfly.io/dashboard/billing) ## Payment Policy When you begin a subscription for the first time, we will charge you to validate your payment method. If the payment failed, you have 23 hours to complete the payment, or your subscription will be revoked. A draft invoice is created, which will be made for the next period, and [Pay As You Go](#extra_usage) for the current period will be added. > If your card supports 3D security, check your notification/emails to complete the authentication on the invoice page. When your subscription is renewed and the payment fails, your account is suspended, subject to the grace period of your plan described below, and our payment processor retries the charge over the following days. Nothing is deleted while the invoice is open. Adding a valid credit card and settling the invoice restores the account with all its configuration. If the invoice ends up terminal and unpaid, the subscription is downgraded to the free plan at that point. > A subscription carrying an unpaid invoice **cannot be cancelled**. Settle the outstanding invoice first, then cancel it if you want to. Cancelling is not a way to walk away from an invoice already issued. ## Credit & Coupon ### **Credit** Your account is credited when: - Your previous invoice was negative (you have credit) - Account Manager or Support credited your account manually - Service Interruption When credit is available, it's automatically applied to your next invoice. Credit is not transferable. #### **Coupon Code** Coupon codes give a discount that you can apply to a current paid subscription. A discount can have many dimensions such as: - Fixed prices or percentage of your total amount - Duration could be one or many months - Unique or multiple usages All information about the coupon is given when you received it > A coupon code can have an expiration date which makes it unusable. ## Account Balance and Top Up Your account balance holds prepaid funds. It is automatically applied to your next invoice, on top of any credit already granted on the account. For example, with a balance of $100 and a renewal invoice of $250, the invoice shows a $100 credit and you pay $150. If the invoice is smaller than the balance, the rest stays on your balance for the next invoice. You can add funds at any time, as many times as you need, from the [billing page](https://scrapfly.io/dashboard/billing) with the **Add Funds** button. The minimum top up is $50 and the charge goes to the payment method you select in the top up form. The button is shown on plans that allow Pay As You Go, to the workspace members allowed to add funds. A top up is also how you fund a Pay As You Go exception after your account reached the [extra usage limit](#extra-usage-limit-and-suspension). On accounts with prepaid Pay As You Go, **Auto Recharge** keeps the balance from running out. When enabled, and once your available balance falls below 10% of your accrued Pay As You Go cost, we charge your default payment method for the recharge amount. You can cap the total auto recharge per billing period, or leave it uncapped. > Some accounts require a balance to consume [Pay As You Go](#extra_usage) usage. On those accounts, requests over the monthly quota are rejected with [`ERR::SCRAPE::BALANCE_REQUIRED_FOR_EXTRA`](https://scrapfly.io/docs/scrape-api/error/ERR::SCRAPE::BALANCE_REQUIRED_FOR_EXTRA) (HTTP 429) while the balance does not cover the extra usage cost. ## Products The list of our paid product and their dedicated billing model. Our billing model is unified with the API Credit system. Each product will consume a certain amount of API Credit. - [Web Scraping API Billing](https://scrapfly.io/docs/scrape-api/billing) - [Screenshot API Billing](https://scrapfly.io/docs/screenshot-api/billing) - [Extraction API Billing](https://scrapfly.io/docs/extraction-api/billing) - [Crawler API Billing](https://scrapfly.io/docs/crawler-api/billing) ## Pay As You Go Scrapfly products do not have immediate hard limits to prevent breaking critical processes that rely on Scrapfly. Once the monthly included quota is reached, the Pay As You Go (PAYG) rate is applied. Pay as you go rate is applied in batches of 10,000 credits and is billed at the rate of your plan. ### **Extra usage limit and suspension** If your account was suspended because its extra usage reached the limit, you can get it enabled again in two ways: upgrade your plan, or ask for a Pay As You Go (PAYG) exception and pay for your extra usage in advance with a top up of your account balance. By default, paid plans that allow Pay As You Go have a hard limit to avoid any major issue: the extra usage of a billing period is capped to **50% of your monthly quota**. You receive a notification when you reach 100% of your quota to warn you. Accounts on a custom plan have no such cap, and accounts with prepaid extra usage are limited by their balance instead. Example: with 1,000,000 API Credits per month, you can use up to 500,000 API Credits on Pay As You Go, so a total of 1,500,000 credits. When the extra usage goes over the cap, the account is **suspended** and calls are refused with [`ERR::ACCOUNT::SUSPENDED`](https://scrapfly.io/docs/scrape-api/error/ERR::ACCOUNT::SUSPENDED) (HTTP 429). The suspension lifts at the renewal of your subscription. To keep scraping before that, you have two options: - **Upgrade your plan**: a higher plan includes a larger quota and the suspension is lifted immediately. See [Downgrade/Upgrade Plan](#change_plan). - **Ask for a Pay As You Go (PAYG) exception**: if the overage is a temporary spike, [contact support](https://scrapfly.io/docs/support) with the volume you expect until the renewal. The exception is granted rarely and a support agent reviews each request. Once approved, the account is unsuspended and its extra usage becomes **prepaid**: it is limited by your [account balance](#top_up) instead of the cap, and it stays prepaid after the renewal (contact support if you want to go back). Your balance must cover the cost of your extra usage, otherwise calls are refused with [`ERR::SCRAPE::BALANCE_REQUIRED_FOR_EXTRA`](https://scrapfly.io/docs/scrape-api/error/ERR::SCRAPE::BALANCE_REQUIRED_FOR_EXTRA) (HTTP 429): it has to cover the extra usage already accrued plus the usage you expect until the renewal. Support tells you the amount to deposit. To deposit the funds, use **Add Funds** on the [billing page](https://scrapfly.io/dashboard/billing) (top up your account balance). You can top up at any time and as many times as you need, for example when you do not know the full volume yet and fill the balance as you go. The minimum top up is $50. Once the exception is approved, **Auto Recharge** also appears there to keep the balance from running out. What is left on the balance is applied to your next invoice. See [Account Balance and Top Up](#top_up). On an ENTERPRISE plan reaching this limit, [contact us](https://scrapfly.io/docs/support) to create a custom plan. ### **Disable Pay As You Go (extra usage)** Pay As You Go, also called extra usage, is allowed or refused per project. To disable it, open the [projects page](https://scrapfly.io/dashboard/project), edit the project and uncheck **Allow PAG**. Once the monthly quota is reached, the calls of that project are refused with [`ERR::SCRAPE::PROJECT_QUOTA_LIMIT_REACHED`](https://scrapfly.io/docs/scrape-api/error/ERR::SCRAPE::PROJECT_QUOTA_LIMIT_REACHED) instead of being billed. Do it on every project that must not spend beyond the quota. To keep Pay As You Go but cap it, leave **Allow PAG** checked and set the project's **Budget Limit**: calls are refused with the same error once the project reaches it. ## Payment Issue & Graceful Period Following plan does not have a graceful period and will be **suspended immediately** if the payment fails: - DISCOVERY - PRO - STARTUP **ENTERPRISE** plan has a 7 days grace period, during which you can fix the payment issue without losing access to your account. **CUSTOM** plan has a 30 days grace period, during which you can fix the payment issue without losing access to your account. ## Manage Spending We offer a variety of tools to help you manage your spending and stay within your budget. Here are some of the ways you can do that: - [Project](https://scrapfly.io/docs/project) can be used to define a global limit Each Scrapfly project can be restricted with a specific credit budget and concurrency limits and you can disable Pay As You Go. - [Throttlers](https://scrapfly.io/docs/throttling) can be used to define limits per scraped website and timeframe Using Throttler's Spending Limit feature, each scrape target can be restricted with a specific credit budget for a given period. For example, you can set a budget of 10\_000 credits per day for website A and 100\_000 credits per month for website B. By using these features, you can better manage your spending and ensure that you stay within your budget when using our web scraping API. ## Downgrade/Upgrade Plan You can **upgrade** & **downgrade** your plan any time you want. We'll adjust the cost based on your remaining balances and show the difference on the invoice. > To downgrade to a lower plan, you must respect the quota of the desired plan. So downgrading might not be possible if you consumed more than the quota of the desired plan. ## Cancellation Cancellation is self-service. Open the [billing page](https://scrapfly.io/dashboard/billing), go to the **plan** card on the right, and click **Cancel subscription**. It is available at any time, needs no notice and no justification, and you get a confirmation email once it is recorded. > A subscription never stops on its own. It does not end at the end of a calendar month, when the quota runs out, or because the account sits unused, and **our support team does not cancel it for you**. A ticket, an email, a message to an account manager or the removal of your credit card is not a cancellation: the dashboard action is the only thing that stops the renewal. The subscription remains active and will stop at the end of the period, and you will be downgraded to a free plan automatically. During that period Pay As You Go is disabled, any credit left is lost at the renewal date, and you can abort the cancellation from the same page at any time before it takes effect. > When the system downgrades you to a lower plan, your configuration/project might be deleted automatically and arbitrarily by the system to fulfill the desired plan's quota. > > Don't forget to take action if you want to keep the configuration/plan. Two cases are not cancellable from the dashboard: - **Unpaid invoice**: an account suspended for a failed payment must settle the outstanding invoice first. - **Custom plan**: cancelled through your account manager, under the terms of its own contract. ## Refund Subscription fees and Pay As You Go charges are generally non-refundable. A refund may be granted when the request is made within **30 days** of the payment and usage over that period is **under 10%** of the quota the payment covers. On a yearly subscription the refund is **prorated**: the unused remainder of the year is refunded and the elapsed part is kept. Account top-ups and credit purchases are final and never refunded. Refunds are requested from support and reviewed case by case. The full wording is in the [Refund Policy](https://scrapfly.io/terms-of-service#refund-policy). Cancelling a subscription does not delete your account. Account deletion is self-service too, see [Closing your account](https://scrapfly.io/docs/account#delete).