Understanding credits

​

Credit costs per service

​

Proxy modifiers

​

Checking your credit balance

• Remaining credits for your current billing period
• Usage history broken down by service and date

from scrapegraph_py import ScrapeGraphAI

sgai = ScrapeGraphAI()

res = sgai.credits()
if res.status == "success":
    print(f"Remaining credits: {res.data.remaining}")

import { ScrapeGraphAI } from "scrapegraph-js";

const sgai = ScrapeGraphAI();

const res = await sgai.credits();
if (res.status === "success") {
  console.log(`Remaining credits: ${res.data?.remaining}`);
}

​

What happens when you run out of credits?

{
  "error": "insufficient_credits",
  "message": "You have run out of credits. Please upgrade your plan or wait for the next billing cycle."
}

​

Tips to reduce credit usage

• Cache results for URLs that don’t change frequently to avoid re-scraping.
• Use scrape with MarkdownFormatConfig instead of extract when you only need the page content in a readable format and don’t need structured extraction — it’s 1 credit vs. 5.
• Limit crawl scope in crawl.start by setting max_depth and max_pages to avoid accidentally crawling more pages than needed.