{"uid":"cap__taAmTUI5b_yMjjOp_2Dr","slug":"agents-openwebninja-com-area-search-bounding-box-local-business-search-4f943658","name":"Area Search (Bounding Box) — Local Business Search","description":"Search businesses within a rectangular area defined by its bottom-left (south-west) and top-right (north-east) corner coordinates.","url":"https://agents.openwebninja.com/local-business-data/area-search-by-bounding-box?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["query","bottom_left","top_right"],"properties":{"limit":{"type":"string","default":20,"description":"Maximum number of businesses to return.  \n\n  **Allowed values:** `1-500`"},"query":{"type":"string","example":"pizza","description":"Search query / keyword"},"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*."},"subtypes":{"type":"string","description":"Find businesses with specific subtypes, specified as a comma separated list of types (business categories).  \n  For the complete list of types, see *https://daltonluka.com/blog/google-my-business-categories*.  \n  \n  **Examples:**  \n  `Plumber,Carpenter,Electrician`  \n  `Night club,Dance club,Bar,Pub`  "},"top_right":{"type":"string","example":"40.812151,-73.910522","description":"The top-right (north-east) corner of the bounding box to search in, as a \"lat,lng\" string."},"bottom_left":{"type":"string","example":"40.606540,-74.013580","description":"The bottom-left (south-west) corner of the bounding box to search in, as a \"lat,lng\" string."},"extract_emails_and_contacts":{"type":"boolean","default":false,"description":"Extract emails, contacts and social profiles for each business in the response.  \n  In case true, businesses will be enriched with a emails_and_contacts field with emails, phones, Facebook, LinkedIn, Instagram and other social profiles.\n  \n  **Note:** in case `true`, the endpoint will scrape emails and contacts from the business website (in case non-empty).  \n  For each such business, the API will charge an additional credit."}}},"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":{"lat":{"type":"number","description":"Latitude bias center used for the search."},"lng":{"type":"number","description":"Longitude bias center used for the search."},"zoom":{"type":"integer","description":"Map zoom level used for the search."},"limit":{"type":"integer","description":"Maximum number of results requested."},"query":{"type":"string","description":"The search query as received."},"offset":{"type":"integer","description":"Number of results skipped (for pagination)."},"region":{"type":"string","description":"The region/country code used for the search."},"language":{"type":"string","description":"The language code used for the search."},"extract_emails_and_contacts":{"type":"boolean","description":"Whether email/contact extraction was requested for each business."}},"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_XCZN7deLp5pH24mi8JrdI","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":"Search for businesses matching a keyword within a rectangular geographic area defined by south-west and north-east corner coordinates.","exampleAgentPrompt":"Find up to 50 pizza restaurants within the Manhattan bounding box — bottom-left at 40.606540,-74.013580 and top-right at 40.812151,-73.910522 — and include their ratings, addresses, and websites.","exampleUseCases":[{"title":"Restaurant discovery in a neighborhood","prompt":"Show me the top 30 Italian restaurants within the SoHo area of Manhattan — use the bounding box from 40.720,-74.005 (bottom-left) to 40.730,-73.995 (top-right) and include their ratings and websites."},{"title":"Competitor mapping for a local business","prompt":"I need a list of all hair salons and barbershops within a 2-mile radius of downtown Austin — the bounding box is 30.255,-97.760 at the bottom-left and 30.275,-97.730 at the top-right. Give me up to 100 results with their addresses and phone numbers."},{"title":"Lead generation with contact extraction","prompt":"Find up to 200 plumbers, electricians, and HVAC contractors within the Chicago suburbs bounding box from 41.800,-88.000 (bottom-left) to 42.050,-87.800 (top-right), and extract their emails and social profiles too."}],"resultDescription":"Returns an array of business objects, each containing: business ID, Google Maps ID, name, primary category, address (street, city, state, zip, country), latitude/longitude, rating, review count, phone number, website URL, operating hours, business status, subtypes, owner information, and optionally emails and social media contacts. Also includes request metadata and status.","failureModes":["Missing required parameters (query, bottom_left, top_right) returns 400 validation error","Invalid coordinate format (not 'lat,lng') returns parsing error","Bounding box too large may return incomplete or truncated results","Region/language codes not matching ISO 639-1 may default or fail","extract_emails_and_contacts=true significantly increases latency and may time out for large result sets","No businesses found in the area returns an empty data array","Rate limit exceeded returns 429 or payment-required error"],"whenToPreferThis":"Use this endpoint when you need to search businesses within a specific rectangular map area (e.g. drawn on a map, defined by known corner coordinates). It is ideal for geofenced business discovery, competitive landscape mapping, lead generation within a territory, or powering map-based UIs. Prefer this over point-radius search when your area of interest is naturally rectangular or when you have exact bounding box coordinates. Choose over a text-based location search when precision matters and you already have coordinate boundaries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:37:04.318Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-area-search-bounding-box-local-business-search-4f943658"}