Site Explorer PageData API

Yahoo! Site Explorer has moved to Bing Webmaster Tools.

Discover what is in the Yahoo! Index

The Page Data service allows you to retrieve information about the subpages in a domain or beneath a path that exist within the Yahoo! index. See also the Site Explorer InLinkData API and more information on Site Explorer.

Request URL

http://search.yahooapis.com/SiteExplorerService/V1/pageData

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 domain or path to get subpage data for.
results	integer: default 50, max 100	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.
domain_only	no value (default), or 1	Specifies whether to provide results for all subdomains (such as http://search.yahoo.com for http://www.yahoo.com) of the domain query, or just the specifically requested domain. If the query is not a domain URL (i.e. it contains path information, such as http://smallbusiness.yahoo.com/webhosting/), this parameter has no effect.
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/SiteExplorerService/V1/pageData?appid=YahooDemo&query=http://search.yahoo.com&results=2

Response fields

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

Field	Description
ResultSet	Contains all of the query responses. Has attributes: totalResultsAvailable: The number of URLs in the database that are part of the domain. totalResultsReturned: The number of URLs 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 set of URLs.
Result	Contains each individual response.
Title	The title of the web page.
Url	The URL for the web page.
ClickUrl	The URL for linking to the page. See URL linking for more information.

Sample response

The following is a sample response for the query http://search.yahoo.com:

<ResultSet xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="urn:yahoo:srch" xsi:schemaLocation="urn:yahoo:srch http://search.yahooapis.com/SiteExplorerService/V1/PageDataResponse.xsd" totalResultsAvailable="467580" firstResultPosition="1" totalResultsReturned="2"> <Result> <Title>Yahoo! Search - Web Search</Title> <Url>http://search.yahoo.com/</Url> <ClickUrl>http://rds.yahoo.com/SIG=11io97tc1/EXP=1128100158/**http%3A%2F%2Fsearch.yahoo.com%2F> </Result> <Result> <Title>Yahoo! Search - Video Search</Title> <Url>http://video.search.yahoo.com/</Url> <ClickUrl>http://rds.yahoo.com/SIG=11o3de24f/EXP=1128100158/**http%3A%2F%2Fvideo.search.yahoo.com%2F</ClickUrl> </Result> </ResultSet>

Rate Limits

The Site Explorer APIs are limited to 5,000 queries per IP address per day and to noncommercial use. See information on rate limiting.

Terms of Use

Please see our Usage Policy to learn about acceptable uses and how to request additional queries.

Errors

The Site Explorer service returns the standard errors. There are no service-specific errors.

Support & Community

The Site Explorer APIs are discussed on the yws-search-general mailing list.