Skip to content

People

Look up people and their records. Use the search endpoints to find people by role, employer, location, or skills, and the detail-lookup endpoints to fetch a full person record by ID, email, or phone number. Contact data has its own sections: Phones, Personal Emails, and Work Emails.

Operations

Person detail lookup

Request

Do Person details lookup.

Security
Api-Key
Path
account_idintegerrequired
Body
person_idinteger
linkedin_public_identifierstring

LinkedIn organization "Public identifier/Slug/ID" - "linkedin.com/in/!slug!/".

curl -i -X POST \
  'https://api-v2.forager.ai/api/{account_id}/datastorage/person_detail_lookup/' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "person_id": 0,
    "linkedin_public_identifier": "string"
  }'

Responses

Bodyapplication/json
idintegerread-onlyrequired
full_namestring, <= 255 charactersrequired
first_namestring, <= 255 charactersrequired
last_namestring or null, <= 255 characters
photostring or null, (uri), <= 255 characters
genderstring or null, <= 255 characters
headlinestring or null, <= 255 characters
descriptionstring or null
skillsArray of objects(PersonSkill)read-onlyrequired
locationobject(InnerLocation)read-onlyrequired

Serializer for the InnerLocation model.

linkedin_infoobject(PersonLinkedinInfo)read-onlyrequired

Serializer for the PersonLinkedinInfo model.

rolesArray of objects(PersonRoleChild)required
educationsArray of objects(PersonEducation)required
certificationsArray of objects(PersonCertification)read-onlyrequired
coursesArray of objects(PersonCourse)read-onlyrequired
honorsArray of objects(PersonHonor)read-onlyrequired
languagesArray of objects(PersonLanguage)read-onlyrequired
organizationsArray of objects(PersonOrganization)read-onlyrequired
patentsArray of objects(PersonPatent)read-onlyrequired
publicationsArray of objects(PersonPublication)read-onlyrequired
test_scoresArray of objects(PersonTestScore)read-onlyrequired
projectsArray of objects(PersonProject)read-onlyrequired
volunteeringArray of objects(PersonVolunteering)read-onlyrequired
Response
{
  "id": 0,
  "full_name": "string",
  "first_name": "string",
  "last_name": "string",
  "photo": "http://example.com",
  "gender": "string",
  "headline": "string",
  "description": "string",
  "skills": [
    { … }
  ],
  "location": {
    "id": 0,
    "name": "string",
    "osm_locations": [ … ]
  },
  "linkedin_info": {
    "public_identifier": "string",
    "industry": { … },
    "public_profile_url": "string"
  },
  "roles": [
    { … }
  ],
  "educations": [
    { … }
  ],
  "certifications": [
    { … }
  ],
  "courses": [
    { … }
  ],
  "honors": [
    { … }
  ],
  "languages": [
    { … }
  ],
  "organizations": [
    { … }
  ],
  "patents": [
    { … }
  ],
  "publications": [
    { … }
  ],
  "test_scores": [
    { … }
  ],
  "projects": [
    { … }
  ],
  "volunteering": [
    { … }
  ]
}