WhoKnows API

Enrich your profiles and search over 300M professionals

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!

Start typing and press Enter to search