Skip to main content

​
Prerequisites

​
Install the SDK (optional)

npm install @scrapio/api

​
1. Fetch a page

import { ApiClient } from "@scrapio/api";

const client = new ApiClient({ apiKey: "YOUR_API_KEY" });

const result = await client.fetch.fetch({
  url: "https://example.com",
  output: ["markdown"],
});

console.log(result.outputs.markdown);
A successful response looks like this: 
{
  "request_id": "a1b2c3d4-...",
  "mode": "inline",
  "status": "completed",
  "outputs": {
    "markdown": "# Example Domain\n\nThis domain is for use in illustrative examples..."
  },
  "usage": { "credits": 1 }
}

​
2. Render a JavaScript-heavy page

Add render_js: true to execute JavaScript before capturing the output. 
const result = await client.fetch.fetch({
  url: "https://news.ycombinator.com",
  render_js: true,
  output: ["markdown"],
});

​
3. Extract structured data

Use the extract field to pull specific fields from a page. 
const result = await client.fetch.fetch({
  url: "https://news.ycombinator.com",
  render_js: true,
  output: ["json"],
  extract: {
    mode: "schema",
    schema: { top_stories: "array of story titles on the front page" },
  },
});

​
4. Search Google

The Google search surface returns structured SERP data — organic results, related searches, and answer boxes — without managing proxies or browser sessions yourself. Requests run through an in-house transport layer with deep TLS and HTTP/2 fingerprint impersonation. Each request is bound to a persistent, qualified browser identity. Blocked or challenged requests are automatically retried with a fresh identity (up to 3 attempts) before an error is returned. 
curl -X GET "https://api.scrapio.dev/v1/google/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -G \
  --data-urlencode "search=best web scraping API 2025" \
  --data-urlencode "country_code=us" \
  --data-urlencode "search_type=classic"

​
Next steps

SDKs

Full install and initialization guide for TypeScript and Python SDKs.

Authentication

How to manage and rotate API keys.

Async jobs

Submit long-running jobs and poll for results.

API Reference

Full parameter reference for every endpoint.