How do I get started?

1. Online Documentation

   Read the online documentation and FAQs.

2. Get an Application ID

   To access Yahoo! Search Webservices, you will need to get an application ID. Like a browser's User-Agent string, the Application ID uniquely identifies your application and has no effect on rate limiting.

3. Download the SDK

   The development kit includes BSD licensed examples and libraries for various languages: Perl, Python and PHP, Java, JavaScript, and Flash.

What Search Web Services does Yahoo! offer?

You can write applications with Yahoo! Search Web Services using data from:

What else can I do with Yahoo! Search?

In addition to the web services above, Yahoo! provides developers with access to other kinds of data and nifty tools.

• Autos Custom - The folks from Yahoo! Autos Custom have released documentation to allow developers to build their own directories of automobile customizers, enabling you to build your own takes on the Yahoo! Autos Custom Installer Directory.
• RSS Feeds - Check out our comprehensive list of RSS feeds as an easy and effective way to integrate data feeds into your applications

What else do I need to know?

Yahoo! Search Web Services operate via HTTP requests just like your web browser. Requests are formed by starting with a service entrypoint URL (such as http://search.yahooapis.com/WebSearchService/V1/webSearchfor web search queries) and adding query arguments to specify the search results desired (such as ?query=Madonna). The results returned by the service are in XML which varies per service. Your programs can use these services by submitting a request, fetching the response, and parsing the returned XML to extract the information you need. Alternately, you may use the provided SDK APIs to handle the protocol specifics for you. Each service accepts a different set of query arguments and produces differently structured XML responses. See the service documentation for the specifics on each.

Yahoo! imposes two technical requirements on usage of these services. First, we require that each application that uses these APIs use an Application ID. This Application ID must be sent with each request in the 'appid' parameter. Second, we limit the frequency by which any computer may access these services. These rate limits are imposed independently for each service and are typically in the thousands-per-day per user range. See each service's documentation for the individual limits.

See our Usage Policy page for more guidance in using Yahoo! Web Services, including information about acceptable uses, attribution requirements, and how to request additional queries.

The following information applies to all of our Search Web Services:

• Constructing Requests
• Understanding Rate Limiting
• Service Versioning
• Frequently Asked Questions
• Error Messages

Can I see how many people are using my application?

You can use our usage tracking page to see how many hits each of your application IDs is generating.