SAPI key features and benefits are outlined here for developers seeking a business search API solution for Yellow Pages®, White Pages® and Location & Navigation listings and advertising content.
No-one understands the "local search" market better than Sensis.
Leveraging over 100 years experience in publishing directories, SAPI contains loads of rich functionality to help you meet the needs and expectations of your target audience.
- Search — Two box search i.e. What + Where
- OneSearch — One box search i.e. What/Where disambiguation
- Auto-Suggest — Configurable syndicated auto-suggest (aka Suggest oneSearch) service can be used for OneSearch or Search, configurable down to the subheading-level
- View a Business Listing — Get details of any given business listing using listing ID
- Search Hints — Ability to change algorithm to use the Bounding Box as a parameter (see 'hint=PLACE')
- POIs — Ability to turn on Non-Business Points of Interest in SAPI (see 'includePois=true')
- User Defined Polygons — Ability to deliver search results into a custom polygon
Search Feature Overview
Conducting a Search
Typically, access to the API is via a search string, which contains a keyword and a location (a "what & where" search).
Search strings can be entered by users and sometimes be either erroneous or ambiguous. The following functionality will help improve the results you can provide to your end-users:
- common mis-spellings (eg. "accomodation" rather than "accommodation" or "Woolongong" rather than "Wollongong")
- leveraging our understanding of users previous behaviour (eg. a user entering the search term "wedding" can generate results from many different types of businesses – wedding reception centres, wedding planners, limousines, florists etc).
- alias names (eg, "DJ's" rather than "David Jones" or "Woolies" rather than "Woolworths"
- location & postcode-based search
- vanity locations (eg. Clarinda in the south-eastern suburbs of Melbourne is an "area" known by locals, however not officially classified as a suburb)
SAPI considers a range of criteria when determining the best possible search results. Criteria include the relevancy of a business to the search string and the distance of the business from the nominated location.
Once an end-user has conducted a search, the API can be configured to return results in the following ways:
- relevancy to the search string entered (eg, all businesses that have some association with bottle shops)
- alphanumerically (eg, all businesses that have some association with bottle shops, returned in alphanumeric order).
You can also restrict your search results to return business details from a specific postcode, a range of postcodes or a specific "category" of information (eg. pet-related services for a "pet-friendly" web-site).
One of the unique benefits of SAPI is the way different types of businesses are "modelled". SAPI contains different identifiers for the following different types of businesses:
- A single business location (eg, State Library of Victoria is located at 382 Swanston Street, Melbourne or a Repco store is located at a specific address).
- A mobile business that has no specific business location & services a nominated area (eg, a dog-washing service that services Glenelg, West Beach & Plympton, SA).
Coming soon will be details of a business that services a particular area (eg. a Fortitude Valley Accountancy practice that that services individuals in the surrounding suburbs of Brisbane, New Farm & Bowen Hills, Queensland)
SAPI contains over 2 million business listings sourced from the Yellow Pages®, White Pages® and Location & Navigation.
As a minimum, each business listing contains a business name, location (if applicable) & basic contact details.
Many business listings contain additional details. Where available, these details include:
- web & email addresses
- business logos
- video link
- business classification
- business descriptions
- areas serviced
- business keywords
- opening hours
- business coupons
- relevant deep links to third party sites (social media pages, instant-messaging, online purchasing)
Further details can be found in the API technical documentation.