# Google Search Business Popular Times API (https://www.socialcrawl.dev/platforms/google/business-popular-times) > Returns how busy a place on Google Maps is: the live reading (Google's words such as Busy, the hour, the busyness now against the usual busyness at that hour, both 0 to 100, and how long people typically stay) and, for every day of the week, each hour with a 0 to 100 busyness score, all in `place.ext.popular_times`. `place.id` is the place's cid and `place.ext.place_id` its place_id, as on GET /v1/google/business/search. Identify the place by `place_id`. A place for which Google shows no busy hours returns 404 (auto-refunded). Google's words (the live status, the time people stay) are in English. Results are cached for 5 minutes, since the live reading moves. TL;DR: `GET /v1/google/business/popular-times` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup. ## Parameters | Parameter | Required | Description | | --- | --- | --- | | `place_id` | yes | Google place_id of the place (for example ChIJqdNaaBVbwokRLTafYrQlZI8). GET /v1/google/business/search returns it as `place.ext.place_id`. | | `country` | no | Two-letter country for localisation, for example us or fr. | ## Code example ```bash curl -G "https://www.socialcrawl.dev/v1/google/business/popular-times" \ --data-urlencode "place_id=ChIJqdNaaBVbwokRLTafYrQlZI8" \ -H "x-api-key: sc_YOUR_API_KEY" ``` ## FAQ ### What does the Google Search Business Popular Times API return? Returns how busy a Google Maps place is right now and, for every day of the week, hour by hour on a 0 to 100 scale, with how long people typically stay. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields. ### When should I use the Google Search Business Popular Times endpoint? Use it to pick a quiet time to visit, compare footfall between branches, or watch how busy a competitor's store is through the day. ### How much does the Google Search Business Popular Times API cost? Each call costs 1 credit, so the 100 free credits every new account gets cover 100 calls. Credits for failed or empty calls are refunded automatically, and there is no subscription. ### What parameters does the Google Search Business Popular Times API need? The one required parameter is place_id (google place_id of the place). It also accepts 1 optional parameter, listed on this page. ### How do I call the Google Search Business Popular Times API? Send a GET request to https://www.socialcrawl.dev/v1/google/business/popular-times?place_id=ChIJqdNaaBVbwokRLTafYrQlZI8 with your API key in the x-api-key header. An Authorization: Bearer header works too. See the full Google Search API: https://www.socialcrawl.dev/platforms/google ## Pricing - Standard endpoints: 1 credit per call - Advanced endpoints: 5 credits per call - Premium endpoints: 10 credits per call - 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire. - Full pricing: https://www.socialcrawl.dev/pricing ## Explore with AI Questions this API answers, phrased for an AI assistant: - What does the SocialCrawl Google Search Business Popular Times API return? - How do I get Google Search Business Popular Times data with the SocialCrawl API?