Skip to main content
POST
/
v1
/
agent
/
lookup
Agent Lookup
curl --request POST \
  --url https://api.example.com/v1/agent/lookup \
  --header 'Content-Type: application/json' \
  --data '
{
  "e": "<string>"
}
'
{
  "n": "Satya Nadella",
  "e": "satya@microsoft.com",
  "co": "Microsoft",
  "role": "CEO",
  "ind": "Technology",
  "loc": "Redmond, US",
  "s": {
    "li": "https://linkedin.com/in/satyanadella"
  }
}

​
Authentication

Requires a Bearer token in the Authorization header. 
Authorization: Bearer YOUR_API_KEY

​
Request

​
e
string
required
The email address to look up.
​
fields
string
Comma-separated list of fields to return. Omit to return all fields.Available fields: n, e, co, role, ind, loc, bio, age, g, edu, pic, s, news, pub

​
Field reference

KeyDescription
nFull name
eEmail
coCompany
roleJob role
indIndustry
locLocation (city, country)
bioBiography
ageAge
gGender
eduEducation (level + university + field)
picPhoto URL
sSocial links (li, tw, ig, fb, gh)
newsNews mentions (t, u, d, s)
pubPublications (t, u, y, c)

​
Example request

curl -X POST "https://encrata.com/v1/agent/lookup?fields=n,co,role,s" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"e": "satya@microsoft.com"}'

​
Response

​
n
string
Full name (first + middle + last).
​
e
string
Email address.
​
co
string
Company name.
​
role
string
Job role / title.
​
ind
string
Industry.
​
loc
string
Location as “city, country”.
​
bio
string
Short biography.
​
age
string
Age.
​
g
string
Gender.
​
edu
string
Education summary (level, university, field).
​
pic
string
Profile photo URL.
​
s
object
Social media links.
​
news
array
News mentions.
​
pub
array
Academic publications.

​
Example response

{
  "n": "Satya Nadella",
  "co": "Microsoft",
  "role": "CEO",
  "s": {
    "li": "https://linkedin.com/in/satyanadella"
  }
}

{
  "n": "Satya Nadella",
  "e": "satya@microsoft.com",
  "co": "Microsoft",
  "role": "CEO",
  "ind": "Technology",
  "loc": "Redmond, US",
  "s": {
    "li": "https://linkedin.com/in/satyanadella"
  }
}