Discoverly V1 Person API Documentation

After getting consistent requests, we are very excited to be finally be able to deliver Dicoverly data via our Person API. You can buy your API credits and access token here.

In general our Person API is pretty simple. It behaves like our chrome extension does in Gmail, LinkedIn, Facebook, Twitter, etc.  Below you can see example queries with social URLs and email address and what person data you can expect to return.   Everything should be pretty straight forward, but you can also find an FAQ below the example.

API Endpoint


Example API Queries:
discover.ly/papi/v1/lookup?token=12356&url=mailto:bwiley@babysteppers.org
discover.ly/papi/v1/lookup?token=12356url=https://www.linkedin.com/in/bobwiley
discover.ly/papi/v1/lookup?token=12356&url=https://www.facebook.com/bobwiley
discover.ly/papi/v1/lookup?token=12356&url=https://www.twitter.com/bobwiley


Example Response:
{“status”:”ok”,
“credits”:9927,

“result”:[{
“first_name”:”Bob”,
“last_name”:”Wiley”,
“full_name”:”Bob Wiley”},

{“foursquare_url”:”foursquare.com/user/12356789″,
“foursquare_source_id”:”12356789″},

{“twitter_url”:”twitter.com/bobwiley”,
“twitter_source_id”:”12356789″,
“twitter_username”:”bobwiley”},

{“facebook_url”:”www.facebook.com/bobwiley”,
“facebook_source_id”:null,
“facebook_username”:null,
“facebook_connected”:null,
“facebook_friends_count”:null,
“facebook_friends”:null},

{“linkedin_url”:”linkedin.com/in/bobwiley”,
“linkedin_source_id”:null,
“linkedin_username”:”bobwiley”,
“linkedin_connected”:null},

{“klout_url”:”klout.com/bobwiley”,
“klout_source_id”:”1235678912356789″,
“klout_username”:”bobwiley”},

{“angellist_url”:”angel.co/bobwiley”,
“angellist_source_id”:”108848″,
“angellist_username”:”bobwiley”},

{“current_position”:”Sailor at Lake Winnipesaukee”},

{“email_hash”:”0119350b2d8f12e435a8a90126170505c7deecf945aff5455e6eb286″}, {“email_hash”:”70e0b00dbb4530c168ef73b8960eccc36712847a5f4c505e3cf64f”},
{“email_hash”:”10bafbdd0b33ac3fc4ff36058d50fd8b73b1759da25782a1a793b”},
{“email_hash”:”16c0baea3afe789192de99b7b1217438f08126d713d7bdc45a5c”},

{“location”:”Glendale, New Hampshire”},

{“picture_url”:”fbcdn-profile-a.akamaihd.net/hprofile-ak-xap1/v/t1.0-1/p50x50/10941036_10101675676487682_7599310278901579525_n.jpg},

{“aboutme_url”:”about.me/bobwiley”},

{“googleplus_url”:”plus.google.com/12356789123567812356789″},

{“crunchbase_url”:”www.crunchbase.com/person/bob-wiley”},

{“s_z”:0.3764069839301463,
“s_limited”:false,
“s_premium”:false}]}


FAQ – Frequently Asked Questions

What are tokens and credits and how do I get them?
API acccess tokens are granted when you purchase API credits. You can purchase credits hear and you will recieve an email with you token within 24 hours. As you use the api you can see how many credits you have left with each response.

What if Discoverly as no data for a particular email address or social URL?
Somtimes we won’t know anything about particular email or URL and somtimes there will be typo is the query.  In this event, the API will have an largely empy response.  Every API call consume one credit, regardless of how much data is return on the person.

What are the email hash(s) in API response?
The API does not respond with people’s email addresses by it currently provides encrypted email hashes for every email address we have on record for a person that can be used in ad (re)targeting.

Why are some fields in the example API response with strike-through?
You can ignore these fields. They are leftover response from our internal API. We plan to clean them out eventually.

Advertisements