Step 5: GeoSearch

The Entities: GeoSearch endpoint is used to return entities that are within a certain radius of a specified address. The response is ordered by proximity to the address and restricted to the given radius. The values for the location you would like to search around can be specified in one of two ways:

  • Latitude and longitude: The latitude and longitude of the point, separated by a comma (e.g., 40.740957,-73.987565)
  • Address: A freeform address to geocode into a latitude and longitude (e.g., 61 Ninth Ave, New York, NY 10011 or New York, NY)

Note that providing an address that resolves to an area, like a city or a ZIP code, does not restrict the search to exactly that area; it simply centers the search circle on a point in that area.

To search for a entities with 10 miles of the center point of ZIP code 10010, send the following request:

NOTE: In the response, we return both a geo object and distances array. The geo object provides information on where the search was centered, and the distances array provides data on the distance of the returned entities from the search point.