Usage Information and Limits

The following information describes the use, performance, dependencies, and limits of the YQL Web service. If you have additional questions, please read the YQL Terms of Service or send an email to .

Usage Information:

  • YQL can be used for commercial purposes, with Yahoo approval.
  • If you would like to use YQL commercially, please contact us at yql-commercial [@] yahoo-inc.com and we will review you request.
  • Yahoo will notify users six months in advance with an announcement on this Web page and in our forum if it intends to discontinue or make backwards incompatible changes to the YQL Web Service.
  • YQL has a performance uptime target of over 99.5%.
  • YQL relies on the correct operation of the Web services and content providers it accesses.
  • YQL rate limits are subject to the rate limits of other Yahoo and 3rd-party Web services, and all rates are subject to change.

Rate Limits:

  Public OAuth with API Key
YQL Endpoint /v1/public/* /v1/yql/*
Hourly Cap 2,000 requests/hour per IP 20,000 requests/hour per IP
Daily Cap None 100,000 total requests/day per API Key

To better understand the rate limits in the above table, let's use the following example. Suppose you create an application that generates around 3,000 requests from each user per hour. You notice though that users are capped at a maximum of 2,000 calls using the public endpoint, so you register an API Key with Yahoo to use the authenticated/authorized endpoint. Now your users can make 20,000 requests per hour and up to a total of 100,000 requests per day.

Table of Contents