Can I use the Firecrawl SDK with UpRock?

Change two values

UpRock answers Firecrawl's scrape request at https://edge.uprock.com/v2/scrape (and /v1/scrape for the older client) and returns Firecrawl's response shape. So the official SDKs work once you change the API URL and the key. Get a key at uprock.ai/app/api-keys.

Python

# pip install firecrawl-py   env: UPROCK_API_KEYimport osfrom firecrawl import Firecrawl​app = Firecrawl(api_key=os.environ["UPROCK_API_KEY"], api_url="https://edge.uprock.com")​doc = app.scrape("https://example.com", formats=["markdown", "links"])print(doc.metadata.title, doc.metadata.status_code)print(doc.markdown[:200])print(doc.links)

TypeScript

// npm i @mendable/firecrawl-js   (Node 18+)   env: UPROCK_API_KEYimport Firecrawl from "@mendable/firecrawl-js";​const app = new Firecrawl({ apiKey: process.env.UPROCK_API_KEY, apiUrl: "https://edge.uprock.com" });​const doc = await app.scrape("https://example.com", { formats: ["markdown", "links"] });console.log(doc.metadata?.title, doc.metadata?.statusCode);console.log(doc.markdown?.slice(0, 200));console.log(doc.links);

Both print Example Domain 200, the page's markdown and its links. The page is loaded in a real browser on an opted-in device, so a fresh scrape usually takes 10 to 40 seconds.

What works and what doesn't

We ran each call below with firecrawl-py 4.55.0 and @mendable/firecrawl-js 4.52.0 against the live API on 8 Nov 2026.

Errors come back in Firecrawl's format, so the SDK raises its usual exceptions: a missing or wrong key raises UnauthorizedError, and a page that couldn't be loaded raises InternalServerError in Python or SdkError in TypeScript.

Keep Firecrawl, add UpRock as the backup

Because it's the same SDK, the backup is a second client. Send a page to UpRock only when Firecrawl fails on it:

# pip install firecrawl-py   env: FIRECRAWL_API_KEY, UPROCK_API_KEYimport osfrom firecrawl import Firecrawl, FirecrawlError​primary = Firecrawl(api_key=os.environ["FIRECRAWL_API_KEY"])backup = Firecrawl(api_key=os.environ["UPROCK_API_KEY"], api_url="https://edge.uprock.com")​def scrape(url, **options):    try:        return primary.scrape(url, **options)    except FirecrawlError:        return backup.scrape(url, **options)​doc = scrape("https://example.com", formats=["markdown"])print(doc.markdown[:200])

This retries on every Firecrawl error. To retry only blocked, rate-limited and timed-out pages, check the status code first: the Firecrawl comparison has that version and when each failure is worth a second try.

We ran this with a deliberately invalid Firecrawl key on 8 Nov 2026: Firecrawl raised UnauthorizedError, and the backup client returned the page from UpRock.