Get how busy a Google Maps place is now and by hour of the week

POST/v1/tools/google.maps.popular-times/callsNeeds an API key

Returns how busy a Google Maps place is now, and how busy it usually is each hour of the week. Use it to compare foot traffic between places.

Tool google.maps.popular-times on Google. Contract version 1, released 2026-10-27.

Over REST, send the input in the body. Over MCP, pass the same input to call_tool.

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

place_idstringRequired

Google Place ID of the place, such as "ChIJT2h1HKZZwokR0kgzEtsa03k".

Output

A successful call returns these blocks in its output. A field not marked required can be null.

`place`

One object. Can be null.

titlestring

Name of the business or place.

place_idstringRequired

data_idstring

Google Maps feature ID of the place, in hexadecimal, such as "0x89c259a61c75684f:0x79d31adb123348d2".

`live`

One object. Can be null. How busy the place is now. Null when Google shows no live reading, as when the place is closed.

daystring

Weekday now at the place.

monday

tuesday

wednesday

thursday

friday

saturday

sunday

hourinteger

Hour of the day now at the place, from 0 to 23.

busyness_scoreintegerRequired

Busyness now, from 0 to 100, on the scale of the usual curve.

usual_busyness_scoreinteger

Usual busyness at this hour of this weekday, from 0 to 100.

labelstring

Google's words for the busyness now, such as "As busy as it gets".

time_spent_labelstring

Google's words for a usual visit's length, such as "People typically spend 10-45 min here".

`usual_busyness`

One object. Can be null. Google's popular times graph. Each weekday lists its hours in order, in the place's local time. Null when Google publishes no graph for the place.

mondayarray of object

monday.hourintegerRequired

Hour of the day, from 0 to 23.

monday.busyness_scoreintegerRequired

Usual busyness, from 0 to 100, relative to the place's busiest hour of the week. 0 when the place is closed or usually empty.

monday.labelstring

Google's words for the busyness, such as "Usually a little busy".

tuesdayarray of object

tuesday.hourintegerRequired

Hour of the day, from 0 to 23.

tuesday.busyness_scoreintegerRequired

Usual busyness, from 0 to 100, relative to the place's busiest hour of the week. 0 when the place is closed or usually empty.

tuesday.labelstring

Google's words for the busyness, such as "Usually a little busy".

wednesdayarray of object

wednesday.hourintegerRequired

Hour of the day, from 0 to 23.

wednesday.busyness_scoreintegerRequired

Usual busyness, from 0 to 100, relative to the place's busiest hour of the week. 0 when the place is closed or usually empty.

wednesday.labelstring

Google's words for the busyness, such as "Usually a little busy".

thursdayarray of object

thursday.hourintegerRequired

Hour of the day, from 0 to 23.

thursday.busyness_scoreintegerRequired

Usual busyness, from 0 to 100, relative to the place's busiest hour of the week. 0 when the place is closed or usually empty.

thursday.labelstring

Google's words for the busyness, such as "Usually a little busy".

fridayarray of object

friday.hourintegerRequired

Hour of the day, from 0 to 23.

friday.busyness_scoreintegerRequired

Usual busyness, from 0 to 100, relative to the place's busiest hour of the week. 0 when the place is closed or usually empty.

friday.labelstring

Google's words for the busyness, such as "Usually a little busy".

saturdayarray of object

saturday.hourintegerRequired

Hour of the day, from 0 to 23.

saturday.busyness_scoreintegerRequired

Usual busyness, from 0 to 100, relative to the place's busiest hour of the week. 0 when the place is closed or usually empty.

saturday.labelstring

Google's words for the busyness, such as "Usually a little busy".

sundayarray of object

sunday.hourintegerRequired

Hour of the day, from 0 to 23.

sunday.busyness_scoreintegerRequired

Usual busyness, from 0 to 100, relative to the place's busiest hour of the week. 0 when the place is closed or usually empty.

sunday.labelstring

Google's words for the busyness, such as "Usually a little busy".

curl https://api.voxoria.ai/v1/tools/google.maps.popular-times/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"place_id":"ChIJT2h1HKZZwokR0kgzEtsa03k"}}'

import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/google.maps.popular-times/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={"input": {"place_id": "ChIJT2h1HKZZwokR0kgzEtsa03k"}},
    timeout=60,
)
print(response.json())

const response = await fetch("https://api.voxoria.ai/v1/tools/google.maps.popular-times/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"input": {"place_id": "ChIJT2h1HKZZwokR0kgzEtsa03k"}}),
});
console.log(await response.json());

{
  "name": "call_tool",
  "arguments": {
    "tool": "google.maps.popular-times",
    "input": {
      "place_id": "ChIJT2h1HKZZwokR0kgzEtsa03k"
    }
  }
}

200 OKoutputapplication/json

{
  "place": {
    "title": "Stumptown Coffee Roasters",
    "place_id": "ChIJT2h1HKZZwokR0kgzEtsa03k",
    "data_id": "0x89c259a61c75684f:0x79d31adb123348d2"
  },
  "live": {
    "day": "monday",
    "hour": 13,
    "busyness_score": 88,
    "usual_busyness_score": 76,
    "label": "As busy as it gets",
    "time_spent_label": "People typically spend 10-45 min here"
  },
  "usual_busyness": {
    "monday": [
      {
        "hour": 5,
        "busyness_score": 0,
        "label": null
      },
      {
        "hour": 6,
        "busyness_score": 32,
        "label": "Usually not too busy"
      },
      {
        "hour": 7,
        "busyness_score": 43,
        "label": "Usually not too busy"
      }
    ],
    "tuesday": [
      {
        "hour": 5,
        "busyness_score": 0,
        "label": null
      },
      {
        "hour": 6,
        "busyness_score": 32,
        "label": "Usually not too busy"
      },
      {
        "hour": 7,
        "busyness_score": 44,
        "label": "Usually not too busy"
      }
    ],
    "wednesday": [
      {
        "hour": 5,
        "busyness_score": 0,
        "label": null
      },
      {
        "hour": 6,
        "busyness_score": 27,
        "label": "Usually not too busy"
      },
      {
        "hour": 7,
        "busyness_score": 45,
        "label": "Usually not too busy"
      }
    ],
    "thursday": [
      {
        "hour": 5,
        "busyness_score": 0,
        "label": null
      },
      {
        "hour": 6,
        "busyness_score": 32,
        "label": "Usually not too busy"
      },
      {
        "hour": 7,
        "busyness_score": 42,
        "label": "Usually not too busy"
      }
    ],
    "friday": [
      {
        "hour": 5,
        "busyness_score": 0,
        "label": null
      },
      {
        "hour": 6,
        "busyness_score": 25,
        "label": "Usually not too busy"
      },
      {
        "hour": 7,
        "busyness_score": 35,
        "label": "Usually not too busy"
      }
    ],
    "saturday": [
      {
        "hour": 6,
        "busyness_score": 0,
        "label": null
      },
      {
        "hour": 7,
        "busyness_score": 35,
        "label": "Usually not too busy"
      },
      {
        "hour": 8,
        "busyness_score": 44,
        "label": "Usually not too busy"
      }
    ],
    "sunday": [
      {
        "hour": 6,
        "busyness_score": 0,
        "label": null
      },
      {
        "hour": 7,
        "busyness_score": 27,
        "label": "Usually not too busy"
      },
      {
        "hour": 8,
        "busyness_score": 30,
        "label": "Usually not too busy"
      }
    ]
  }
}

The output of a real call, each list cut to 3 items.