Select an API to view Documentation: 


This API retrieves a list of businesses for a particular business.



/search_businesses



Search By Geocode and Radius

Name Data Type Required Description
api_key string YES API Key that was given to you at API registration
version string YES Version of the API (Current version = 1)
lat double YES Latitude to use as search center
lng double YES Longitude to use as search center
search_radius double NO Search radius in miles to use for search. Maximum = 25 miles.
page integer YES Page number of result. Results are returned 20 at a time.
keyword string NO Keyword to filter by. This will search business name and business type.

Sample Request

http://www.findmespecials.com/api/search_businesses?api_key=YOUR_KEY&version=1&lat=32.909078&lng=-96.690931&search_radius=10.0&page=1

 

Search by Address:

Name Data Type Required Description
api_key string YES API Key that was given to you at API registration
version string YES Version of the API (Current version = 1)
location string YES Address to search
search_radius double NO Search radius in miles to use for search. Maximum = 25 miles.
page integer YES Page number of result. Results are returned 20 at a time.
keyword string NO Keyword to filter by. This will search business name and business type.

Sample Request

http://www.findmespecials.com/api/search_businesses?api_key=YOUR_KEY&version=1&location=30309&search_radius=10.0&page=1



 

Response Values

Response Node Data Type Number of times occuring Description
response Node 1 Response body
response_header Node 1 Response summary.
Attributes include:
status:Response Status.
page_count:Number of pages available in result.
page_size:Number of results per page
businesses_count:Total number of businesses available in result.
current_page:Current returned page.
businesses Node 1 Container for businesses
business.name string 1 for each business Business name
business.address string 1 for each business Business Address
business.city string 1 for each business Business City
business.state string 1 for each business Business State
business.zip string 1 for each business Business Zip
business.distance string 1 for each business Distance from Geocoded center
business.phone string 1 for each business Business phone number
business.website string 1 for each business Business website
business.fms_url string 1 for each business URL for business on FindMeSpecials
business.fme_url string 1 for each business URL for business on FindMeEvents
business.photo_url string 1 for each business URL for Business Photo (75x75 thumbnail)

 

Sample Response

        
        <?xml version="1.0" encoding="UTF-8"?>
        <response>
          <response_header businesses_count="3" status="OK" page_size="20" current_page="1" page_count="1"/>
          <businesses>
            <business id="4383">
              <name>Taco Mac - Metropolis</name>
              <address>949 Peachtree Street</address>
              <city>Atlanta</city>
              <state>GA</state>
              <zip>30309</zip>
              <phone></phone>
              <website>http://www.taco-mac.com</website>
              <fms_url>http://www.findmespecials.com/locations/4383</fms_url>
              <fme_url>http://www.findmeevents.com/locations/4383</fme_url>
              <photo_url>http://s3.amazonaws.com/GetBeezy/photos/49344/IMG_5199.JPG_Thumbnail1_mini.jpg</photo_url>
            </business>
            <business id="34687">
              <name>The Original El Taco</name>
              <address>1186 North Highland Ave Ne</address>
              <city>Atlanta</city>
              <state>GA</state>
              <zip>30306</zip>
              <phone>(404) 873 4656</phone>
              <website>http://www.eltaco-atlanta.com</website>
              <fms_url>http://www.findmespecials.com/locations/34687</fms_url>
              <fme_url>http://www.findmeevents.com/locations/34687</fme_url>
            </business>
            <business id="267">
              <name>Taco Cabana</name>
              <address>1895 Piedmont Ave NE</address>
              <city>Atlanta</city>
              <state>GA</state>
              <zip>30324</zip>
              <phone></phone>
              <website></website>
              <fms_url>http://www.findmespecials.com/locations/267</fms_url>
              <fme_url>http://www.findmeevents.com/locations/267</fme_url>
              <photo_url>http://s3.amazonaws.com/GetBeezy/photos/189793/hd_logo.gif_Thumbnail1_mini.jpg</photo_url>
            </business>
          </businesses>
        </response>