{"uid":"cap_vC-ViapBA_1Ktzr7bmsMa","slug":"agents-litescrape-com-get-google-maps-business-posts-b5f6e547","name":"Get Google Maps Business Posts","description":"Returns the posts a business has published on its Google Maps listing, identified by the listing's hexadecimal feature ID (the data_id on a Maps result, or follow its posts_link for a ready-made request). Responses carry a next_page_token when more posts exist. One call is one request.","url":"https://agents.litescrape.com/api/google/maps/posts","method":"GET","headers":{},"bodySchema":{"type":"object","required":["data_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."},"data_id":{"type":"string","description":"Hexadecimal Maps feature ID in the form 0x123:0x456."},"google_domain":{"type":"string","default":"google.com","description":"Google domain to query, such as google.com or google.co.uk."},"next_page_token":{"type":"string","maxLength":4096,"minLength":16,"description":"Continuation token from a previous posts response."}}},"responseSchema":{"type":"object","properties":{"posts":{"type":"array","items":{"type":"object"},"description":"Posts published on the listing."},"pagination":{"type":"object","description":"Present when more results exist: next (a ready-made URL for the next page) or next_page_token."},"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_haUR6r5Y4pYwHQAqfGQWP","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":"Retrieves the posts a business has published on its Google Maps listing, identified by a hexadecimal feature ID, with pagination support.","exampleAgentPrompt":"Can you pull all the posts that Starbucks on Fifth Avenue in New York has published on their Google Maps listing? Their Maps feature ID is 0x89c259a9b3117469:0x35b1cfbc89a6097f.","exampleUseCases":[{"title":"Monitor competitor promotions on Maps","prompt":"Fetch the latest posts on this restaurant's Google Maps listing — their data_id is 0x89c25855c4462b49:0x8e1a84c5e39eb4d0 — I want to see what deals or events they're currently promoting."},{"title":"Audit own business updates on Maps","prompt":"Pull all the posts we've published on our Google Maps listing for Morning Bloom Coffee, our data_id is 0x4b66db9e5a1fa2cd:0x12f3e08dc5b7a91e, including any older ones using the next page token if there are more."},{"title":"Research local business activity for market analysis","prompt":"Get the Google Maps posts for this gym — feature ID 0x80c2c75dda27da13:0x4c6c5b7f8a2e3d10 — I'm trying to understand how often they post and what kind of content they share."}],"resultDescription":"Returns a JSON object containing an array of posts published by the business on their Google Maps listing, a pagination object with a next_page_token and ready-made next URL when additional pages exist, search_metadata (request ID, status, time taken), and the normalized search_parameters echoed back. Errors return a JSON body with error, error_code, status_code, request_id, retryable flag, and echoed parameters.","failureModes":["Invalid or malformed data_id returns an error JSON with error_code and status_code","Business with no posts returns an empty posts array","Expired or invalid next_page_token results in an error response","Unsupported language or country code may fall back to defaults or return an error","Rate limiting or payment failure returns a 402 or relevant HTTP error with retryable flag"],"whenToPreferThis":"Use this endpoint when you need to programmatically retrieve posts a business has published on their Google Maps profile without running a browser or managing proxies. It is the right choice when you already have a Maps feature ID (data_id) from a prior Maps search, or when following a posts_link from a Maps result. Prefer this over generic scraping when you need structured JSON output, pagination support, and a simple per-call pricing model with no subscription required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T17:29:16.775Z","isFirstParty":false}