{"uid":"cap_zx6RXmj_ywJ6MPRfDqAjk","slug":"agents-openwebninja-com-business-details-by-id-a1acc7aa","name":"Business Details by ID","description":"Get full business details by Business Id, including the menu, popular times, services and price tier - fields the search endpoints do not return.\n\nSupports batching of up to 500 Business Ids in a single request.\n\n**Note:** a Business Id that matches nothing is simply absent from the response, so `match_count` can be lower than the number of ids sent. There is no `cursor` on this endpoint.","url":"https://agents.openwebninja.com/local-business-database/business-details?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["business_ids"],"properties":{"fields":{"type":"string","pattern":"^\\s*$|^\\s*(business_id|name|address|lat|lng|categories|main_category|phone|website|tld|status|rating|review_count|place_id|google_mid|cid|place_link|timezone|owner_id|owner_name|owner_link|address_short|district|street_address|city|zipcode|state|country|photo_count|photos_sample|verified|opening_status|working_hours|opening_date|reviews_per_rating|price_level|reviews_link|booking_link|order_link|reservations_link|category_ids|main_category_id|about|closed_dow|open_24_7|located_in|hotel_stars|hotel_amenities|hotel_location_rating|hotel_review_summary|hotel_booking_options|hotel_results_from_web|first_seen|last_seen|last_changed|business_services|price_tier|menu|photo_tabs|popular_times)(\\s*,\\s*(business_id|name|address|lat|lng|categories|main_category|phone|website|tld|status|rating|review_count|place_id|google_mid|cid|place_link|timezone|owner_id|owner_name|owner_link|address_short|district|street_address|city|zipcode|state|country|photo_count|photos_sample|verified|opening_status|working_hours|opening_date|reviews_per_rating|price_level|reviews_link|booking_link|order_link|reservations_link|category_ids|main_category_id|about|closed_dow|open_24_7|located_in|hotel_stars|hotel_amenities|hotel_location_rating|hotel_review_summary|hotel_booking_options|hotel_results_from_web|first_seen|last_seen|last_changed|business_services|price_tier|menu|photo_tabs|popular_times)){0,59}\\s*$","description":"A comma separated list of business fields to include in the response (field projection).\n\nBy default all fields are returned. `business_id` is always included.\n\n**Allowed values:** `business_id`, `name`, `address`, `lat`, `lng`, `categories`, `main_category`, `phone`, `website`, `tld`, `status`, `rating`, `review_count`, `place_id`, `google_mid`, `cid`, `place_link`, `timezone`, `owner_id`, `owner_name`, `owner_link`, `address_short`, `district`, `street_address`, `city`, `zipcode`, `state`, `country`, `photo_count`, `photos_sample`, `verified`, `opening_status`, `working_hours`, `opening_date`, `reviews_per_rating`, `price_level`, `reviews_link`, `booking_link`, `order_link`, `reservations_link`, `category_ids`, `main_category_id`, `about`, `closed_dow`, `open_24_7`, `located_in`, `hotel_stars`, `hotel_amenities`, `hotel_location_rating`, `hotel_review_summary`, `hotel_booking_options`, `hotel_results_from_web`, `first_seen`, `last_seen`, `last_changed`, `business_services`, `price_tier`, `menu`, `photo_tabs`, `popular_times`\n\n**Note:** field projection trims the response body only. It does not change how the request is billed."},"business_ids":{"oneOf":[{"type":"string","pattern":"^[^,]{0,256}(,[^,]{0,256}){0,499}$"},{"type":"array","items":{"type":"string","maxLength":256},"maxItems":500}],"description":"Unique Business Id, as returned in a business record's `business_id`.\n\n**Examples:**\n\n`0x102b644d009e013:0xea49e9ee285fa7bf`\n\nIn addition, batching of up to 500 Business Ids is supported in a single request using a comma separated list *(e.g. business_ids=id1,id2)*."}}},"responseSchema":{"type":"object","required":["status","request_id","parameters","data"],"properties":{"data":{"type":"object","required":["businesses","match_count"],"properties":{"businesses":{"type":"array","items":{"type":"object","required":["business_id"],"properties":{"cid":{"type":"string","description":"Google CID (Customer ID) of the business."},"lat":{"type":"number","description":"Latitude of the business location."},"lng":{"type":"number","description":"Longitude of the business location."},"tld":{"type":"string","description":"Domain of the business website."},"city":{"type":"string","description":"City of the business location."},"menu":{"type":"array","items":{"type":"object","required":["title","description","sections"],"properties":{"title":{"type":"string","nullable":true,"description":"Title of the menu."},"sections":{"type":"array","items":{"type":"object","required":["title","description","menu_items"],"properties":{"title":{"type":"string","nullable":true,"description":"Title of the menu section."},"menu_items":{"type":"array","items":{"type":"object","required":["title","description","price","options"],"properties":{"price":{"type":"string","nullable":true,"description":"Price of the menu item as shown on Google Maps."},"title":{"type":"string","description":"Name of the menu item."},"options":{"type":"array","items":{"type":"object","required":["title","description","price"],"properties":{"price":{"type":"string","nullable":true,"description":"Price of the menu item as shown on Google Maps."},"title":{"type":"string","description":"Name of the menu item."},"description":{"type":"string","nullable":true,"description":"Description of the menu item."}},"additionalProperties":false},"nullable":true,"description":"Variants of the menu item, such as sizes."},"description":{"type":"string","nullable":true,"description":"Description of the menu item."}},"additionalProperties":false},"description":"Items listed in this menu section."},"description":{"type":"string","nullable":true,"description":"Description of the menu section."}},"additionalProperties":false},"description":"Sections the menu is split into."},"description":{"type":"string","nullable":true,"description":"Description of the menu."}},"additionalProperties":false},"description":"Menu published by the business, grouped into sections."},"name":{"type":"string","description":"Display name of the business."},"about":{"type":"object","required":["summary","details"],"properties":{"details":{"type":"object","nullable":true,"description":"Structured attribute map, grouped by attribute category (e.g. accessibility, amenities), each mapping an attribute identifier to a boolean.","additionalProperties":{"type":"object","additionalProperties":{"type":"boolean"}}},"summary":{"type":"string","nullable":true,"description":"Free-text description of the business."}},"description":"Free-form summary and a structured details map of business attributes.","additionalProperties":false},"phone":{"type":"string","description":"Business phone number in E.164 format when available."},"state":{"type":"string","description":"State / region of the business location."},"rating":{"type":"number","description":"Average review rating (1-5) on Google Maps."},"status":{"enum":["operational","closed","temporarily_closed"],"type":"string","description":"Operational status of the business. Values: operational, closed, temporarily_closed."},"address":{"type":"string","description":"Full formatted address, including the business name."},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code of the business location."},"website":{"type":"string","description":"Business website URL."},"zipcode":{"type":"string","description":"ZIP / postal code of the business location."},"district":{"type":"string","description":"District or neighbourhood of the business location."},"owner_id":{"type":"string","description":"ID of the Google Maps contributor account that owns this listing."},"place_id":{"type":"string","description":"Google Maps Place ID."},"timezone":{"type":"string","description":"IANA timezone of the business location."},"verified":{"type":"boolean","description":"Whether the business is verified by Google."},"last_seen":{"type":"string","description":"ISO 8601 UTC datetime the listing was last collected."},"open_24_7":{"type":"boolean","description":"Whether the business is open 24 hours a day, every day of the week."},"categories":{"type":"array","items":{"type":"string"},"description":"List of business categories as labelled by Google Maps."},"closed_dow":{"type":"array","items":{"type":"number"},"description":"Days of the week the business is closed, as ISO-8601 day numbers (1 = Monday, 7 = Sunday)."},"first_seen":{"type":"string","description":"ISO 8601 UTC datetime the listing was first collected."},"google_mid":{"type":"string","description":"Google Knowledge Graph machine ID."},"located_in":{"type":"object","required":["google_id","name"],"properties":{"name":{"type":"string","description":"Name of the parent place."},"google_id":{"type":"string","description":"Google ID of the parent place."}},"description":"Parent place this business is located in (e.g. mall) when applicable.","additionalProperties":false},"order_link":{"type":"string","description":"URL to place an order (when published)."},"owner_link":{"type":"string","description":"Link to the owner profile on Google Maps."},"owner_name":{"type":"string","description":"Display name of the owner profile."},"photo_tabs":{"type":"array","items":{"type":"string"},"description":"Names of the photo category tabs Google Maps shows for the business (e.g. 'All', 'Menu', 'Food & drink')."},"place_link":{"type":"string","description":"Google Maps URL for the business."},"price_tier":{"type":"number","description":"Numeric price tier matching price_level, from 1 (least expensive) upwards."},"business_id":{"type":"string","description":"Unique Google identifier of the business."},"hotel_stars":{"type":"number","description":"Hotel-only: star rating (1-5). Present only for hotels."},"photo_count":{"type":"number","description":"Total number of photos available for the business."},"price_level":{"type":"string","description":"Price level as shown on Google Maps (e.g. '$10-20')."},"booking_link":{"type":"string","description":"URL to book a service or appointment (when published)."},"category_ids":{"allOf":[{"type":"array","items":{"type":"string"}},{"type":"object","properties":{}}],"description":"Google's internal entity-type IDs for the business. Broader than categories, and usually several per business."},"last_changed":{"type":"string","description":"ISO 8601 UTC datetime the listing data last changed."},"opening_date":{"type":"string","description":"Date the business opened (when published by Google)."},"review_count":{"type":"number","description":"Total number of Google Maps reviews on the business."},"reviews_link":{"type":"string","description":"URL to view reviews on Google Maps."},"address_short":{"type":"string","description":"Formatted address without the business name."},"main_category":{"type":"string","description":"Primary business category as labelled by Google Maps."},"photos_sample":{"type":"array","items":{"type":"object","required":["photo_id","photo_url","photo_url_large","video_thumbnail_url","latitude","longitude","type","photo_datetime_utc","photo_timestamp"],"properties":{"type":{"enum":["photo","street_view","video"],"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","nullable":true,"description":"URL of the photo (default resolution)."},"photo_timestamp":{"type":"number","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."}},"additionalProperties":false},"description":"Sample of representative photos for the business."},"popular_times":{"type":"array","items":{"type":"object","required":["dow","hours"],"properties":{"dow":{"type":"number","description":"Day of the week, as an ISO-8601 day number (1 = Monday, 7 = Sunday)."},"hours":{"type":"array","items":{"type":"object","required":["hour","busy_pct","label","wait"],"properties":{"hour":{"type":"number","description":"Hour of the day in 24-hour format, in the business timezone."},"wait":{"type":"string","nullable":true,"description":"Typical wait time at this hour, when Google publishes one."},"label":{"type":"string","nullable":true,"description":"Busyness label as shown on Google Maps (e.g. 'Usually not too busy')."},"busy_pct":{"type":"number","description":"How busy the business usually is at this hour, as a percentage of its peak."}},"additionalProperties":false},"description":"Hour-by-hour busyness for this day."}},"additionalProperties":false},"description":"Popular times histogram, one entry per day of the week."},"working_hours":{"type":"object","description":"Working hours map keyed by day of the week. Each value is an array of time-range strings; absent when not published.","additionalProperties":{"type":"array","items":{"type":"string"}}},"opening_status":{"type":"string","description":"Current opening status string as shown on Google Maps (e.g. 'Open', 'Closed', 'Open 24 hours')."},"street_address":{"type":"string","description":"Street name and number portion of the address."},"hotel_amenities":{"type":"object","description":"Hotel-only: map of amenity name to availability (true/false). Present only for hotels.","additionalProperties":{"type":"boolean"}},"main_category_id":{"type":"string","description":"Google's internal ID of the primary category."},"business_services":{"type":"object","description":"Map of service category to the list of services offered (when published by the owner).","additionalProperties":{"type":"array","items":{"type":"string"}}},"reservations_link":{"type":"string","description":"URL to make a reservation (when published)."},"reviews_per_rating":{"type":"object","required":["1","2","3","4","5"],"properties":{"1":{"type":"number","description":"Number of 1-star reviews."},"2":{"type":"number","description":"Number of 2-star reviews."},"3":{"type":"number","description":"Number of 3-star reviews."},"4":{"type":"number","description":"Number of 4-star reviews."},"5":{"type":"number","description":"Number of 5-star reviews."}},"description":"Counts of reviews per integer rating from 1 to 5.","additionalProperties":false},"hotel_review_summary":{"type":"object","description":"Hotel-only: AI-generated review summary. Present only for hotels.","additionalProperties":{"type":"object","required":["score","summary"],"properties":{"score":{"type":"number","nullable":true},"summary":{"type":"string","nullable":true}},"additionalProperties":false}},"hotel_booking_options":{"type":"array","items":{"type":"object","required":["source","price","link","source_favicon"],"properties":{"link":{"type":"string","nullable":true,"description":"URL to book with the provider."},"price":{"type":"string","nullable":true,"description":"Nightly price as shown by the provider."},"rooms":{"type":"array","items":{"type":"object","required":["room_type","link","price"],"properties":{"link":{"type":"string","nullable":true,"description":"URL to book this room type."},"price":{"type":"string","nullable":true,"description":"Price of this room type as shown by the provider."},"room_type":{"type":"string","nullable":true,"description":"Name of the room type."}},"additionalProperties":false},"description":"Room types offered by this provider."},"source":{"type":"string","nullable":true,"description":"Booking provider the option comes from."},"source_favicon":{"type":"string","nullable":true,"description":"URL of the provider favicon."}},"additionalProperties":false},"description":"Hotel-only: booking options (provider, price, link). Present only for hotels with live rates."},"hotel_location_rating":{"type":"object","required":["Overall","Things to do","Transit","Airports"],"properties":{"Overall":{"type":"number","nullable":true,"description":"Hotel-only: overall location rating."},"Transit":{"type":"number","nullable":true,"description":"Hotel-only: location rating for transit access."},"Airports":{"type":"number","nullable":true,"description":"Hotel-only: location rating for airport access."},"Things to do":{"type":"number","nullable":true,"description":"Hotel-only: location rating for things to do nearby."}},"description":"Hotel-only: location rating breakdown when the business is a hotel.","additionalProperties":false},"hotel_results_from_web":{"type":"array","items":{"type":"object","required":["source","link","source_favicon"],"properties":{"link":{"type":"string","nullable":true,"description":"URL of the result."},"source":{"type":"string","nullable":true,"description":"Website the result comes from."},"source_favicon":{"type":"string","nullable":true,"description":"URL of the source favicon."}},"additionalProperties":false},"description":"Hotel-only: additional web-sourced results shown alongside the Google listing."}},"additionalProperties":false},"description":"List of businesses returned."},"match_count":{"type":"number","description":"Number of the requested Business Ids that resolved to a record. An id that matched nothing is absent from the list, so this can be lower than the number of ids sent."}},"description":"Full business records for the requested Business Ids."},"status":{"type":"string","description":"The status of the API response."},"parameters":{"type":"object","description":"The parameters the API received and used for this request, echoed back.","additionalProperties":true},"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_edK6e5Ba-Ng9wHwf_W43S","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 full business details (menu, popular times, services, price tier, hours, photos, and 50+ other fields) for up to 500 Google Maps businesses by their Business ID in a single batched request.","exampleAgentPrompt":"I found a restaurant with business ID '0x102b644d009e013:0xea49e9ee285fa7bf' — can you pull its full details including the menu, popular times, working hours, and price tier?","exampleUseCases":[{"title":"Restaurant menu lookup after search","prompt":"I just searched for pizza places near downtown Chicago and got a list of business IDs — can you fetch the full details for all of them, especially their menus and price tiers, so I can compare options?"},{"title":"Hotel amenities research","prompt":"I have the business ID for The Marriott in San Francisco — can you get me its full details including hotel stars, amenities, location rating, and any booking options?"},{"title":"Business hours and contact enrichment","prompt":"I have a list of 50 business IDs from my leads database — can you batch fetch their working hours, phone numbers, websites, and current opening status for all of them at once?"}],"resultDescription":"Returns a JSON object containing an array of business records (one per matched ID), each with up to 60 fields including name, address, coordinates, phone, website, menu (sections and items with prices), popular times by day/hour, working hours, price tier, rating, review count, photos sample, hotel-specific fields (stars, amenities, booking options), booking/order/reservation links, business services, opening date, and metadata timestamps. The match_count field indicates how many IDs were found; unmatched IDs are silently omitted.","failureModes":["Business ID not found — the ID is simply absent from the response and match_count is lower than the number sent; no explicit error is thrown","Invalid business_id format — may return no matches or an API error","Requesting more than 500 business IDs in one call — likely rejected or truncated","Fields parameter with invalid field names — may cause a 400 validation error","Rate limit or payment required — 402 response if quota exceeded","Menu or popular times fields absent — not all businesses have menus or popular times data populated"],"whenToPreferThis":"Use this endpoint when you already have one or more Business IDs (from a prior search query) and need the full, enriched record including fields not returned by search endpoints — particularly menu data, popular times, price tier, hotel amenities, and business services. It supports batching up to 500 IDs, making it ideal for bulk enrichment workflows. Prefer this over search endpoints when you need depth rather than discovery.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:40.264Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-business-details-by-id-a1acc7aa"}