Person Search

Cost: 5 credit/search.

Search for people by industry, management level, company size, and job title.

POST/api/v1/search/person

Person Search Endpoint

This endpoint allows you to search for people by industry, management level, company size, and job title.

Optional Attributes

  • Name
    company_industries
    Type
    list
    Description

    List of industries. It can be any value from the list of industries.

  • Name
    management_levels
    Type
    list
    Description

    List of management levels. It can be any value from the list of management levels.

  • Name
    company_sizes
    Type
    list
    Description

    List of company sizes. It can be any value from the list of company sizes.

  • Name
    job_titles
    Type
    list
    Description

    List of relevant job titles.

  • Name
    page_size
    Type
    int
    Description

    Number of results per page. Default is 10.

  • Name
    cursor
    Type
    string
    Description

    Cursor to fetch the next page.

Request

POST
/v1/search/person

curl --location 'https://api.datamagnet.co/api/v1/search/person' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {token}' \
--data '{
"company_industries": [],
"management_levels": [],
"company_sizes": ["1-10"],
"job_titles": []
}'

Response


{
{
"company_linkedin_url": "http://www.linkedin.com/company/4tecture",
"company_name": "4tecture GmbH",
"company_primary_domain": "4tecture.ch",
"first_name": "Marc",
"last_name": "Mueller",
"linkedin_url": "http://www.linkedin.com/in/marcromanmueller",
"name": "Marc Mueller",
"title": "Managing Director / Principal Consultant"
},
{
"company_linkedin_url": "http://www.linkedin.com/company/aviation-gin",
"company_name": "Aviation American Gin",
"company_primary_domain": "aviationgin.com",
"first_name": "Ryan",
"last_name": "Reynolds",
"linkedin_url": "http://www.linkedin.com/in/ryan-reynolds-3353a227b",
"name": "Ryan Reynolds",
"title": "Part-Time Actor, Business Owne"
},
"cursor": "XXXXXXX"
}


The Search Model

Properties

  • Name
    company_linkedin_url
    Type
    string
    Description

    LinkedIn URL of the company.

  • Name
    company_name
    Type
    string
    Description

    Name of the company.

  • Name
    company_primary_domain
    Type
    string
    Description

    Primary domain of the company.

  • Name
    first_name
    Type
    string
    Description

    First name of the person.

  • Name
    last_name
    Type
    string
    Description

    Last name of the person.

  • Name
    linkedin_url
    Type
    string
    Description

    LinkedIn URL of the person.

  • Name
    name
    Type
    string
    Description

    Full name of the person.

  • Name
    title
    Type
    string
    Description

    Job title of the person.

  • Name
    cursor
    Type
    string
    Description

    Cursor to fetch the next page. This can be passed as payload in the API request.