Frequently Asked Questions (FAQ)

General Questions

What is a WhitePages PRO API Test Account?
How does WhitePages PRO API work?
What functionality comes with a WhitePages PRO API Test Account?
What are the conditions of using a WhitePagesPRO API Test Account?
How do I get access to the WhitePages PRO API?
Can I create more than one WhitePages PRO API Test Accounts to get multiple license keys?
Can I develop commercial applications using the WhitePages PRO API Test Account?
Where do I go if I have questions, feedback, or comments about using the WhitePages PRO API?
Why am I not receiving emails sent by WhitePages?
Is the data available through a WhitePages PRO API Test Account the same as the data on www.whitepages.com?
Do you have listings outside the US, such as Canada?

Pricing Questions

Does it cost anything to use a WhitePages PRO API Test Account?
What if I want to pay WhitePages for the ability to issue more than 100 queries per day?
Does WhitePages have any plans to sell WhitePages PRO API Test Accounts as a service?

Technical Questions

How is the WhitePages PRO API implemented?
Why do I need an API key?
What happens if I go over my limit of 100 queries?
Is there a limit on the number of results I can receive per query?
How can I track the number of queries I have submitted each day?
Can I submit source code to WhitePages so it can be included in the documentation?
What programming languages do you support?
Can I see some example REST messages?
Can I use the source code distributed in the WhitePages PRO API documentation?
Does WhitePages provide technical support for WhitePages PRO API Test Accounts?
The answer to my question isn't here, where else should I look?

Answers to General Questions

What is a WhitePages PRO API Test Account?
A WhitePages PRO API Test Account gives developers and software engineers the ability to quickly test the implementation and integration of WhitePages PRO data into internal systems, and gives limited access to WhitePages PRO data for developing person search consumer applications.

How does the WhitePages PRO API work?
Developers write software programs that connect remotely to the WhitePages PRO API. Communication is performed via HTTP GET using a RESTful interface. Responses are XML or JSON.

What functionality comes with a WhitePages PRO API Test Account?
Developers can issue search requests to the WhitePages PRO database of millions of listings, and receive results as structured data. The four available search types are: Find Person, Reverse Phone, Reverse Address, and Find Business.

What are the conditions of using the WhitePages.com API?
In order to use a WhitePages PRO API Test Account, you must read and agree to the WhitePages PRO API Test AccountTerms of Use. This document explains your rights and obligations in regards to your use of the WhitePages PRO API Test Account, as well as end-user rights and obligations in regards to the data provided by WhitePages.com. Please note that the WhitePages PRO API Test Account Terms of Use. specifically require that you incorporate certain provisions into any agreement between you and an end-user, including, but not limited to, a statement that WhitePages, Inc is a third party beneficiary of any agreement between you and an end-user.

How do I get access to a WhitePages PRO API Test Account?
Register for an account. Once completed, you will receive email instructions on applying for an API key. You must respond to the email in order to confirm the creation of your account. Please be sure to check any spam or junk mail folder or rules to be sure you see this email message. Then, after your account is created and confirmed, you must request an API key.

Can I create more than one WhitePages PRO API Test Accounts to get multiple license keys?
The WhitePages PRO  API Test Accounts Terms of Use restrict you to one account.

Can I develop commercial applications using a WhitePages PRO API Test Account?
Yes, you can use a PRO API Test Account for developing the application. Once the application is ready to be release into production, you must purchase an API subscription in order to have continued access to WhitePages PRO Data.

Where do I go if I have questions, feedback, or comments about using a WhitePages PRO API Test Account?
If you have questions, the best place to start is to review the posted documentation. If you need additional help, or have feedback/comments that you want to share, please post to the developer forum.

Why am I not receiving emails sent by WhitePages?
It’s possible that the emails are being filtered by your security rules. Please add whitepages.com to the safe list of your email program.

Is the data available through a WhitePages PRO API Test Account the same as the data on www.whitepages.com?
The data available through the WhitePages PRO API Test Account is a slightly expanded data set than what is available on www.whitepages.com.  However, we do not offer the full WhitePages PRO data set through the test accounts. For full access to our PRO data set you will need to purchase a PRO subscription.  

Do you have listings outside the US, such as Canada?
Due to data restrictions, only US data is available through the WhitePages PRO API Test Account. Full access to WhitePages PRO data including Canadaian and mobile data is available with a WhitePages PRO API subscription.

Answers to Pricing Questions

Does it cost anything to use a  WhitePages PRO API Test Account?
No. Developers can access WhitePages PRO  API Test Accounts at no cost for a limited duration, with throttle limits and total query restrictions. Use is limited to 100 queries per day per API key, and can only be used to test data implementation and integration, or to develop consumer applications.

What if I want to pay WhitePages for the ability to issue more than 100 queries per day?
We are happy to offer you one of our API plans based on your needs. If you are reaching your limit and need more capacity, please email API@whitepages.com.

Does WhitePages have any plans to sell  WhitePages PRO API Test Accounts as a service?
We plan to continue this service at no cost with its current time, data, and speed limitations. We may at some time add a for pay service in addition to this one..

Answers to Technical Questions

How is the WhitePages PRO API implemented?
The WhitePages PRO API (WPAPI) is a RESTful interface which uses an Apache web server to receive queries over HTTP, process and validate them, interface with the back-end WhitePages.com search and content systems and deliver search results back to the caller.

Why do I need an API key?
The API key uniquely identifies you to WhitePages. We use it to provide your daily limit of 100 queries.

What happens if I go over my limit of 100 queries?
If you submit more than 100 queries in a day, our server will respond with a message stating that you exceeded your daily query total. If you are reaching your limit and need more you can purchase a PRO API subscription.

Is there a limit on the number of results I can receive per query?
Yes. Based on query type, there are different limits:

  • Reverse Phone: 5 results per query
  • Reverse Address: 10 results per query
  • Find Person: 20 results per query

How can I track the number of queries I have submitted each day?
Developers need to perform their own tracking of their daily usage.

Can I submit source code to WhitePages so it can be included in the documentation?
If you have written code that you wish to share with the WhitePages developer community, let people know by posting information to the developer forum. We may ask you if we can include your application and/or its code in our documentation, with appropriate attribution.

What programming languages do you support?
The service has been tested with Java, JavaScript, Perl, Ruby, Python and C++ applications. The service has not been tested with clients in other languages but it should work with any language with web services support.

Can I see some example REST messages?
Check out the examples in the documentation.

Can I use the source code distributed in the WhitePages PRO API documentation?
The code samples in the documentation may be used freely, subject to the terms of the WhitePages PRO API Test Account Terms of Use.

Does WhitePages provide technical support for WhitePages PRO API Test Accounts?
WhitePages monitors the developer forum and responds to questions which aren’t resolved by the developer community.

The answer to my question isn't here, where else should I look?
Three places to look for answers are:

Copyright © 2013 WhitePages.com. All rights reserved.