{"uid":"cap_I4qN-jyGGrQwV3Ti6qZgq","slug":"agents-openwebninja-com-business-owner-posts-google-maps-4a745f34","name":"Business Owner Posts (Google Maps)","description":"Get all / paginate Business Owner Posts (\"From the owner\" section on Google Maps) by Business Id, sorted chronologically.","url":"https://agents.openwebninja.com/local-business-data/business-posts?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["business_id"],"properties":{"cursor":{"type":"string","description":"Specify the cursor obtained from the previous request to get the next of result page (use for pagination)."},"region":{"type":"string","default":"us","description":"Query Google Maps from a particular region or country.  \n  For a list of supported region/country codes see *https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes (Alpha-2 code)*."},"language":{"type":"string","default":"en","description":"Set the language of the results. For a list of supported language codes see *https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes*."},"business_id":{"type":"string","example":"0x880fd393d427a591:0x8cba02d713a995ed","description":"Unique Business Id. Accepts `google_id` / `business_id` or `place_id`.  \n\n  **Examples:**  \n  `0x880fd393d427a591:0x8cba02d713a995ed`  \n  `ChIJkaUn1JPTD4gR7ZWpE9cCuow`  "}}},"responseSchema":{"type":"object","required":["status","request_id","parameters","data"],"properties":{"data":{"type":"object","required":["posts"],"properties":{"posts":{"type":"array","items":{"type":"object","required":["post_id"],"properties":{"post_id":{"type":"string","description":"Unique Google identifier of the owner post."},"post_link":{"type":"string","nullable":true,"description":"Direct URL to the post on Google."},"post_text":{"type":"string","nullable":true,"description":"Text content of the post."},"post_links":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","description":"Target URL of the link."},"caption":{"type":"string","nullable":true,"description":"Caption of the link as shown on the post."}}},"nullable":true,"description":"Outbound links attached to the post."},"post_photos":{"type":"array","items":{"type":"string"},"nullable":true,"description":"URLs of photos attached to the post."},"post_timestamp":{"type":"integer","nullable":true,"description":"Unix epoch seconds matching post_datetime_utc."},"post_datetime_utc":{"type":"string","nullable":true,"description":"ISO 8601 UTC datetime when the post was published."}}},"description":"Owner posts in chronological order."},"cursor":{"type":"string","nullable":true,"description":"Cursor to fetch the next page. Null when no more pages."}},"description":"Business posts page."},"status":{"type":"string","description":"The status of the API response."},"parameters":{"type":"object","properties":{"cursor":{"type":"string","nullable":true,"description":"Pagination cursor passed in (when continuing a previous request)."},"region":{"type":"string","description":"Region code used for the request."},"language":{"type":"string","description":"Language code used for the response."},"business_id":{"type":"string","description":"The business_id as received."}},"description":"The parameters the API received and used for this request, echoed back."},"request_id":{"type":"string","description":"A unique ID to trace the API request."}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","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":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_8ma9_P5V_uAvbqKSENalj","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Retrieves paginated 'From the owner' posts for a specific Google Maps business, sorted chronologically.","exampleAgentPrompt":"Can you pull all the 'From the owner' posts for the Google Maps business with ID ChIJkaUn1JPTD4gR7ZWpE9cCuow? I want to see what updates they've been posting.","exampleUseCases":[{"title":"Monitor competitor business announcements","prompt":"Get me all the owner posts from this Google Maps business — ID 0x880fd393d427a591:0x8cba02d713a995ed — so I can see what promotions or updates they've been sharing lately."},{"title":"Aggregate local restaurant specials","prompt":"Fetch the 'From the owner' posts for the restaurant with Google place ID ChIJkaUn1JPTD4gR7ZWpE9cCuow so I can see their latest specials and events."},{"title":"Track business communications over time","prompt":"I need to go through all the owner posts for Google Maps business ID 0x880fd393d427a591:0x8cba02d713a995ed — pull the first page and give me the cursor so I can keep paginating through the rest."}],"resultDescription":"Returns a paginated array of owner posts, each containing a unique post_id, post text, direct Google URL, outbound links, attached photo URLs, and UTC publish timestamp. Also includes a cursor for fetching the next page (null when exhausted), plus echoed request parameters and a request_id for tracing.","failureModes":["Invalid or non-existent business_id returns empty posts array or error status","Business has no owner posts — returns empty posts array with null cursor","Invalid cursor value causes pagination failure or repeated first page","Unsupported region or language code may fall back to defaults silently","Rate limiting or quota exhaustion returns 402 or error status","Google Maps listing may not expose owner posts for all business types"],"whenToPreferThis":"Use this endpoint when you need to programmatically access the 'From the owner' section of a Google Maps listing — business announcements, promotions, events, or updates posted directly by the owner. Prefer this over review or photo endpoints when the goal is to track official business communications. It is the only endpoint in this suite specifically targeting owner-authored posts with chronological ordering and pagination support.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:34.031Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-business-owner-posts-google-maps-4a745f34"}