{"uid":"cap_ohko6KZQcXz48bWwqidzj","slug":"agents-openwebninja-com-local-business-area-search-by-radius-e030f020","name":"Local Business Area Search by Radius","description":"Search businesses within a circular area defined by a center coordinate point (lat, lng) and a radius in meters.","url":"https://agents.openwebninja.com/local-business-data/area-search-by-radius?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["query","lat","lng","radius"],"properties":{"lat":{"type":"string","default":37.359428,"example":"37.359428","description":"Latitude of the center coordinate point of the area to search in."},"lng":{"type":"string","default":-121.925337,"example":"-121.925337","description":"Longitude of the center coordinate point of the area to search in."},"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."},"radius":{"type":"string","example":"5000","description":"The radius (in meters) of the circular search area around the center coordinate point (lat, lng). Allowed values: 1-50000."},"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`  "},"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_7cw39Pr-OUDycxAo7z4QX","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 circular geographic area defined by a center coordinate and radius in meters, sourcing data from Google Maps.","exampleAgentPrompt":"Find all pizza restaurants within 5000 meters of latitude 37.359428, longitude -121.925337 — return up to 30 results in English.","exampleUseCases":[{"title":"Competitor density mapping for a new store","prompt":"I'm scouting a location for a new coffee shop. Can you find all coffee shops and cafes within 2000 meters of latitude 40.712776, longitude -74.005974 and return up to 50 results so I can assess how competitive the area is?"},{"title":"Emergency trades lookup near a job site","prompt":"I need to find plumbers, electricians, and carpenters within 3000 meters of lat 51.507351, lng -0.127758 in the UK — show me up to 20 results with their contact details if possible."},{"title":"Nightlife venue discovery for an event guide","prompt":"Pull me a list of night clubs, bars, and pubs within 1500 meters of latitude 48.858844, longitude 2.294351 in Paris — up to 100 results in French please."}],"resultDescription":"Returns an array of business objects, each containing the business name, address, city, state, country, ZIP code, latitude/longitude, primary category/type, Google rating, review count, phone number, website URL, opening hours, business status, Google business ID, and optionally extracted emails and social contacts. Also includes the request parameters and a status/request ID for tracking.","failureModes":["Missing required parameters (query, lat, lng, or radius) return a 400 validation error","Radius outside the 1–50000 meter range may be rejected","Unsupported region or language codes may default or return empty results","No businesses matching the query in the area returns an empty data array","Network or upstream Google Maps issues may cause 500 errors or timeouts","Rate limits or payment failures return 402 or 429 responses"],"whenToPreferThis":"Choose this endpoint when you need to find businesses within a precise circular geographic boundary defined by coordinates, rather than a named location string. It is ideal for geospatial workflows, mapping applications, or when you already have lat/lng from another source and want to search within an exact meter-radius. Prefer this over text-based location search when precision matters and coordinates are already known.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:35:49.637Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-local-business-area-search-by-radius-e030f020"}