WhoKnows API

Enrich your profiles and search over 370M professionals

VIEW API DOCS

Machine-enriched, up-to-date profiles

  • Skills – Identify who’s working on what for micro-targeted segmentation
  • Work history – Industry, companies, company size, time at position, etc
  • Education – Degrees, schools, majors, etc
  • Diversity – Promote diversity programs by gender or ethnicity

curl -X POST \
  https://whoknows.com/api/v1/search \
  -H 'x-api-key: (your API key here)' \
  -d '{
    "filters": {
        "required": [
            {"field": "location", "value": ["boston", "san francisco"], "truth": True},
            {"field": "name", "value": ["bob", "smith"]},
            {"field": "skill", "value": [{"tag": "Python", "level": "expert"}, {"tag": "python"}]},
            {"field": "experience", "value": [{"company": "apple"}]},
            {"field": "experience", "value": [{"company": "google"}]}
            {"field": "query", "value": "search string"}
            {"field": "group", "value": [""]}
            {"field": "group", "value": ["intel"], "truth": False}
            {"field": "connection", "value": [{"alias": "email:barry@whoknows.com", "degree": "1st"}], "truth'\'': False}
        ],
        desired: [
            {"field": "skill", "value": [{"tag": "Java", "level": "knowledge"}], "truth": False}
        ]
    }
}'



{
"query-in": {
"user_id": "5150d46c7cc213195577c2ab",
“filters”: {
required: [
{"field": "location", "value": ["boston", "san fran"], "truth": True},
{"field": "name", "value": ["bob", "smith"]},
{"field": "skill", "value": [{"tag": "Python", "level": "expert"}, {"tag": "python"}]},
{"field": "experience", "value": [{"company": "apple"}]},
{"field": "experience", "value": [{"company": "google"}]}
{"field": "query", "value": "search string"}
{"field": "group", "value": [""]}
{"field": "group", "value": ["intel"], "truth": False}
{"field": "connection", "value": [{"alias": "email:barry@whoknows.com", "degree": "1st"}], "truth': False}
],
desired: [
{"field": "skill", "value": [{"tag": "Java", "level": "knowledge"}], "truth": False}
]
}
},
"message": "ok",
"results": {
"user_id": "5150d46c7cc213195577c2ab",
"total_results": 285,
"results": [
{
"profile_id": "wp:9kWRDUU75Byt2zCQtoMMXH6t29XiSAyEhonQkvaoVEzh",
"first_name": "Chris",
"last_name": "Macomber",
"company": "WhoKnows Inc.",
"title": "CEO",
"business_function": "Executive",
"seniority_level": "CXO",
"industry": "Internet",
"picture_url": "https://whoknows.com/app/profile_picture?user=512cce8c7cc2133a2be3543d&v=599b4d16ed2b6e09e7901ec8",
"city": "San Mateo",
"state": "California",
"country": "United States of America",
"current_experience": [
{
"company_name": "WhoKnows Inc.",
"title": "CEO",
"business_function": "Executive",
"seniority_level": "CXO",
"department": null,
"group_id": "whoknows",
"company_size": "F",
"start": "2013-04-01",
"end": null,
"duration": 42
}
],
"experience": [
{
"company_name": "Lytro Inc.",
"title": "Director of Product Management",
"business_function": "Product Management",
"seniority_level": "Director",
"department": null,
"group_id": "lytro",
"company_size": "D",
"start": "2011-03-01","end": "2013-03-01",
"duration": 24
},
{
"company_name": "Reputation.com",
"title": "Principal Product Manager",
"business_function": "Product Management",
"seniority_level": "Manager",
"department": null,
"group_id": "reputation",
"company_size": "E",
"start": "2009-11-01",
"end": "2011-03-01",
"duration": 17
}
],
"education_history": [
{
"school": "Massachusetts Institute of Technology - Sloan School of Management",
"degree": "MBA",
"major": " Product Management",
"degree_level": "Masters",
"start": "2005-01-01",
"end": "2007-01-01"
},
{
"school": "Stanford University",
"degree": "Bachelor's degree",
"major": " Computer Science",
"degree_level": "Bachelors",
"start": "1993-01-01",
"end": "1997-01-01"
}
],
"diversity": {
"gender": {
"male": 0.8620857905294291,
"female": 0.13791420947057087
},
"ethnic": {
"multiple": 1.88,
"hispanic": 1.75,
"black": 0.32,
"asian": 1.11,
"white": 94.64,
"native": 0.3
}
},
"total_experience": 249,
"time_at_current_company": 54,
"time_at_current_position": 42,
"skills": [
{
"tag": "Product marketing",
"level": "skilled"
},
{
"tag": "Product management",
"level": "expert"
},
{
"tag": "Software as a service",
"level": "expert"
},
{
"tag": "Web analytics",
"level": "novice"
},
]
}
]
}
}

Search over 300M professionals

  • Access over 300M machine-enriched, up-to-date profiles
  • Search by over 20 filters including name, company size, industry, education, etc.
  • Get validated contact info including email, phone, and social links

Enrich your own profiles

  • Match profiles by email, phone number, LinkedIn profile, etc
  • Benefit from full WhoKnows profiles and contact info
  • Only credit matches found
curl -X GET \
'https://whoknows.com/api/v1/enrich?email=chris%40whoknows.com' \
-H 'x-apikey: (your API key here)'



{
"profile_id": "wp:9kWRDUU75Byt2zCQtoMMXH6t29XiSAyEhonQkvaoVEzh",
"linkedin": "www.linkedin.com/in/cmacomber",
"first_name": "Chris",
"last_name": "Macomber",
"company": "WhoKnows Inc.",
"title": "CEO",
"business_function": "Executive",
"seniority_level": "CXO",
"industry": "Internet",
"picture_url": "https://whoknows.com/app/profile_picture?user=512cce8c7cc2133a2be3543d&v=599b4d16ed2b6e09e7901ec8",
"city": "San Mateo",
"state": "California",
"country": "United States of America",
"email" : [
"chris@whoknows.com",
"cxxxxxxxxxxxxx@gmail.com"
],
"phone" : [
"415-XXX-XXXX"
],
"social_links": [
{
"url": "https://linkedin.com/in/cmacomber",
"typeName": "LinkedIn"
},
{
"url": "https://angel.co/chris-macomber",
"typeName": "AngelList"
}
],
"current_experience": [
{
"company_name": "WhoKnows Inc.",
"title": "CEO",
"business_function": "Executive",
"seniority_level": "CXO",
"department": null,
"group_id": "whoknows",
"company_size": "F",
"start": "1367193600",
"end": null,
"duration": 42
}
],
"experience": [
{
"company_name": "Lytro Inc.",
"title": "Director of Product Management",
"business_function": "Product Management",
"seniority_level": "Director",
"department": null,
"group_id": "lytro",
"company_size": "D",
"start": 1301356800,
"end": 1364515200,
"duration": 25
},
{
"company_name": "Reputation.com",
"title": "Principal Product Manager",
"business_function": "Product Management",
"seniority_level": "Manager",
"department": null,
"group_id": "reputation",
"company_size": "E",
"start": 1259452800,
"end": 1301356800,
"duration": 17
}
],
"education_history": [
{
"school": "Massachusetts Institute of Technology - Sloan School of Management",
"degree": "MBA",
"major": " Product Management",
"degree_level": "Masters",
"start": 1127952000,
"end": 1191024000
},
{
"school": "Stanford University",
"degree": "Bachelor's degree",
"major": " Computer Science",
"degree_level": "Bachelors",
"start": 749260800,
"end": 875491200
}
],
"diversity": {
"gender": {
"male": 0.8620,
"female": 0.1379
},
"ethnic": {
"multiple": 0.0188,
"hispanic": 0.0175,
"black": 0.0032,
"asian": 0.0111,
"white": 0.9464,
"native": 0.003
}
},
"total_experience": 249,
"time_at_current_company": 54,
"time_at_current_position": 42,
"skills": [
{
"tag": "Product marketing",
"level": "skilled"
},
{
"tag": "Product management",
"level": "expert"
},
{
"tag": "Software as a service",
"level": "expert"
},
{
"tag": "Web analytics",
"level": "novice"
},
]
}

Embeddable UI widgets for your app

  • Use our profile widgets to easily embed our profiles directly into your app
  • Mix and match all of our profile panels: skill graph, relationships, work history, education, etc.

Super-charge your CRM, ATS, or app!

REQUEST API KEY

Start typing and press Enter to search