Skip to main content

Transition from v1 to v2

Once you log in, your v1 code will be deprecated in 7 days. The legacy dashboard at dashboard.scrapegraphai.com/login will remain temporarily available during the transition.
If you are coming from the legacy v1 docs, use this page as your migration checkpoint. Before anything else, log in to the dashboard at scrapegraphai.com/login.

Method-by-method migration

Use this table to map old entry points to new ones. Details and examples follow below.

Code-level transition

1. Markdownify → scrape

Before: markdownify(url). After: scrape(url, format="markdown") (Python) or scrape(url, { format: "markdown" }) (JS).

2. SmartScraper → extract

Before (v1): website_url + user_prompt, optional flags on the same object. After (v2): url + prompt; move fetch-related flags into FetchConfig / fetchConfig.
Before: searchscraper / searchScraper with a prompt-style query. After: search with query (Python keyword argument; JS first argument is the query string).

4. Crawl jobs

Before: One-shot crawl(...) style usage depending on SDK version. After: Start a job, then poll or webhook as documented:

5. REST calls

If you call the API with curl or a generic HTTP client:
  • Use the v2 host and path pattern: https://v2-api.scrapegraphai.com/api/<endpoint> (e.g. /api/scrape, /api/extract, /api/search, /api/crawl, /api/monitor).
  • Replace JSON fields to match v2 bodies (e.g. url and prompt instead of website_url and user_prompt on extract; formats: [{ type: "markdown" }] instead of format: "markdown").
  • Authenticate with the SGAI-APIKEY header.
Exact paths and payloads are listed under each service (for example Scrape) and in the API reference.

What else changed in v2 (docs & product)

  • Unified and clearer API documentation
  • Updated service pages and endpoint organization
  • New guides for MCP server and SDK usage
  1. Log in at scrapegraphai.com/login
  2. Start from Introduction
  3. Follow Installation
  4. Upgrade packages: pip install "scrapegraph-py>=2.0.1,<2.1.0" / npm i scrapegraph-js@latest (requires scrapegraph-py 2.0.1 with Python ≥ 3.12, and scrapegraph-js ≥ 2.1.0 with Node ≥ 22)

SDK migration guides (detailed changelogs)

Full method documentation:

Legacy v1 docs

You can still access v1 documentation here: