API reference / CRM
Find local businesses
Local businesses of one kind around a city, from Overture Maps' open data (places from Meta, Microsoft, Foursquare and others; free to use, with credit to the Overture Maps Foundation): names, websites, phone numbers, emails and addresses, open ones Overture is fairly sure of, the surest first. Nothing is saved: add the ones you want to a list with POST /lists/{id}/places. The area is a radius around the city's center, by default one that grows with its population. A city's first search can take up to a minute; answers are kept, so the next is quick.
/api/v1/places/searchOther ways to call it
troopy places searchtroopy_search_placesBody
application/jsoncategory*stringA place category, like dental_clinic, plumbing or coffee_shop: GET /places/categories finds them
At most 80 characters
city*stringAt least 1 characters · At most 100 characters
country*stringThe city's country, as two letters: US, GB, IN
regionstringIts state or region, when the name is common: TX, or US-TX
At most 10 characters
radiusKmnumberHow far from the city's center, in kilometres
At least 1 · At most 100
limitintegerDefault 50 · At least 1 · At most 200
offsetintegerDefault 0 · At least 0 · At most 10000
Response
200 · application/jsondata*object3 properties
center*objectWhere it looked
4 properties
name*stringlat*numberlon*numberradiusKm*numberplaces*array<object>15 properties
id*stringOverture's id for it, stable across its releases
name*stringcategory*string | nullIts most precise category
website*string | nulldomain*string | nullIts website's domain, unless that site is a page on a site many businesses share
phone*string | nullemail*string | nulladdress*string | nullcity*string | nullregion*string | nullpostcode*string | nullcountry*string | nulllat*numberlon*numberconfidence*numberHow sure Overture is that it exists, 0 to 1
more*booleanThere are more: ask again with offset