My Web Documentation for Yahoo! Search Web Services

Support & Community

The My Web 2.0 Tag Search service is discussed on the yws-search-general mailing list.

Request URL

http://search.yahooapis.com/MyWebService/V1/tagSearch

Request Parameters

See information on constructing REST queries

Parameter	Value	Description
appid	string (required)	The application ID. See Application IDs for more information.
url	string	If specified, only returns tags associated with this url.
yahooid	string	A Yahoo! username. If one is specified, only tags by that user will be returned.
sort	popularity (default), tag, or date	The field by which the results should be sorted.
reverse_sort	0 (default) or 1	If set to 1, reverses the sort order. This will not have any effect on a popularity sort.
results	integer: default 10, max 50	The number of results to return.
start	integer: default 1	The starting result position to return (1-based). The finishing position (start + results - 1) cannot exceed 1000.
output	string: xml (default), json, php	The format for the output. If json is requested, the results will be returned in JSON format. If php is requested, the results will be returned in Serialized PHP format.
callback	string	The name of the callback function to wrap around the JSON data. The following characters are allowed: A-Z a-z 0-9 . [] and _. If output=json has not been requested, this parameter has no effect. More information on the callback can be found in the Yahoo! Developer Network JSON Documentation.

Sample Request Url: http://search.yahooapis.com/MyWebService/V1/tagSearch?appid=YahooDemo&yahooid=ysearchmyweb2&results=2

Response Fields

The schema document for this service response is located at http://search.yahooapis.com/MyWebService/V1/TagSearchResponse.xsd

Field	Description
ResultSet	Contains all of the query responses. Has attributes: 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.
Result	Contains each individual response.
Tag	The value of the tag.
Frequency	The number of times the tag has been used publicly. If the query is filtered by yahooid (and/or URL), it will return the number of times the tag has been used by that user (and/or on that URL).
Date	The last time this tag was used, as filtered by the user and the url.

Sample Response

The following is a sample response for tags submitted by the user ysearchmyweb2:

<ResultSet xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="urn:yahoo:myweb" xsi:schemaLocation="urn:yahoo:myweb http://search.yahooapis.com/MyWebService/V1/TagSearchResponse.xsd" totalResultsAvailable="4" totalResultsReturned="2" firstResultPosition="1">
	<Result>
		<Tag>yahoo</Tag>
		<Frequency>3</Frequency>
		<Date>1119906005</Date>
	</Result>
	<Result>
		<Tag>yahoo search</Tag>
		<Frequency>2</Frequency>
		<Date>1119906005</Date>
	</Result>
</ResultSet>

Rate Limit

The Tag Search service is limited to 5,000 queries per IP address per day. See information on rate limiting and our Usage Policy to learn about acceptable uses and how to request additional queries.

Errors

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