{"uid":"cap_STINc4KrglYZddA7nLwdD","slug":"agents-openwebninja-com-business-photos-37954a9e","name":"Business Photos","description":"Get business photos by Business Id.","url":"https://agents.openwebninja.com/local-business-data/business-photos?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["business_id"],"properties":{"limit":{"type":"string","default":20,"description":"Maximum number of business photos to return.\n  \n  **Allowed values:** `1-100`"},"cursor":{"type":"string","description":"Specify the cursor obtained from the previous request to get the next of result page (use for pagination)."},"fields":{"type":"string","description":"A comma separated list of review fields to include in the response (field projection).  \n  By default all fields are returned."},"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)*."},"is_video":{"type":"boolean","default":false,"description":"Only return video type media (type=video) or not."},"business_id":{"type":"string","example":"0x89c259b5a9bd152b:0x31453e62a3be9f76","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":"array","items":{"type":"object","required":["photo_id","photo_url","type"],"properties":{"type":{"type":"string","description":"Media type. Values: photo, video, street_view."},"latitude":{"type":"number","nullable":true,"description":"Latitude where the photo was taken (when known)."},"photo_id":{"type":"string","description":"Unique Google identifier of the photo."},"longitude":{"type":"number","nullable":true,"description":"Longitude where the photo was taken (when known)."},"photo_url":{"type":"string","description":"URL of the photo (default resolution)."},"photo_timestamp":{"type":"integer","nullable":true,"description":"Unix epoch seconds matching photo_datetime_utc."},"photo_url_large":{"type":"string","nullable":true,"description":"URL of the photo at a larger resolution."},"photo_datetime_utc":{"type":"string","nullable":true,"description":"Original publication datetime of the photo in ISO 8601 UTC."},"video_thumbnail_url":{"type":"string","nullable":true,"description":"Thumbnail URL when the media is a video; null for still photos."}}},"description":"List of photos / videos returned."},"cursor":{"type":"string","nullable":true,"description":"Cursor to fetch the next page of photos. Null when no more pages."},"status":{"type":"string","description":"The status of the API response."},"parameters":{"type":"object","properties":{"limit":{"type":"integer","description":"Maximum number of photos requested."},"region":{"type":"string","description":"Region code used for the request."},"is_video":{"type":"boolean","description":"Whether only videos are being returned."},"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_7jZWDfx17nkwoBYPqeJJW","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":"Retrieve paginated photos and videos for a specific Google Maps business by its Business ID.","exampleAgentPrompt":"Can you pull up to 50 photos for the business with Google place ID ChIJkaUn1JPTD4gR7ZWpE9cCuow from the US region — just still photos, no videos?","exampleUseCases":[{"title":"Restaurant visual content research","prompt":"Get me up to 30 photos of the restaurant with Google Maps business ID 0x89c259b5a9bd152b:0x31453e62a3be9f76 — I want to see what the place looks like before we visit."},{"title":"Business listing media audit","prompt":"Fetch all available videos for the business with place ID ChIJkaUn1JPTD4gR7ZWpE9cCuow from the US region — I need to audit what video content is showing on their Google listing."},{"title":"Paginated photo gallery for app","prompt":"I need the second page of photos for business ID 0x880fd393d427a591:0x8cba02d713a995ed — here's my cursor from the last request: ABC123XYZ. Give me 20 results."}],"resultDescription":"Returns an array of photo and video objects, each containing a unique photo_id, a default-resolution photo_url, an optional large-resolution photo_url_large, media type (photo, video, or street_view), optional geo-coordinates (latitude/longitude), an ISO 8601 publication datetime, and a video_thumbnail_url when applicable. Also returns a pagination cursor for fetching subsequent pages, plus an echoed parameters block and a request_id.","failureModes":["Invalid or unknown business_id returns empty data array or error status","Cursor from a different request or expired cursor causes pagination failure","Requesting is_video=true for a business with no videos returns empty array","Region code not supported returns an error or empty results","Limit value outside 1-100 range may be rejected or clamped","Rate limit exceeded returns an HTTP 429 or payment/credit error"],"whenToPreferThis":"Use this endpoint when you have a known Google Maps business_id, google_id, or place_id and need to retrieve the actual photo or video media associated with that listing — especially for visual research, content auditing, or building image galleries for a business. Prefer this over general web image searches when you need structured metadata (timestamps, coordinates, media type) tied to a specific verified Google Maps business entity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:35:48.269Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-business-photos-a19de39c"}