Whitepages

Getting a Trial API Key

Step-by-step guide to signing up for a free Whitepages API trial

This guide walks you through the process of signing up for a free trial API key. The trial gives you access to all API endpoints so you can evaluate the service before committing to a paid plan.

Step 1: Visit the API Page

Go to whitepages.com/pro-api to access the API signup page.

API Landing Page

You'll see the "Get API Access" form on the right side of the page.

Step 2: Enter Your Contact Information

The first form requires three pieces of information:

  • Full Name - Your full name
  • Business Email Address - A valid business email address (required for trial approval)
  • Phone Number - Your phone number in the format (555) 555-5555

Signup Form

Fill in your details and click the Start for Free button.

Form Filled

Use a Business Email

Using a business email address (e.g., yourname@company.com) rather than a personal email increases your chances of trial approval and faster processing.

Step 3: Provide API Usage Details

After submitting your contact information, you'll be asked to provide more details about your API needs:

Second Form Stage

Fill out the following fields:

  • Anticipated Monthly API Calls - Select your expected usage volume
  • Do you have a technical resource for implementation? - Indicate if you have development resources
  • Who is the end user for the data? - Select who will be using the data (Internal Staff, Businesses you serve, Consumers, or Other)
  • Briefly describe how you plan to use the API - Provide a short description of your use case

Second Form Filled

Click Access API Trial to submit your request.

No Credit Card Required

The trial signup does not require a credit card. You can evaluate the API completely free during the trial period.

Step 4: Check Your Email

After submitting the form, you'll see a confirmation message:

Confirmation

Check your email for instructions on how to activate your trial key.

Step 5: Start Using Your API Key

Once you receive your API key, you can start making requests immediately. Include your key in the X-Api-Key header:

curl 'https://api.whitepages.com/v1/person?name=John%20Smith' \
  --header 'X-Api-Key: YOUR_API_KEY'

Keep Your API Key Secure

Never share your API key publicly or commit it to version control. If your key is compromised, contact support@whitepages.com immediately.

Trial Limitations

The trial API key includes:

  • Access to all API endpoints
  • Limited number of queries for evaluation purposes
  • Full response data (no field restrictions)

For production use or higher query volumes, visit the API Pricing page.

Next Steps

On this page