Google contains valuable data — organic results, knowledge graph, People Also Ask, AI overview, and more. Scraping this data directly means dealing with anti-bot detection, CAPTCHAs, IP rotation, and constantly breaking selectors. The Scavio API handles all of that and returns clean, structured JSON from a single POST request.
This tutorial shows you how to scrape Google using TypeScript and the Scavio API. By the end, you will have a working TypeScript script that fetches real-time Google data and parses the results.
Prerequisites
- TypeScript installed on your machine
- A Scavio API key (free tier includes 500 credits/month — no credit card required)
Step 1: Install Dependencies
Install fetch to make HTTP requests:
npm install typescript tsxStep 2: Make Your First Google Search
Send a POST request to the Scavio Google API endpoint with your query. The API returns structured JSON with organic results, knowledge graph, People Also Ask, and more.
const API_KEY = "your_scavio_api_key";
interface GoogleResult {
search_metadata: { status: string };
organic_results: Array<{ position: number; title: string; link: string; snippet: string }>;
}
const response = await fetch("https://api.scavio.dev/api/v1/search", {
method: "POST",
headers: {
"x-api-key": API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({ query }),
});
const data: GoogleResult = await response.json();
for (const result of data.organic_results?.slice(0, 5) ?? []) {
console.log(`${result.position}. ${result.title}`);
console.log(` ${result.link}\n`);
}Step 3: Example Response
The API returns structured JSON. Here is an example response for a Google search:
{
"search_metadata": {
"status": "success",
"total_results": 1240000000
},
"organic_results": [
{
"position": 1,
"title": "Best Noise-Cancelling Headphones of 2026",
"link": "https://example.com/best-headphones",
"snippet": "We tested 30+ headphones to find the best...",
"displayed_link": "example.com"
}
],
"knowledge_graph": {
"title": "Noise-cancelling headphones",
"description": "Active noise-cancelling headphones use..."
},
"people_also_ask": [
{ "question": "What are the best noise cancelling headphones right now?" },
{ "question": "Is noise cancelling bad for your ears?" }
]
}Every field is structured and typed — no HTML parsing, no CSS selectors, no regex extraction. Your TypeScript code can access any field directly.
Step 4: Full Working Example
Here is a complete, runnable TypeScript script that searches Google and prints the results:
/**
* Scrape Google search results with full type safety.
* Run with: npx tsx google-search.ts
*/
const API_KEY = process.env.SCAVIO_API_KEY!;
interface GoogleResult {
search_metadata: { status: string };
organic_results: Array<{ position: number; title: string; link: string; snippet: string }>;
}
async function searchGoogle(query: string): Promise<GoogleResult> {
const response = await fetch("https://api.scavio.dev/api/v1/search", {
method: "POST",
headers: {
"x-api-key": API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({ query }),
});
if (!response.ok) {
throw new Error(`Scavio API error: ${response.status}`);
}
return response.json();
}
const results = await searchGoogle("best noise cancelling headphones 2026");
console.log(JSON.stringify(results, null, 2));Why Use Scavio Instead of Scraping Google Directly?
- No proxy management. Direct scraping requires rotating proxies to avoid IP bans. Scavio handles all of this server-side.
- No CAPTCHA solving. Google aggressively blocks automated requests. Scavio returns clean data every time.
- Structured JSON output. No HTML parsing or CSS selector maintenance. Get typed, consistent data from every request.
- Multi-platform in one API. Search Google, Amazon, YouTube, and Walmart from the same API key with the same authentication pattern.
- Free tier included. 500 credits/month with no credit card required. Each search costs 1 credit.