Yahoo News Search

The News Search service allows you to search the Internet for news stories.

Resources

/newsSearch?query&type&results&start&sort&language&site&output&callback

Sample Request Url: http://api.search.yahoo.com/NewsSearchService/V1/newsSearch?appid=YahooDemo&query=madonna&results=2&language=en

Methods

GET

request query parameters
parameter value description

appid

string (required)

The application ID. See Application IDs for more information.

query

string (required)

The query to search for.

type

string

One of:

  • all
  • any
  • phrase

The kind of search to submit.

all

returns results with all query terms

any

returns results with one or more of the query terms

phrase

returns results containing the query terms as a phrase

results

int

The number of results to return.

start

int

The starting result position to return (1-based). The finishing position (start + results - 1) cannot exceed 1000.

sort

string

Sort articles by relevance or most-recent.

language

string

The language the results are written in. Supported Languages. Omitting language returns results in any language.

site

string

A domain to restrict your searches to (e.g. www.yahoo.com). You may submit up to 30 values (e.g., site=www.yahoo.com&site=www.cnn.com).

output

string

One of:

  • json
  • php

The format for the output.

json

Results will be returned in JSON format.

php

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.

available response representations:

potential faults:

Representations

News Search Result Set (application/xml - yn:ResultSet)

XML Schema

Source: http://api.search.yahoo.com/NewsSearchService/V1/NewsSearchResponse.xsd

<xs:element name="ResultSet">
		<xs:complexType>
			<xs:sequence>
				<xs:element name="Result" type="ResultType" minOccurs="0" maxOccurs="50"/>
			</xs:sequence>
			<xs:attribute name="totalResultsAvailable" type="xs:integer"/>
			<xs:attribute name="totalResultsReturned" type="xs:integer"/>
			<xs:attribute name="firstResultPosition" type="xs:integer"/>
		</xs:complexType>
	</xs:element>
plain parameters
parameter value 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.

Title

The title of the article.

Summary

Summary text associated with the article.

Url

The URL for the article.

ClickUrl

The URL for linking to the article. See URL linking for more information.

NewsSource

The company that distributed the news article, such as API or BBC.

NewsSourceUrl

The URL for the news source.

Language

The language the article is written in.

PublishDate

The date the article was first published, in unix timestamp format.

ModificationDate

The date the article was last modified, in unix timestamp format.

Thumbnail

The URL of a thumbnail file associated with the article, if present, and its height and width in pixels.

Faults

Status Code 400 - application/xml

See the Standard Error documentation.