{"uid":"cap_YuFLAbbWAjCgbewZ4cEFs","slug":"agents-litescrape-com-get-live-foot-traffic-for-a-google-place-3424d6d2","name":"Get Live Foot Traffic for a Google Place","description":"Returns an uncached current-versus-usual busyness reading for one Google place: popular_times with the live level and the usual level for this hour, or popular_times null when Google publishes no data for the place. Every reading is fetched fresh and never replayed. One call is one request.","url":"https://agents.litescrape.com/api/google/maps/popular-times","method":"GET","headers":{},"bodySchema":{"type":"object","required":["place_id"],"properties":{"gl":{"type":"string","default":"us","maxLength":2,"minLength":2,"description":"Two-letter country code for regional localization."},"hl":{"type":"string","default":"en","description":"Language for labels and returned text, such as en, es, or fr."},"place_id":{"type":"string","description":"Google place ID from a Maps result."},"google_domain":{"type":"string","default":"google.com","description":"Google domain to query, such as google.com or google.co.uk."}}},"responseSchema":{"type":"object","properties":{"pagination":{"type":"object","description":"Present when more results exist: next (a ready-made URL for the next page) or next_page_token."},"popular_times":{"type":["object","null"],"description":"Live and usual busyness for the current hour, or null when Google publishes no data."},"search_metadata":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"total_time_taken":{"type":"number"}}},"search_parameters":{"type":"object","description":"The request parameters as normalized by the API."}},"description":"Successful responses carry request metadata, the normalized parameters, and the result groups available for the operation. Optional groups are omitted when the source does not provide them. Errors are a JSON body with error, error_code, status_code, request_id, retryable, and the echoed search_parameters."},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.000150","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.000150/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.000150","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.000150","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_smU5Is-0-zH7Z7qOfXVhG","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.000150","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.litescrape.com","brandSlug":"agents-litescrape-com-mpp","brandBaseUrl":"https://agents.litescrape.com","brandDocsUrl":null,"whatItDoes":"Returns a real-time busyness reading (live vs. usual traffic level) for a specific Google Maps place using its Place ID.","exampleAgentPrompt":"How busy is The Museum of Natural History in New York right now compared to usual — can you pull the live foot traffic for Google Place ID ChIJCXoPRoVYwokR2B9SFDH1Nms?","exampleUseCases":[{"title":"Avoid crowds at a restaurant","prompt":"Can you check how busy Shake Shack at Madison Square Park is right now versus the usual level for this hour? The Google Place ID is ChIJn5-gI65ZwokRs9PTBQ5qNx4."},{"title":"Real-time gym occupancy check","prompt":"I'm thinking of heading to Equinox Flatiron — can you tell me if it's more or less busy than usual right now using Google Place ID ChIJa9-RFqtZwokRqkV0Swf2FNM?"},{"title":"Retail store traffic monitoring","prompt":"Pull the live foot traffic data for our flagship store right now using Google Place ID ChIJOwg_06VPwokRYv534QaPC8g — I want to see if it's busier or quieter than the typical Thursday afternoon."}],"resultDescription":"A JSON object containing: popular_times (with live busyness level and usual busyness level for the current hour, or null if Google has no data for this place), search_metadata (request ID, status, processing time), and search_parameters (normalized echo of the request inputs). When Google publishes no crowd data for the requested place, popular_times is returned as null.","failureModes":["Invalid or non-existent place_id returns an error JSON with error_code and status_code","Place has no popular_times data on Google — returns success but with popular_times: null","Google does not publish live data for all place types (e.g. private residences, obscure venues)","Network or upstream Google service timeout — retryable flag will be true in error response","Invalid gl or hl codes may cause unexpected localization results"],"whenToPreferThis":"Use this endpoint when you need a real-time, uncached busyness reading for a specific Google Maps place and already have its Google Place ID. It is ideal for live crowd monitoring, helping users decide the best time to visit, or building dashboards that surface current vs. typical foot traffic. Prefer this over historical popular-times data when the current moment's crowd level matters. If you need to discover a Place ID first, use the Search Google Maps endpoint before calling this one.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T17:29:31.786Z","isFirstParty":false}