Yahoo Contacts API

Contacts are relationships that exist in your Yahoo address book, such as those entered from across the Yahoo Network like Yahoo Mail and Yahoo Messenger. The API enables your application to leverage those relationships by reading a user's Contacts information safely and securely, respecting that user's privacy and permission settings.

Accessing the Data

Using the data in your application

In order to access Contacts data in your application, you’ll need to get a Yahoo API key and configure it to use Contacts. You can do this by creating a project for your application.

Create a Project

TLS/SSL Connections Required for Calls to the Yahoo Contacts API

To safeguard user data and authenticate API calls, we are limiting all access to the Yahoo Contacts API to secure SSL connections only. No user data will be accessible over HTTP from this date onwards. Thus, your applications must use SSL connections when making requests to or to access Yahoo contacts/profile data.

Rate Limits

Use of the Contacts developer service should not exceed reasonable request volume. Access through YQL is limited to 20,000 signed calls per hour and 2,000 unsigned calls per hour, as defined in the YQL Terms of Use.

Request higher rate limits

If you believe your application will exceed the rate limit, please contact us to request a higher rate limit for your application.


By using the Contacts developer service, you agree to the Terms of Use.


Previous versions of the Contacts API utilized a Web Service as a way to access user's Contacts data. Documentation for the previous Contacts web service remain available, including a screencast explaining its use and the PHP and Flash SDKs.


Learn how to use the Contacts API through descriptions of its queries and parameters. In addition, the documentation also inculdes sample code to help get you started.



Join the conversation on the Contacts developer forum to get help and touch base with other developers.