Google Maps SERP Live

POST

/serp/google/maps/live/advanced

Live Google Maps SERP provides real-time data on top 100 results from Google Maps search for the specified keyword, search engine, and location in response to a single request.

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.dataforseo.com/v3/serp/google/maps/live/advanced' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "keyword": "albert einstein",
        "location_name": "united states",
        "language_name": "english"
    }
]'

Response Example

{
    "version": "0.1.20241227",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "7.5018 sec.",
    "cost": 0.002,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "03261101-8029-0139-0000-35776750dd9b",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "7.3922 sec.",
            "cost": 0.002,
            "result_count": 1,
            "path": [
                "v3",
                "serp",
                "google",
                "maps",
                "live",
                "advanced"
            ],
            "data": {
                "api": "serp",
                "function": "live",
                "se": "google",
                "se_type": "maps",
                "language_name": "english",
                "location_name": "united states",
                "keyword": "albert einstein",
                "device": "desktop",
                "os": "windows"
            },
            "result": [
                {
                    "keyword": "albert einstein",
                    "type": "maps",
                    "se_domain": "google.com",
                    "location_code": 2840,
                    "language_code": "en",
                    "check_url": "https://google.com/maps/search/albert+einstein/@37.09024,-95.712891,4z?hl=en&gl=US&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
                    "datetime": "2025-03-26 09:01:54 +00:00",
                    "spell": null,
                    "refinement_chips": null,
                    "item_types": [
                        "maps_search"
                    ],
                    "se_results_count": 0,
                    "items_count": 100,
                    "items": [
                        {
                            "type": "maps_search",
                            "rank_group": 1,
                            "rank_absolute": 1,
                            "domain": "www.nasonline.org",
                            "title": "Albert Einstein Memorial",
                            "original_title": null,
                            "url": "http://www.nasonline.org/about-nas/visiting-nas/nas-building/the-einstein-memorial.html",
                            "contact_url": null,
                            "contributor_url": null,
                            "book_online_url": null,
                            "rating": {
                                "rating_type": "Max5",
                                "value": 4.7,
                                "votes_count": 1430,
                                "rating_max": null
                            },
                            "hotel_rating": null,
                            "price_level": null,
                            "rating_distribution": {
                                "1": 5,
                                "2": 9,
                                "3": 53,
                                "4": 223,
                                "5": 1140
                            },
                            "snippet": "2101 Constitution Ave. NW, Washington, DC 20418",
                            "address": "2101 Constitution Ave. NW, Washington, DC 20418",
                            "address_info": {
                                "borough": "Northwest Washington",
                                "address": "2101 Constitution Ave. NW",
                                "city": "Washington",
                                "zip": "20418",
                                "region": "District of Columbia",
                                "country_code": "US"
                            },
                            "place_id": "ChIJJZaaKqm3t4kRbBG17Vcv8Rg",
                            "phone": null,
                            "main_image": "https://lh5.googleusercontent.com/p/AF1QipPyOiGml7eII8LgiYGtPh4wzI7g8GP3fZ9Hzsy8=w408-h306-k-no",
                            "total_photos": 3107,
                            "category": "Memorial",
                            "additional_categories": [
                                "Monument",
                                "Sculpture"
                            ],
                            "category_ids": [
                                "memorial",
                                "monument",
                                "sculpture"
                            ],
                            "work_hours": {
                                "timetable": {
                                    "sunday": [
                                        {
                                            "open": {
                                                "hour": 0,
                                                "minute": 0
                                            },
                                            "close": {
                                                "hour": 0,
                                                "minute": 0

Modified at 2025-05-30 07:58:23

Google Maps SERP GET Advanced

Google Local Finder SERP POST