Skip to main content

Overview

Olostep’s API allows you to extract structured data from Google Maps locations by using parsers. These parsers transform the raw HTML of Google Maps pages into clean, structured JSON data that’s ready for analysis or integration into your applications.

Integration Example

To get parsed JSON content from Google Maps results, you need to include json in the formats parameter and specify the name of the parser @olostep/google-maps in the parser object. Here’s how to retrieve Google Maps location data in a structured format:

Response Format

When you make a request to the Olostep API with the Google Maps parser, you’ll receive a JSON response like the example below:
The response contains:
  • Basic request information: id, object, created timestamp, url_to_scrape
  • Result object with URLs to access different formats of the data
  • json_content with structured search results including:
  • Business details (name, address, contact information)
  • Rating and review information
  • Opening hours
  • User reviews with text and images
  • Similar places nearby
  • Popular tags and amenities

Structured Response: json_content

The json_content field contains detailed information about the location. Here’s an example of data you can expect:
Olostep provides a hosted JSON file with the structured location data. You can access the JSON file using the json_hosted_url field in the response: If you want to also get the HTML and Markdown content of the location data, you can include these formats in the formats parameter and Olostep will return them in the response and provide hosted URLs for each format.

Use Cases

The Google Maps parser is particularly useful for: Business Intelligence: Collect data about competitors’ locations, ratings, and customer feedback Market Research: Analyze customer reviews and sentiments about businesses in specific areas Location-Based Applications: Integrate detailed business information and customer reviews Real Estate Analysis: Gather data about nearby amenities and local businesses Local SEO: Monitor business presence and customer reviews on Google Maps

Important Notes

Language Parameter: The ?hl=en parameter sets the language to English. Adjust as needed for other languages.

Conclusion

Using the Google Maps parser with Olostep’s API allows you to extract structured location data that can be easily integrated into your applications or used for analysis. The parser handles the complex task of extracting information from Google Maps pages, providing you with clean, structured data. To get information about available parsers or to request a custom parser for your specific use case, please contact us at info@olostep.com