{"uid":"cap_uam7j2YfBojIVqXrNoiJo","slug":"agents-openwebninja-com-business-details-plus-5d4c4ae0","name":"Business Details Plus","description":"Get full business details PLUS additional AI-powered enrichments — currently includes `keywords_mentioned_in_reviews`, an array of the keywords most frequently surfaced in the business' Google Maps reviews together with how many reviews mention each.\n\n  All `/business-details` request parameters and response fields are supported.\n\n  **Cost: 2 credits per business.**\n\n  Supports batching of up to 20 Business Ids.","url":"https://agents.openwebninja.com/local-business-data/business-details-plus?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["business_id"],"properties":{"fields":{"type":"string","description":"A comma separated list of business 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)*."},"language":{"type":"string","default":"en","description":"Set the language of the results.\n  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`\n\n  In addition, batching of up to 20 Business Ids is supported in a single request using a comma separated list *(e.g. business_id=id1,id2)*."},"coordinates":{"type":"string","description":"Geographic coordinates of the location from which the query is applied - recommended to use so that results are biased towards this location.\n  Defaults to some central location in the region (see the region parameter)."},"extract_share_link":{"type":"boolean","default":false,"description":"Whether to extract place's share link for the business.\n  In case true, businesses will be enriched with a share_link field containing a shortened Google URL for sharing."},"extract_emails_and_contacts":{"type":"boolean","default":true,"description":"Whether to extract emails, contacts and social profiles for the business.\n  In case true, businesses will be enriched with an emails_and_contacts field, potentially containing emails, phones, Facebook, LinkedIn, Instagram and other social profiles."}}},"responseSchema":{"type":"object","required":["status","request_id","parameters","data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["business_id","google_id","name","business_status"],"properties":{"cid":{"type":"string","nullable":true,"description":"Google CID (Customer ID) of the business."},"tld":{"type":"string","nullable":true,"description":"Top-level domain of the business website."},"city":{"type":"string","nullable":true,"description":"City of the business location."},"name":{"type":"string","description":"Display name of the business."},"type":{"type":"string","nullable":true,"description":"Primary business category as labelled by Google Maps."},"about":{"type":"object","nullable":true,"properties":{"details":{"type":"object","nullable":true,"description":"Map of attribute groups (e.g. Amenities, Crowd, Service options) to attribute name -> 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."},"state":{"type":"string","nullable":true,"description":"State / region of the business location."},"rating":{"type":"number","nullable":true,"description":"Average review rating (1-5) on Google Maps."},"address":{"type":"string","nullable":true,"description":"Street address line of the business."},"country":{"type":"string","nullable":true,"description":"ISO 3166-1 alpha-2 country code of the business location."},"website":{"type":"string","nullable":true,"description":"Business website URL."},"zipcode":{"type":"string","nullable":true,"description":"ZIP / postal code of the business location."},"district":{"type":"string","nullable":true,"description":"District or neighbourhood of the business location."},"latitude":{"type":"number","description":"Latitude of the business location."},"owner_id":{"type":"string","nullable":true,"description":"ID of the Google Maps contributor account that owns this listing."},"place_id":{"type":"string","description":"Google Maps Place ID."},"subtypes":{"type":"array","items":{"type":"string"},"nullable":true,"description":"List of additional business categories."},"timezone":{"type":"string","nullable":true,"description":"IANA timezone of the business location."},"verified":{"type":"boolean","description":"Whether the business is verified by Google."},"directory":{"type":"array","items":{"type":"object","additionalProperties":true},"nullable":true,"description":"List of businesses located in the same building / directory (e.g. mall, plaza). Conditional."},"google_id":{"type":"string","description":"Google's internal hexadecimal ID of the business."},"longitude":{"type":"number","description":"Longitude of the business location."},"menu_link":{"type":"string","nullable":true,"description":"URL of the business menu (when published)."},"google_mid":{"type":"string","nullable":true,"description":"Google Knowledge Graph machine ID."},"located_in":{"type":"object","nullable":true,"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."},"order_link":{"type":"string","nullable":true,"description":"URL to place an order (when published)."},"owner_link":{"type":"string","nullable":true,"description":"Link to the owner profile on Google Maps."},"owner_name":{"type":"string","nullable":true,"description":"Display name of the owner profile."},"place_link":{"type":"string","description":"Google Maps URL for the business."},"posts_link":{"type":"string","nullable":true,"description":"URL to the full list of owner posts on Google Maps."},"share_link":{"type":"string","nullable":true,"description":"Shortened Google Maps share URL for the business. Returned when extract_share_link=true."},"business_id":{"type":"string","description":"Unique Google identifier of the business. Same value as google_id."},"hotel_stars":{"type":"integer","nullable":true,"description":"Hotel-only: star rating (1-5). Present only for hotels."},"photo_count":{"type":"integer","nullable":true,"description":"Total number of photos available for the business."},"price_level":{"type":"string","nullable":true,"description":"Price level as shown on Google Maps (e.g. '$', '$$')."},"booking_link":{"type":"string","nullable":true,"description":"URL to book a service or appointment."},"full_address":{"type":"string","description":"Full formatted address including business name."},"opening_date":{"type":"string","nullable":true,"description":"Date the business opened (when published by Google)."},"phone_number":{"type":"string","nullable":true,"description":"Business phone number in E.164 format when available."},"posts_sample":{"type":"array","items":{"type":"object","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."}}},"nullable":true,"description":"Sample of the most recent owner posts. Present in /business-details and /business-details-plus."},"review_count":{"type":"integer","nullable":true,"description":"Total number of Google Maps reviews on the business."},"reviews_link":{"type":"string","nullable":true,"description":"URL to view reviews on Google Maps."},"photos_sample":{"type":"array","items":{"type":"object","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":"Google Maps photo ID."},"longitude":{"type":"number","nullable":true,"description":"Longitude where the photo was taken (when known)."},"photo_url":{"type":"string","description":"URL of the photo (lower-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."}}},"nullable":true,"description":"Up to ~10 representative photos for the business."},"subtype_gcids":{"type":"array","items":{"type":"string"},"nullable":true,"description":"Internal Google category IDs corresponding to the primary type and subtypes."},"working_hours":{"type":"object","nullable":true,"description":"Working hours map keyed by day of the week. Each value is an array of time-range strings; empty object when not published.","additionalProperties":{"type":"array","items":{"type":"string"}}},"opening_status":{"type":"string","nullable":true,"description":"Current opening status string as shown on Google Maps (e.g. 'Open', 'Closed', 'Open 24 hours')."},"reviews_sample":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","description":"Star rating given in the review (1-5)."},"author_id":{"type":"string","nullable":true,"description":"Google Maps contributor ID of the review author."},"review_id":{"type":"string","description":"Unique Google identifier of the review."},"like_count":{"type":"integer","nullable":true,"description":"Number of likes the review received."},"author_link":{"type":"string","nullable":true,"description":"URL to the author's Google Maps profile."},"author_name":{"type":"string","nullable":true,"description":"Display name of the review author."},"review_form":{"type":"object","nullable":true,"description":"Structured questions the author answered (e.g. 'What kind of trip was it?').","additionalProperties":{"type":"string"}},"review_link":{"type":"string","nullable":true,"description":"Direct Google Maps URL to the review."},"review_text":{"type":"string","nullable":true,"description":"Full text content of the review."},"review_photos":{"type":"array","items":{"type":"string"},"nullable":true,"description":"URLs of photos attached to the review."},"review_source":{"type":"string","nullable":true,"description":"Platform the review originates from (e.g. 'Google', 'Tripadvisor')."},"review_language":{"type":"string","nullable":true,"description":"ISO 639 language code of the review text."},"service_quality":{"type":"string","nullable":true,"description":"Optional service-quality tag the author selected."},"author_photo_url":{"type":"string","nullable":true,"description":"URL of the author's profile photo."},"review_timestamp":{"type":"integer","nullable":true,"description":"Unix epoch seconds matching review_datetime_utc."},"author_review_count":{"type":"integer","nullable":true,"description":"Number of reviews this author has posted."},"author_reviews_link":{"type":"string","nullable":true,"description":"URL to all reviews by this author."},"owner_response_text":{"type":"string","nullable":true,"description":"Text of the business owner's response."},"review_datetime_utc":{"type":"string","nullable":true,"description":"ISO 8601 UTC datetime when the review was posted."},"hotel_rating_breakdown":{"type":"object","nullable":true,"description":"Hotel-only: per-aspect ratings (Rooms, Service, Location, etc.).","additionalProperties":{"type":"integer"}},"owner_response_language":{"type":"string","nullable":true,"description":"ISO 639 language code of the owner response."},"author_local_guide_level":{"type":"integer","nullable":true,"description":"Google Local Guide level (1-10) of the author."},"owner_response_timestamp":{"type":"integer","nullable":true,"description":"Unix epoch seconds matching owner_response_datetime_utc."},"owner_response_datetime_utc":{"type":"string","nullable":true,"description":"ISO 8601 UTC datetime when the business owner responded."}}},"nullable":true,"description":"Sample of recent reviews. Present in /business-details and /business-details-plus."},"street_address":{"type":"string","nullable":true,"description":"Street name and number portion of the address."},"business_status":{"type":"string","description":"Operational status. Values: OPEN, CLOSED_TEMPORARILY, CLOSED_PERMANENTLY."},"hotel_amenities":{"type":"object","nullable":true,"description":"Hotel-only: map of amenity name to availability (true/false). Present only for hotels.","additionalProperties":{"type":"boolean"}},"global_plus_code":{"type":"string","nullable":true,"description":"Global Open Location Code (Plus Code) for the business location."},"business_services":{"type":"object","nullable":true,"description":"Map of service category -> list of services offered (when published by the owner).","additionalProperties":{"type":"array","items":{"type":"string"}}},"reservations_link":{"type":"string","nullable":true,"description":"URL to make a reservation."},"compound_plus_code":{"type":"string","nullable":true,"description":"Compound (short) Plus Code with a nearby locality."},"reviews_per_rating":{"type":"object","nullable":true,"properties":{"1":{"type":"integer","description":"Number of 1-star reviews."},"2":{"type":"integer","description":"Number of 2-star reviews."},"3":{"type":"integer","description":"Number of 3-star reviews."},"4":{"type":"integer","description":"Number of 4-star reviews."},"5":{"type":"integer","description":"Number of 5-star reviews."}},"description":"Counts of reviews per integer rating from 1 to 5."},"emails_and_contacts":{"type":"object","nullable":true,"properties":{"yelp":{"type":"string","nullable":true,"description":"Yelp listing URL."},"emails":{"type":"array","items":{"type":"string"},"description":"Email addresses found on the business website."},"github":{"type":"string","nullable":true,"description":"GitHub profile URL."},"tiktok":{"type":"string","nullable":true,"description":"TikTok profile URL."},"twitter":{"type":"string","nullable":true,"description":"Twitter/X profile URL."},"youtube":{"type":"string","nullable":true,"description":"YouTube channel URL."},"facebook":{"type":"string","nullable":true,"description":"Facebook profile URL."},"linkedin":{"type":"string","nullable":true,"description":"LinkedIn profile URL."},"snapchat":{"type":"string","nullable":true,"description":"Snapchat profile URL."},"instagram":{"type":"string","nullable":true,"description":"Instagram profile URL."},"pinterest":{"type":"string","nullable":true,"description":"Pinterest profile URL."},"phone_numbers":{"type":"array","items":{"type":"string"},"description":"Phone numbers found on the business website."}},"description":"Emails and social-network profiles extracted from the business website. Populated when extract_emails_and_contacts=true (the default for /business-details)."},"hotel_review_summary":{"type":"object","nullable":true,"description":"Hotel-only: AI-generated review summary. Present only for hotels.","additionalProperties":true},"hotel_booking_options":{"type":"array","items":{"type":"object","additionalProperties":true},"nullable":true,"description":"Hotel-only: array of booking options (provider, price, link). Present only for hotels with live rates."},"hotel_location_rating":{"type":"object","nullable":true,"description":"Hotel-only: location rating breakdown when the business is a hotel.","additionalProperties":true},"hotel_price_for_dates":{"type":"string","nullable":true,"description":"Hotel-only: nightly price string when Google has live rates."},"requested_business_id":{"type":"string","description":"The exact business_id from the request, echoed back. Useful when batching multiple IDs."},"hotel_results_from_web":{"type":"array","items":{"type":"object","additionalProperties":true},"nullable":true,"description":"Hotel-only: additional web-sourced results / reviews shown alongside the Google listing."},"keywords_mentioned_in_reviews":{"type":"array","items":{"type":"object","required":["keyword","review_count"],"properties":{"keyword":{"type":"string","description":"The keyword extracted from reviews."},"review_count":{"type":"integer","description":"Number of reviews mentioning this keyword."}}},"nullable":true,"description":"Keywords most frequently mentioned in reviews, with counts. Returned by /business-details-plus only (AI-enriched, ?extended_details=true)."}}},"description":"List of businesses returned."},"status":{"type":"string","description":"The status of the API response."},"parameters":{"type":"object","properties":{"region":{"type":"string","description":"The region/country code used for the response."},"language":{"type":"string","description":"The language code used for the response."},"business_id":{"type":"string","description":"The business_id as received in the request."},"coordinates":{"type":"string","description":"Geographic bias coordinates used (lat,lng)."},"extract_share_link":{"type":"boolean","description":"Whether a Google Maps share link was extracted."},"extract_emails_and_contacts":{"type":"boolean","description":"Whether email/contact extraction was performed."}},"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_3ELa79u8fcf1QYeldTo52","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":"Fetches full Google Maps business details enriched with AI-extracted review keywords and their mention counts, supporting up to 20 businesses per request.","exampleAgentPrompt":"Pull up everything you can about the restaurant with Google place ID ChIJkaUn1JPTD4gR7ZWpE9cCuow — I especially want to see which keywords come up most often in its Google Maps reviews and how many times each is mentioned.","exampleUseCases":[{"title":"Review keyword research for competitor analysis","prompt":"I'm researching two coffee shops I'm competing with — their Google place IDs are ChIJkaUn1JPTD4gR7ZWpE9cCuow and ChIJ2eUgeAK6j4ARbn5u_wAGqWA. Can you pull their full Google Maps profiles and tell me what keywords customers mention most in their reviews?"},{"title":"Lead enrichment with review insights for sales outreach","prompt":"I have a list of 10 local gym businesses I want to reach out to — here are their Google business IDs: id1,id2,id3,id4,id5,id6,id7,id8,id9,id10. Get me their full contact info including emails and social profiles, plus what topics customers keep bringing up in their Google reviews."},{"title":"Restaurant vetting with review topic overview","prompt":"Before I decide whether to partner with this catering company — Google place ID ChIJN1t_tDeuEmsRUsoyG83frY4 — can you get me their full Google Maps profile and show me what people talk about most in their reviews?"}],"resultDescription":"Returns an array of business objects each containing standard Google Maps business fields (name, address, rating, category, website, hours, photos, latitude/longitude, etc.) plus an AI-generated `keywords_mentioned_in_reviews` array listing the most frequent review keywords alongside how many reviews mention each. Optionally includes extracted emails, phone numbers, and social media profiles.","failureModes":["Invalid or unrecognized business_id returns empty data array or error status","Batch exceeding 20 business IDs rejected with validation error","Business has no reviews — keywords_mentioned_in_reviews returns empty array","Region or language code not supported returns error or defaults","Insufficient credits (2 credits per business) causes payment/authorization failure","Private or permanently closed business may return limited fields"],"whenToPreferThis":"Choose this endpoint over the standard Business Details endpoint when you need AI-powered review keyword analysis in addition to standard business data. It is ideal for competitive research, reputation monitoring, lead enrichment, or any workflow that needs to understand what customers frequently discuss about a business. Use it when batching up to 20 businesses at once is needed and you want both structured business metadata and semantic review insights in a single call. Costs 2 credits per business vs 1 for plain business details.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:53.315Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-business-details-plus-5d4c4ae0"}