Google Maps contains valuable data — local results, addresses, ratings, review counts, 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 Maps using PHP and the Scavio API. By the end, you will have a working PHP script that fetches real-time Google Maps data and parses the results.
Prerequisites
- PHP installed on your machine
- A Scavio API key (free tier includes 500 credits/month — no credit card required)
Step 1: Install Dependencies
cURL is built into PHP, so there is nothing to install.
# cURL extension is built into PHPStep 2: Make Your First Google Maps Search
Send a POST request to the Scavio Google Maps API endpoint with your query. The API returns structured JSON with local results, addresses, ratings, and more.
<?php
$apiKey = "your_scavio_api_key";
$ch = curl_init("https://api.scavio.dev/api/v1/search");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"x-api-key: $apiKey",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode(["query" => $query, "tbs" => "lcl"]),
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);Step 3: Example Response
The API returns structured JSON. Here is an example response for a Google Maps search:
{
"search_metadata": { "status": "success" },
"local_results": [
{
"position": 1,
"title": "Blue Bottle Coffee",
"address": "450 W 15th St, New York, NY 10011",
"rating": 4.4,
"reviews": 892,
"phone": "(212) 555-0123",
"hours": "Open until 7 PM",
"type": "Coffee shop"
}
]
}Every field is structured and typed — no HTML parsing, no CSS selectors, no regex extraction. Your PHP code can access any field directly.
Step 4: Full Working Example
Here is a complete, runnable PHP script that searches Google Maps and prints the results:
<?php
/**
* Scrape Google Maps search results using Scavio API.
* Returns structured JSON with local results, addresses, ratings, and more.
*/
function searchGoogleMaps(string $query): array {
$apiKey = getenv("SCAVIO_API_KEY");
$ch = curl_init("https://api.scavio.dev/api/v1/search");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"x-api-key: $apiKey",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode(["query" => $query, "tbs" => "lcl"]),
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($httpCode !== 200) {
throw new Exception("Scavio API error: $httpCode");
}
return json_decode($response, true);
}
$results = searchGoogleMaps("coffee shops near me");
echo json_encode($results, JSON_PRETTY_PRINT);Why Use Scavio Instead of Scraping Google Maps Directly?
- No proxy management. Direct scraping requires rotating proxies to avoid IP bans. Scavio handles all of this server-side.
- No CAPTCHA solving. Google Maps 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.