Google Reviews contains valuable data -- review text, star rating, reviewer profile, review date, 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 Reviews using TypeScript and the Scavio API. By the end, you will have a working TypeScript script that fetches real-time Google Reviews data and parses the results.
Prerequisites
- TypeScript installed on your machine
- A Scavio API key (free tier includes 50 credits on signup -- no credit card required)
Step 1: Install Dependencies
Install fetch to make HTTP requests:
Bash
npm install -D typescript tsxStep 2: Make Your First Google Reviews Search
Send a POST request to the Scavio Google Reviews API endpoint with your query. The API returns structured JSON with review text, star rating, reviewer profile, and more.
// Reviews are per place: get a data_id (or place_id) from POST /api/v2/google/maps/search
// first. Owner responses are not part of this response.
const API_KEY = "sk_live_your_key";
const dataId = "0x89c259869319e7af:0x54953953a5ede7bb";
interface GoogleReviewsResponse {
place_info: { title: string; address: string; rating: number; reviews: number };
reviews: Array<{ position: number; rating: number; date: string; iso_date: string; snippet: string; likes: number; link: string; user: { name: string; link: string; local_guide: boolean } }>;
response_time: number;
credits_used: number;
credits_remaining: number;
}
const response = await fetch("https://api.scavio.dev/api/v2/google/maps/reviews", {
method: "POST",
headers: {
"Authorization": "Bearer " + API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({ data_id: dataId, num: 10, sort_by: "newest" }),
});
if (!response.ok) {
throw new Error("Scavio API error: " + response.status);
}
const data = (await response.json()) as GoogleReviewsResponse;
const rows = data?.reviews ?? [];
for (const row of rows.slice(0, 5)) {
console.log(row?.rating);
console.log(" ", row?.date, row?.snippet, row?.user?.name);
}Step 3: Example Response
The API returns structured JSON. Here is an example response for a Google Reviews search:
JSON
{
"search_parameters": { "engine": "google_maps_reviews", "data_id": "0x89c259869319e7af:0x54953953a5ede7bb", "num": 10 },
"place_info": { "title": "Jives Media", "address": "800 6th Ave Ste 36C, New York, NY 10001", "rating": 4.9, "reviews": 199 },
"reviews": [
{
"position": 1,
"rating": 5,
"date": "a year ago",
"iso_date": "2025-06-11T00:00:00Z",
"snippet": "We have been working with the Jives Media team for over a year now...",
"likes": 0,
"user": { "name": "P Gol", "link": "https://www.google.com/maps/contrib/100121084533228462911", "local_guide": true }
}
],
"pagination": { "next_page_token": "CAESY0NBRVFB..." },
"response_time": 3720,
"credits_used": 1,
"credits_remaining": 4811
}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 Reviews and prints the results:
/**
* Fetch Google Reviews data with the Scavio API.
* POST /api/v2/google/maps/reviews - rows come back under reviews, 1 credit per call.
* Run with: npx tsx google-reviews.ts
*/
// Reviews are per place: get a data_id (or place_id) from POST /api/v2/google/maps/search
// first. Owner responses are not part of this response.
const API_URL = "https://api.scavio.dev/api/v2/google/maps/reviews";
const API_KEY = process.env.SCAVIO_API_KEY as string;
interface GoogleReviewsResponse {
place_info: { title: string; address: string; rating: number; reviews: number };
reviews: Array<{ position: number; rating: number; date: string; iso_date: string; snippet: string; likes: number; link: string; user: { name: string; link: string; local_guide: boolean } }>;
response_time: number;
credits_used: number;
credits_remaining: number;
}
async function fetchGoogleReviews(dataId: string): Promise<GoogleReviewsResponse> {
const response = await fetch(API_URL, {
method: "POST",
headers: {
"Authorization": "Bearer " + API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({ data_id: dataId, num: 10, sort_by: "newest" }),
});
if (!response.ok) {
throw new Error("Scavio API error: " + response.status);
}
return (await response.json()) as GoogleReviewsResponse;
}
const data = await fetchGoogleReviews("0x89c259869319e7af:0x54953953a5ede7bb");
const rows = data?.reviews ?? [];
for (const row of rows.slice(0, 5)) {
console.log(row?.rating);
console.log(" ", row?.date, row?.snippet, row?.user?.name);
}Why Use Scavio Instead of Scraping Google Reviews Directly?
- No proxy management. Direct scraping requires rotating proxies to avoid IP bans. Scavio handles all of this server-side.
- No CAPTCHA solving. Google Reviews 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. 50 credits on signup with no credit card required. Each search costs 1 credit.