FREE USAGE
Rapleaf's Personlization API provides rich demographic data about email addresses in real-time.
You will need an Rapleaf API key in order to use this service. You can get one (for free) here: https://www.rapleaf.com/developers/api_access.
With an API key, you will have free, unlimited access to age, gender, and city/state/country data.
Additionally, we provide many other premium fields for a small price. Please visit our website or email us at info@rapleaf.com to get more info on pricing and our premium fields.
running
Business
10 Developers use this API
Methods
- Personalization API
Personalization API (GET)
Use the Rapleaf Personalization API to get demographic data tied to a specific email. In addition, we will have a higher match rate if you provide one or more of the following: First Name Last Name Street, City, State (all three) Zip Code (with optional 4 digit extension)
Parameters
api_key
STRING
Rapleaf API key. Get one for free here: https://www.rapleaf.com/developers/api_access
For example: "9f4b3a8250a5ab3d0ec084c293ada3de "
email
STRING
Email address of individual.
For example: "bill.gates@apple.com"
first(optional)
STRING
First name of individual. Not case sensitive.
For example: "Bill, bill"
last(optional)
STRING
Last name of individual. Not case sensitive.
For example: "Gates, gates"
zip4(optional)
STRING
Zip Code (with optional 4 digit extension) for individual's residence.
For example: "94105-0123, 28512"
state(optional)
STRING
State of individual's residence.
For example: "CA"
city(optional)
STRING
City of individual's residence.
For example: "San Francisco"
street(optional)
STRING
Street address of individual's residence.
For example: "667 Mission Street"
Results
age
STRING
Age of individual. Free data.
For example: "25-34"
children
STRING
Whether the individual has children. Requires a premium subscription -- contact info@rapleaf.com for more details
For example: "No"
gender
STRING
Gender of individual. Free data.
For example: "Male"
home_market_value
STRING
Market value of individual's residence. Requires a premium subscription -- contact info@rapleaf.com for more details
For example: "150k-200k"
home_owner_status
STRING
Whether the individual own or rents out their residence. Requires a premium subscription -- contact info@rapleaf.com for more details
For example: "Rent"
home_property_type
STRING
Type of individual's residence. Requires a premium subscription -- contact info@rapleaf.com for more details
For example: "Condo"
household_income
STRING
Aggregate household income of individual's residence. Requires a premium subscription -- contact info@rapleaf.com for more details
For example: "75k-100k"
length_of_residence
STRING
Time individual has been at current residence. Requires a premium subscription -- contact info@rapleaf.com for more details
For example: "5 Years"
location
STRING
City, state, and country of individual's current residence. Free data.
For example: "San Francisco, California, United States"
marital_status
STRING
Individual's marital status. Requires a premium subscription -- contact info@rapleaf.com for more details
For example: "Single"
Example
JSON
{
"age": "25-34",
"children": "No",
"gender": "Male",
"home_market_value": "150k-200k",
"home_owner_status": "Rent",
"home_property_type": "Condo",
"household_income": "75k-100k",
"length_of_residence": "5 Years",
"location": "San Francisco, California, United States",
"marital_status": "Single"
}
JSON (Learn how)
GET https://uMPQSW9yFj7s7QJutqWSaaTtX.proxy.mashape.com/dr?api_key=A-VALUE&email=A-VALUE&first=A-VALUE&last=A-VALUE&zip4=A-VALUE&state=A-VALUE&city=A-VALUE&street=A-VALUE
- The required parameters have a yellow background, while the optional are gray
- Authentication: Request a valid _token before making the API call. Learn how.