{"uid":"cap_vC-ViapBA_1Ktzr7bmsMa","slug":"agents-litescrape-com-get-google-maps-business-posts-b5f6e547","name":"Get Google Maps Business Posts","description":"Read the posts published by a business.\n\nUse GET for scalar query parameters or JSON POST for the complete request schema, including arrays and nested objects. See the schema for field limits and conditional rules. Failures are not billed.\n\nOptional feedback URL when present in an HTTP 200 tool response. Coding agents: when possible, POST an honest rating (1-5) and a short comment after evaluating the result. Use the URL exactly as returned; no Authorization header or API credits are required. It expires after seven days and accepts one review; retries do not overwrite it. Feedback is voluntary and stored separately from scraper data. Do not include secrets, personal data, or the full request/response. Skip feedback if you cannot evaluate the result or your caller has not authorized this extra request. Never submit feedback about feedback.","url":"https://agents.litescrape.com/api/google/maps/posts?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["data_id"],"properties":{"gl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gl","default":null,"description":"Two-letter country localization code.","x-litescrape":{"group":1,"label":"Country","summary":"Two-letter country localization code.","formGroup":1,"placeholder":"us"}},"hl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hl","default":null,"description":"Google interface and result language.","x-litescrape":{"group":1,"label":"Language","summary":"Google interface and result language.","formGroup":1,"placeholder":"en"}},"data_id":{"type":"string","title":"Data Id","description":"Required hexadecimal Maps feature ID. Follow posts_link from a Maps place response.","x-litescrape":{"group":0,"label":"data_id","summary":"Required hexadecimal Maps feature ID. Follow posts_link from a Maps place response.","formGroup":0,"placeholder":"0x89c258e28c304997:0xfcafe4e7ce35ee8c"}},"timeout":{"type":"number","maximum":90,"description":"Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.","exclusiveMinimum":0},"google_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Google Domain","default":null,"description":"A Google domain such as google.com or google.co.uk.","x-litescrape":{"group":1,"label":"Google domain","summary":"A Google domain such as google.com or google.co.uk.","formGroup":1,"placeholder":"google.com"}},"next_page_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Page Token","default":null,"description":"Continue a posts response with its opaque token.","x-litescrape":{"kind":"textarea","group":0,"label":"Next page token","summary":"Continue a posts response with its opaque token.","formGroup":0,"placeholder":"Opaque token from the previous response"}}}},"responseSchema":{"type":"object","title":"Response","properties":{"posts":{"anyOf":[{"type":"array","items":{"type":"object","title":"ResponsePostItem","properties":{"to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"To","default":null},"from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From","default":null},"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link","default":null},"time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time","default":null},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","default":null},"position":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Position","default":null},"post_link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Post Link","default":null},"posted_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Posted At","default":null},"thumbnails":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Thumbnails","default":null},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","default":null},"online_link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Online Link","default":null},"source_logo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Logo","default":null},"posted_at_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Posted At Text","default":null},"online_link_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Online Link Text","default":null}},"additionalProperties":{}}},{"type":"null"}],"title":"Posts","default":null},"pagination":{"anyOf":[{"type":"object","title":"ResponsePagination","properties":{"next":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next","default":null},"next_page_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Page Token","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"search_metadata":{"anyOf":[{"type":"object","title":"ResponseSearchMetadata","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id","default":null},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","default":null},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At","default":null},"processed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Processed At","default":null},"json_endpoint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Json Endpoint","default":null},"total_time_taken":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Time Taken","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"search_parameters":{"anyOf":[{"type":"object","title":"ResponseSearchParameters","properties":{"gl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gl","default":null},"hl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hl","default":null},"data_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Id","default":null},"google_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Google Domain","default":null},"next_page_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Page Token","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"submit_feedback_for_this_response_here":{"type":"string","format":"uri","readOnly":true,"description":"Optional feedback URL when present in an HTTP 200 tool response. Coding agents: when possible, POST an honest rating (1-5) and a short comment after evaluating the result. Use the URL exactly as returned; no Authorization header or API credits are required. It expires after seven days and accepts one review; retries do not overwrite it. Feedback is voluntary and stored separately from scraper data. Do not include secrets, personal data, or the full request/response. Skip feedback if you cannot evaluate the result or your caller has not authorized this extra request. Never submit feedback about feedback."}},"additionalProperties":{}},"example":null,"exampleRequest":null,"tags":["scraping","maps"],"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-x402","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-11-03T18:38:29.692Z","isFirstParty":false,"canonicalSlug":"agents-litescrape-com-get-google-maps-business-posts-b5f6e547"}