The Related Suggestion service provides suggestions for queries related to the submitted query. See also the other Web Search services.
The Related Suggestion service is discussed on the yws-search-general mailing list.
http://search.yahooapis.com/WebSearchService/V1/relatedSuggestion
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 get related searches from (UTF-8 encoded). |
| results | integer: default 10, max 50 | The number of results to return. |
| 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/WebSearchService/V1/relatedSuggestion?appid=YahooDemo&query=Madonna
The schema document for this service response is located at http://search.yahooapis.com/WebSearchService/V1/WebSearchRelatedResponse.xsd
| Field | Description |
|---|---|
| ResultSet | Contains all of the suggestions. |
| Result | The text of the suggested related search. |
The following is a sample response for the query Madonna:
The Related Suggestion 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.
The Related Suggestion service returns the standard errors. There are no service-specific errors.
Copyright © 2008 Yahoo! Inc. All rights reserved.
Privacy Policy - Terms of Service - Copyright Policy - Job Openings