Yahoo! Search Web Services - Local Search (V1) Documentation

Support & Community

The Local Search service is discussed on the yws-search-general mailing list.

Request URL

http://local.yahooapis.com/LocalSearchService/V1/localSearch

Request parameters

See information on constructing REST queries

Parameter	Value	Description
appid	string (required)	The application ID. See Application IDs for more information.
query	string (required)	The query to search for.
results	integer: default 10, max 20	The number of results to return.
start	integer: default 1	The starting result position to return (1-based).
sort	relevance (default), title, distance, or rating	Sorts the results by the chosen criteria.
radius	float	How far (in miles) from the specified location to search for the query terms. The default radius varies according to the location given.
street	string	Street name. The number is optional.
city	string	City name.
state	string	The United States state. You can spell out the full state name or you can use the two-letter abbreviation.
zip	integer or <integer>-<integer>	The five-digit zip code, or the five-digit code plus four-digit extension. If this location contradicts the city and state specified, the zip code will be used for determining the location and the city and state will be ignored.
location	free text	This free field lets users enter any of the following: city, state city, state, zip zip street, city, state street, city, state, zip street, zip If location is specified, it will take priority over the individual fields in determining the location for the query. City, state and zip will be ignored.
latitude	float: -90 to 90	The latitude of the starting location.
longitude	float: -180 to 180	The longitude of the starting location. If both latitude and longitude are specified, they will take priority over all other location data. If only one of latitude or longitude is specified, both will be ignored.

Sample Request Url: http://local.yahooapis.com/LocalSearchService/V1/localSearch?appid=YahooDemo&query=pizza&zip=94306&results=2

Response fields

The schema document for this service response is located at http://local.yahooapis.com/LocalSearchService/V1/LocalSearchRepsonse.xsd

Field	Description
ResultSetMapUrl	The URL of a webpage containing a map graphic with all returned results plotted on it.
ResultSet	Contains all of the query responses.
Result	Contains each individual response.
totalResultsAvailable	The number of query matches in the database.
totalResultsReturned	The number of query matches returned. This may be lower than the number of results requested if there were fewer total results available.
firstResultPosition	The position of the first result in the overall search.
Title	Name of the result.
Address	Street address of the result.
City	City in which the result is located.
State	State in which the result is located.
Phone	Phone number of the business, if known.
Rating	End-user ratings for the business or service.
Distance	The distance as calculated by one of the following methods: When you enter a street address along with your search term, this is the distance from that particular street address to each result. When you enter your search term along with a city or a city and state, this is the distance from the city center to the business you're looking for.
Url	The URL to the detailed page for a business.
ClickUrl	The URL for linking to the detailed page for a business. See URL linking for more information.
MapUrl	The URL of a map for the address.
BusinessUrl	The URL of the businesses website, if known.
BusinessClickUrl	The URL for linking to the businesses website if known. See URL linking for more information.

Sample response

The following is a sample response for the query pizza in zip code 94306:

<?xml version="1.0" encoding="UTF-8"?>
<ResultSet xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="urn:yahoo:lcl" xsi:schemaLocation="urn:yahoo:lcl http://local.yahooapis.com/LocalSearchService/V1/LocalSearchResponse.xsd" totalResultsAvailable="40" totalResultsReturned="2" firstResultPosition="1">
  <ResultSetMapUrl>http://local.yahoo.com/mapview?stx=pizza&csz=Palo+Alto%2C+CA&city=Palo+Alto&state=CA&radius=2.5257046222687&ed=BVD56a131DxIV6V7_5O_wO8KQY1.bxtOAd8qew--</ResultSetMapUrl>
  <Result>
    <Title>Round Table Pizza Palo Alto</Title>
    <Address>3407 Alma St</Address>
    <City>Palo Alto</City>
    <State>CA</State>
    <Phone>(650) 494-2928</Phone>
    <Rating></Rating>
    <Distance>0.28</Distance>
    <Url>http://local.yahoo.com/details?id=21395990&state=CA&stx=pizza&csz=Palo+Alto+CA&ed=o9pJ_q160Sy74qzFN72I0cSInA8HkgnO3mChobdW6IFvjLcw9Npqo0NC0IKIFIrT</Url>
    <ClickUrl>http://local.yahoo.com/details?id=21395990&state=CA&stx=pizza&csz=Palo+Alto+CA&ed=o9pJ_q160Sy74qzFN72I0cSInA8HkgnO3mChobdW6IFvjLcw9Npqo0NC0IKIFIrT</ClickUrl>
    <MapUrl>http://maps.yahoo.com/maps_result?name=Round+Table+Pizza+Palo+Alto&desc=6504942928&csz=Palo+Alto+CA&qty=9&cs=9&ed=o9pJ_q160Sy74qzFN72I0cSInA8HkgnO3mChobdW6IFvjLcw9Npqo0NC0IKIFIrT</MapUrl>
    <BusinessUrl>http://www.roundtablepizza.com/</BusinessUrl>
    <BusinessClickUrl>http://www.roundtablepizza.com/</BusinessClickUrl>
  </Result>
  <Result>
    <Title>Pizza Chicago</Title>
    <Address>4115 El Camino Real</Address>
    <City>Palo Alto</City>
    <State>CA</State>
    <Phone>(650) 424-9400</Phone>
    <Rating>5</Rating>
    <Distance>0.32</Distance>
    <Url>http://local.yahoo.com/details?id=21398996&state=CA&stx=pizza&csz=Palo+Alto+CA&ed=0nwP1q160SxzRsMU9iFZd3ThSoGjC1q2fILvS.UrBC4c39UJCdp_fpisxGrQu8gUAo3GZEZ77g--</Url>
    <ClickUrl>http://local.yahoo.com/details?id=21398996&state=CA&stx=pizza&csz=Palo+Alto+CA&ed=0nwP1q160SxzRsMU9iFZd3ThSoGjC1q2fILvS.UrBC4c39UJCdp_fpisxGrQu8gUAo3GZEZ77g--</ClickUrl>
    <MapUrl>http://maps.yahoo.com/maps_result?name=Pizza+Chicago&desc=6504249400&csz=Palo+Alto+CA&qty=9&cs=9&ed=0nwP1q160SxzRsMU9iFZd3ThSoGjC1q2fILvS.UrBC4c39UJCdp_fpisxGrQu8gUAo3GZEZ77g--</MapUrl>
    <BusinessUrl>http://www.pizzachicago.com/pa/</BusinessUrl>
    <BusinessClickUrl>http://www.pizzachicago.com/pa/</BusinessClickUrl>
  </Result>
</ResultSet>

Rate Limit

The Local Search service is limited to 5,000 queries per IP address per day. See information on rate limiting.

Errors

The Local Search service returns the standard errors. There are no service-specific errors.