Name: Business Data – Scrape Google Maps | Free · $25/mo | API.market
Brand: openwebninja
SKU: api-openwebninja-local-business-data
Availability: InStock
Rating: 5.00 (1 reviews)
Author: API Market

Shashank Agarwal

# 🏬 Local Business Data API

**Local Business Data API: Instant Access to Google Maps POI Data**

---

## Overview
The **Local Business Data API** delivers **fast**, **reliable**, and **extensive** local business and point-of-interest (POI) data directly from **Google Maps**, all in real time. Gain immediate insights like full addresses, websites, phone numbers, emails, ratings, reviews, and additional data points (40+) to supercharge your application’s local search capabilities.

- **Provider**: OpenWebNinja  
- **Category**: Geolocation, Data Aggregation, POI Retrieval  
- **Tags**: Google Maps, Local Business, Reviews, Places API  

---

## Authentication

All requests to the **Local Business Data API** must include your Magic API key in the request header:

```
x-api-market-key: YOUR_API_KEY
```

This key authenticates you as an authorized user. If your key is missing or invalid, you will receive a `401 Unauthorized` error.

---

## Base URL

Use the following base URL for all endpoints (do **not** expose any internal or non-public URLs):

```
https://api.magicapi.dev/api/v1/openwebninja/local-business-data
```

---

## Key Features & Capabilities

1. **Real-Time Business Search**  
   Fetch up-to-date data from Google Maps, including location, reviews, photos, and key metrics like rating and review counts.

2. **Flexible Search Options**  
   - **Search by Query**: Provide keywords (e.g., “pizza,” “hotel”) plus location coordinates.  
   - **Search in a Defined Area**: Zoom-based “Search this area” approach to replicate a Google Maps experience.  
   - **Search Nearby**: Retrieve businesses close to given coordinates.  

3. **Rich Business Details**  
   - **Emails & Contacts**: Optionally scrape emails, phone numbers, and social profiles if a business website is found.  
   - **Reviews & Photos**: Access star ratings, user reviews, photo metadata, and “From the owner” posts.  

4. **Autocomplete (Query Suggestions)**  
   Provide your users with dynamic suggestions for local searches, making your search interface more intuitive.

5. **Bulk Search Support**  
   Run multiple queries at once for large-scale data extraction.

6. **Error Handling & Support**  
   Should you face **any** issues, contact customer support for quick assistance.

---

## Use Cases
- **Local Directories & Listing Services**: Build city guides, business directories, or aggregator sites with real-time updates.  
- **Review & Reputation Platforms**: Pull ratings, top comments, or posts “From the owner” to display real feedback.  
- **Travel & Hospitality Apps**: Suggest nearby hotels, restaurants, attractions, complete with location details and pictures.  
- **Logistics & Delivery Solutions**: Identify points of interest around a route; filter by rating or open status.  
- **Marketing & Lead Generation**: Extract emails, phone numbers, and social handles for outreach—perfect for local B2B prospecting.

---

## API Endpoints

Below is an outline of the **major endpoints** for quick reference. Each endpoint supports certain parameters; see details below for usage and expected responses.

### 1. GET `/search`  
**Purpose**: Perform a standard search for local businesses on Google Maps by providing a `query` (e.g., “Pizza in Brooklyn”), along with optional coordinates (`lat`, `lng`) to bias results.  
- **Key Parameters**:  
  - `query` (string) **required**  
  - `lat` / `lng` (numbers, optional): Coordinates to bias search  
  - `zoom` (integer, optional): Zoom level to define the search viewport  
  - `limit` (integer, default 20): Maximum number of results (1-500)  
  - `extract_emails_and_contacts` (boolean): If `true`, attempts scraping business contact info (consumes additional credits per business).  
  - `fields` (comma-separated): Field projection (e.g., `business_id,type,phone_number`)  
- **Response**: JSON array of businesses, each with name, coordinates, phone, website, rating, review_count, etc.

### 2. GET `/search-in-area`  
**Purpose**: “Search this area” functionality, letting you define a bounding box / viewport via lat/lng center and `zoom`. Great for reproducing the Google Maps “drag map then search” approach.  
- **Parameters**: Similar to `/search` but specifically relies on `lat`, `lng`, and `zoom` to define the search viewport.  
- **Response**: JSON array of business objects with location details, categories, and more.

### 3. GET `/search-nearby`  
**Purpose**: Retrieve businesses near a specific coordinate.  
- **Key Parameters**:  
  - `lat`, `lng` (numbers, required): Center location.  
  - `radius` (integer, optional): Distance in meters to search around the center.  
- **Response**: A list of nearby businesses with rating, address, phone, etc.

### 4. GET `/business-details`  
**Purpose**: Get full details of a single business by its Google Maps ID or Place ID.  
- **Parameters**:  
  - `business_id` (string) or `place_id` (string, whichever is relevant).  
- **Response**: Extended metadata about the business, including coordinates, contact info, about/summaries, official website, etc.

### 5. GET `/business-reviews`  
**Purpose**: Retrieve all reviews for a given business.  
- **Parameters**:  
  - `business_id` or `place_id` (string)  
  - `limit` (integer, optional)  
- **Response**: JSON array of reviews, each with rating, username, text, timestamp, etc.

### 6. GET `/review-details`  
**Purpose**: Focused retrieval of a specific review’s extended details.  
- **Parameters**:  
  - `review_id` (string)  
- **Response**: The full text of the review, rating, user details, photos, or any available additional metadata.

### 7. GET `/business-photos`  
**Purpose**: Fetch the entire set of photos associated with a business listing.  
- **Parameters**:  
  - `business_id` or `place_id`  
- **Response**: List of photo objects with direct links, timestamps, resolution, etc.

### 8. GET `/photo-details`  
**Purpose**: Detailed metadata for a specific photo, including direct link, large preview, geotag, and date taken.  
- **Parameters**:  
  - `photo_id` (string)  
- **Response**: Single photo object with extended data.

### 9. GET `/business-posts`  
**Purpose**: Retrieve “From the owner” posts for a business. (User-generated content by the business owners on Google Maps)  
- **Parameters**:  
  - `business_id` or `place_id`  
- **Response**: JSON array of owner posts with content text, timestamps, and media.

### 10. GET `/reverse-geocoding`  
**Purpose**: Convert coordinates (`lat`, `lng`) back into business or address details.  
- **Parameters**:  
  - `lat`, `lng`  
- **Response**: Address data, potential business or landmark info for those coordinates.

### 11. GET `/autocomplete`  
**Purpose**: Provide query suggestions (e.g., “pizza near New Yo…” -> “pizza near New York City”).  
- **Parameters**:  
  - `input` (string): The partial search term from the user.  
  - `lat`, `lng`, `zoom` (optional)  
- **Response**: Suggestions array with each suggestion text.

---

## Example Usage

### cURL Example (Search)
```
curl -X 'GET' \
  'https://api.magicapi.dev/api/v1/openwebninja/local-business-data/search?query=Hotels%20in%20San%20Francisco%2C%20USA&limit=20&lat=37.359428&lng=-121.925337&zoom=13&language=en&region=us' \
  -H 'accept: application/json' \
  -H 'x-api-market-key: API_MARKET_API_KEY'
```

**Response** (simplified example):  
```json
{
  "status": "OK",
  "request_id": "abcdef123456",
  "parameters": {
    "query": "Hotels in San Francisco, USA",
    "lat": 37.359428,
    "lng": -121.925337,
    "zoom": 13,
    "limit": 20
  },
  "data": [
    {
      "business_id": "0x808580e35111d5f7:0x34b0de1453599ed0",
      "name": "Hotel Zephyr San Francisco",
      "rating": 4.2,
      "review_count": 3693,
      "phone_number": "+14156176565",
      "website": "https://www.hotelzephyrsf.com",
      "latitude": 37.8077617,
      "longitude": -122.4132228,
      ...
    },
    ...
  ]
}
```

---

## Bulk Search & Rate Limits
- **Bulk Search**: Issue multiple queries at once—perfect for large-scale data tasks.  
- **Rate Limits**: If you plan high volumes, ensure you have an appropriate subscription tier. Exceeding rate limits or scraping additional fields (like contact info) can quickly use up credits.

---

## Error Handling
- **400 – Bad Request**: Check your query parameters for typos or missing fields.  
- **401 – Unauthorized**: Your `x-api-market-key` is invalid or missing.  
- **404 – Not Found**: The requested resource (business, review, photo) was not found.  
- **500 – Internal Server Error**: Contact support if this persists.

If you encounter any of these errors or other unexpected behaviors, **please reach out to customer support** for assistance.

---

## Best Practices
1. **Use Lat/Lng for Precision**: Provide coordinates whenever possible for more relevant search results.  
2. **Filter Fields**: Use `fields` to return only the needed data, ensuring faster responses and fewer credits used.  
3. **Scrape Responsibly**: When `extract_emails_and_contacts` is `true`, remember each site scrape consumes extra credits per business.  
4. **Caching**: For repeated queries, cache results locally to reduce repeated costs and improve speed.  
5. **Monitor Usage**: Keep an eye on your usage dashboard to avoid hitting credit limits unexpectedly.

---
local business data,business listings,google maps poi,restaurant reviews,local seo,place search,google places,local businesses,google maps data,poi data  

---
The **Local Business Data API** offers developers a powerful toolkit to integrate **Google Maps** business intelligence—reviews, photos, contact details, and more—into their platforms. Whether you’re building location-based solutions, analyzing local competition, or automating lead-generation, this API provides flexible endpoints for streamlined, high-quality data retrieval.

For **any** questions or if you face **any** errors, **reach out to our customer support**. Our team is here to ensure a smooth and successful integration for your project.

Get local business data from Google Maps in real time. 40+ data points per business. Free 100 calls/mo, from $25/mo. Start free on API.market.

Business Data – Scrape Google Maps | Free · $25/mo | API.market

FREE

OpenWebNinja

ULTRA

MEGA

BULK

I make an app that grab local business info, the API helped to grab phone number, email and website, which is exactly what I'm looking for. Great API, all the best with your business; thanks for making this :) 