{"uid":"cap_chzQxl-YksYnjP0H1Dm4Y","slug":"handel-local-business-search-openstreetmap-overpass-f8a108b6","name":"Handel Local Business Search (OpenStreetMap/Overpass)","description":"Searches OpenStreetMap through Overpass for businesses of a chosen trade within a radius of a coordinate, and returns each with its name, address, opening hours, phone, website, and the distance from your point, sorted nearest first. Around thirty trades are mapped to the OSM tags that actually hold them, because OSM is indexed by tags and not by free text — a plain word search finds almost nothing there.","url":"https://handel.halowerk.com/v1/local-business","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","default":20,"maximum":100,"minimum":1,"description":"How many results."},"trade":{"enum":["bakery","butcher","supermarket","restaurant","cafe","bar","pharmacy","doctor","dentist","hotel","bank","atm","fuel","car_repair","hairdresser","hardware","electronics","clothes","bookshop","florist","optician","veterinary","school","kindergarten","post_office","laundry","bicycle","craft","office","any_shop"],"type":"string","description":"Which trade to search for."},"latitude":{"type":"number","maximum":90,"minimum":-90,"description":"Centre latitude."},"longitude":{"type":"number","maximum":180,"minimum":-180,"description":"Centre longitude."},"radius_km":{"type":"number","default":2,"maximum":25,"minimum":0.1,"description":"Search radius in kilometres."},"require_name":{"type":"boolean","default":true,"description":"Skip entries with no name — unnamed points are rarely useful."},"open_now_only":{"type":"boolean","default":false,"description":"Only entries that declare opening hours (the hours are returned, not evaluated)."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iSZmwYQazaoOUVfLWhzmT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches OpenStreetMap via Overpass for businesses of a specific trade type within a radius of a coordinate, returning name, address, opening hours, phone, website, and distance sorted nearest first.","exampleAgentPrompt":"Find me all pharmacies within 1 kilometer of latitude 48.8566, longitude 2.3522, and give me their names, addresses, opening hours, and phone numbers sorted by distance.","exampleUseCases":[{"title":"Nearby restaurant finder for travelers","prompt":"I'm at coordinates 52.5200 N, 13.4050 E in Berlin — show me all restaurants within 800 meters, with their addresses, opening hours, and websites."},{"title":"Emergency plumber locator on-site","prompt":"I'm on a job site at latitude 51.5074, longitude -0.1278 and need a plumber urgently — find every plumber within 2 kilometers and give me their phone numbers."},{"title":"Retail store scout for market research","prompt":"Can you find all supermarkets within 3 kilometers of latitude 40.7128, longitude -74.0060, including their names, addresses, and websites?"}],"resultDescription":"An ordered list of businesses of the requested trade near the given coordinate, each including: business name, street address, opening hours, phone number, website URL, and straight-line distance from the query point in meters, sorted nearest first.","failureModes":["Unsupported trade type not in the ~30 mapped OSM tag categories returns an error or empty results","Coordinates outside populated areas return empty result sets","Very large radius or dense urban area may return many results or time out on Overpass","Incomplete OSM data for the region means some businesses may be missing phone/hours/website fields","Network or Overpass API timeout returns a service error"],"whenToPreferThis":"Use this endpoint when you need structured local business listings anchored to a geographic coordinate and a specific trade type, and want results that include contact details and opening hours. It is especially valuable when OpenStreetMap data quality is high (Europe, urban areas) and you need trade-to-OSM-tag mapping handled automatically rather than writing raw Overpass QL queries yourself. Prefer it over generic geocoding APIs when you need distance-sorted results with business metadata in one call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:45:23.813Z","isFirstParty":false}