Table of contents
  1. GeoScraper API Documentation - Google Maps Services API
    1. Google Maps Services API
      1. Endpoint
      2. Headers
      3. Request Body
      4. Sample Request
      5. Sample Response
      6. Description

GeoScraper API Documentation - Google Maps Services API

Google Maps Services API

This endpoint enables you to scrape services and attributes from a Google Maps business listing.

Endpoint

  • POST: https://api.geoscraper.net/google/map/service

Headers

  • X-Berserker-Token: Your_Access_Token
  • Content-Type: application/json

Request Body

  • Format: JSON
  • Fields:
    • data_id (required): The unique identifier for the place.
    • hl (optional): Language parameter to specify the response language.
    • catched (optional): Boolean to indicate if cached data should be used.
    • token (optional): Token for the next page (obtainable from the first page response).

Sample Request

import requests
import json

url = "https://api.geoscraper.net/google/map/service"

payload = json.dumps({
  "data_id": "0x47e6718d7d10f7b7:0x3c4ce26655e8c4c9",
  "hl": "en",
  "catched": False,
  "token": ""
})
headers = {
  'X-Berserker-Token': 'Your_Access_Token',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

Sample Response

[
    {
        "service_slug": "from_the_business",
        "service_name": "From the business",
        "attributes": [
            {
                "attribute_slug": "/geo/type/establishment_poi/is_owned_by_women",
                "attribute_name": "Identifies as women-owned",
                "attribute_status": "Active"
            }
        ]
    },
    {
        "service_slug": "service_options",
        "service_name": "Service options",
        "attributes": [
            {
                "attribute_slug": "/geo/type/establishment_poi/has_seating_outdoors",
                "attribute_name": "Outdoor seating",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment/has_no_contact_delivery",
                "attribute_name": "No-contact delivery",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/has_delivery",
                "attribute_name": "Delivery",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/has_takeout",
                "attribute_name": "Takeout",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/serves_dine_in",
                "attribute_name": "Dine-in",
                "attribute_status": "Active"
            }
        ]
    },
    {
        "service_slug": "popular_for",
        "service_name": "Popular for",
        "attributes": [
            {
                "attribute_slug": "/geo/type/establishment_poi/serves_lunch_popular",
                "attribute_name": "Lunch",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/serves_dinner_popular",
                "attribute_name": "Dinner",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/suitable_for_solo_dining",
                "attribute_name": "Solo dining",
                "attribute_status": "Active"
            }
        ]
    },
    {
        "service_slug": "accessibility",
        "service_name": "Accessibility",
        "attributes": [
            {
                "attribute_slug": "/geo/type/establishment_poi/has_wheelchair_accessible_seating",
                "attribute_name": "Wheelchair accessible seating",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/has_wheelchair_accessible_entrance",
                "attribute_name": "Wheelchair-accessible entrance",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/has_wheelchair_accessible_parking",
                "attribute_name": "Wheelchair-accessible parking lot",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/has_wheelchair_accessible_restroom",
                "attribute_name": "Wheelchair-accessible washroom",
                "attribute_status": "Inactive"
            }
        ]
    },
    {
        "service_slug": "offerings",
        "service_name": "Offerings",
        "attributes": [
            {
                "attribute_slug": "/geo/type/establishment_poi/serves_alcohol",
                "attribute_name": "Alcohol",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/serves_beer",
                "attribute_name": "Beer",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/serves_coffee",
                "attribute_name": "Coffee",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/serves_late_night_food",
                "attribute_name": "Late-night food",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/serves_organic",
                "attribute_name": "Organic dishes",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/has_private_dining_room",
                "attribute_name": "Private dining room",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/quick_bite",
                "attribute_name": "Quick bite",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/serves_vegetarian",
                "attribute_name": "Vegetarian options",
                "attribute_status": "Active"
            }
        ]
    },
    {
        "service_slug": "dining_options",
        "service_name": "Dining options",
        "attributes": [
            {
                "attribute_slug": "/geo/type/establishment_poi/serves_breakfast",
                "attribute_name": "Breakfast",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/serves_brunch",
                "attribute_name": "Brunch",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/serves_lunch",
                "attribute_name": "Lunch",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/serves_dinner",
                "attribute_name": "Dinner",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/has_catering",
                "attribute_name": "Catering",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/has_counter_service",
                "attribute_name": "Counter service",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/serves_dessert",
                "attribute_name": "Dessert",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/has_seating",
                "attribute_name": "Seating",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/has_table_service",
                "attribute_name": "Table service",
                "attribute_status": "Active"
            }
        ]
    },
    {
        "service_slug": "amenities",
        "service_name": "Amenities",
        "attributes": [
            {
                "attribute_slug": "/geo/type/establishment_poi/has_restroom_unisex",
                "attribute_name": "Gender-neutral washroom",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/has_restroom",
                "attribute_name": "Washroom",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/has_wi_fi",
                "attribute_name": "Wi-Fi",
                "attribute_status": "Active"
            }
        ]
    },
    {
        "service_slug": "atmosphere",
        "service_name": "Atmosphere",
        "attributes": [
            {
                "attribute_slug": "/geo/type/establishment_poi/feels_casual",
                "attribute_name": "Casual",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/feels_cozy",
                "attribute_name": "Cozy",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/feels_hip",
                "attribute_name": "Trendy",
                "attribute_status": "Active"
            }
        ]
    },
    {
        "service_slug": "crowd",
        "service_name": "Crowd",
        "attributes": [
            {
                "attribute_slug": "/geo/type/establishment_poi/welcomes_families",
                "attribute_name": "Family-friendly",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/suitable_for_groups",
                "attribute_name": "Groups",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/welcomes_lgbtq",
                "attribute_name": "LGBTQ+ friendly",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/bare_properties_holder/is_transgender_safespace",
                "attribute_name": "Transgender safe space",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/popular_with_students",
                "attribute_name": "University students",
                "attribute_status": "Active"
            }
        ]
    },
    {
        "service_slug": "planning",
        "service_name": "Planning",
        "attributes": [
            {
                "attribute_slug": "/geo/type/establishment_poi/accepts_reservations",
                "attribute_name": "Accepts reservations",
                "attribute_status": "Inactive"
            }
        ]
    },
    {
        "service_slug": "payments",
        "service_name": "Payments",
        "attributes": [
            {
                "attribute_slug": "/geo/type/establishment/accepts_cheque_dejeuner_meal_voucher",
                "attribute_name": "Cheque Dejeuner",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/pay_credit_card",
                "attribute_name": "Credit cards",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/pay_debit_card",
                "attribute_name": "Debit cards",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/food_and_drink/accepts_meal_coupons",
                "attribute_name": "Meal coupons",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/pay_mobile_nfc",
                "attribute_name": "NFC mobile payments",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment/accepts_sodexo_meal_voucher",
                "attribute_name": "Pluxee",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment/accepts_ticket_restaurant_meal_voucher",
                "attribute_name": "Ticket Restaurant",
                "attribute_status": "Active"
            }
        ]
    },
    {
        "service_slug": "children",
        "service_name": "Children",
        "attributes": [
            {
                "attribute_slug": "/geo/type/establishment_poi/welcomes_children",
                "attribute_name": "Good for kids",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/has_changing_tables",
                "attribute_name": "Has changing table(s)",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/has_high_chairs",
                "attribute_name": "High chairs",
                "attribute_status": "Active"
            },
            {
                "attribute_slug": "/geo/type/establishment_poi/has_childrens_menu",
                "attribute_name": "Kids' menu",
                "attribute_status": "Active"
            }
        ]
    },
    {
        "service_slug": "pets",
        "service_name": "Pets",
        "attributes": [
            {
                "attribute_slug": "/geo/type/establishment_poi/allows_dogs_outside",
                "attribute_name": "Dogs allowed outside",
                "attribute_status": "Active"
            }
        ]
    }
]

Description

  • The response includes a list of services and their associated attributes from the specified Google Maps business listing. Each service contains a service slug, service name, and an array of attributes with their respective slugs and names. This data provides comprehensive information about the business’s offerings, amenities, accessibility features, and other relevant details.

Note: Replace Your_Access_Token with your actual API access token.