curl --request POST \
--url https://api.generect.com/api/v1/enrich/realtime/lead/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9"
}
'{
"data": {
"id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9",
"sales_id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9",
"linkedin_id": "78461298",
"linkedin_url": "https://www.linkedin.com/in/jordan-ellis",
"linkedin_sales_link": "https://www.linkedin.com/sales/lead/ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9,NAME_SEARCH,x7Kq",
"first_name": "Jordan",
"middle_name": "",
"last_name": "Ellis",
"full_name": "Jordan Ellis",
"unformatted_full_name": "Jordan Ellis",
"translated_first_name": null,
"headline": "CEO at Microsoft",
"summary": "Building the platforms other companies build on.",
"gender": "male",
"nationality": "American",
"industry": "Software Development",
"location": "Redmond, Washington, United States",
"location_city": "Redmond",
"location_state": "Washington",
"location_county": "King County",
"location_country": "United States",
"num_of_connections": 500,
"profile_photo": "https://media.licdn.com/dms/image/v2/C5603AQExample/profile-displayphoto-shrink_800_800/0/1",
"twitter_link": null,
"private_website": null,
"contact_info": {
"websites": [
{
"url": "https://jordanellis.example.com",
"category": "PERSONAL",
"dataSource": "LINKEDIN"
}
]
},
"is_premium": true,
"is_openlink": false,
"is_job_seeker": false,
"is_retired": false,
"is_full_data": true,
"has_current_position": true,
"job_title": "Chief Executive Officer",
"raw_job_title": "CEO",
"job_started_on": "Feb 2014",
"job_ended_on": null,
"job_location": "Redmond, Washington, United States",
"job_location_city": "Redmond",
"job_location_state": "Washington",
"job_location_county": "King County",
"job_location_country": "United States",
"company_id": "1035",
"company_name": "Microsoft",
"company_url": "https://www.linkedin.com/company/microsoft",
"company_website": "https://www.microsoft.com",
"company_industry": "Software Development",
"company_location": "Redmond, Washington, United States",
"company_description": "Every company has a mission. What's ours? To empower every person and every organization to achieve more.",
"company_image": "https://media.licdn.com/dms/image/v2/C560BAQExample/company-logo_200_200/0/1",
"jobs": [
{
"job_title": "Chief Executive Officer",
"raw_job_title": "CEO",
"job_description": null,
"job_started_on": "Feb 2014",
"job_ended_on": null,
"job_still_working": true,
"job_location": "Redmond, Washington, United States",
"job_location_city": "Redmond",
"job_location_state": "Washington",
"job_location_county": "King County",
"job_location_country": "United States",
"company_id": "1035",
"company_name": "Microsoft",
"raw_company_name": "Microsoft",
"company_url": "https://www.linkedin.com/company/microsoft",
"company_website": "https://www.microsoft.com",
"company_industry": "Software Development",
"company_headcount_range": "10001+",
"company_location": "Redmond, Washington, United States",
"company_city": "Redmond",
"company_state": "Washington",
"company_country": "United States",
"company_image": "https://media.licdn.com/dms/image/v2/C560BAQExample/company-logo_200_200/0/1",
"company_description": "Every company has a mission. What's ours? To empower every person and every organization to achieve more."
}
],
"educations": [
{
"university_id": "1792",
"university_name": "Stanford University",
"university_url": "https://www.linkedin.com/school/stanford-university",
"university_logo": "https://media.licdn.com/dms/image/v2/C4E0BAQExample/company-logo_200_200/0/1",
"university_description": null,
"degree": "Master of Science (MS)",
"fields_of_study": [
"Computer Science"
],
"started_on": {
"year": 2004
},
"ended_on": {
"year": 2006
}
}
],
"certifications": [],
"languages": [
{
"name": "English",
"proficiency": "NATIVE_OR_BILINGUAL"
}
],
"volunteering": [],
"patents": [],
"publications": [],
"skills": [
"Cloud Computing",
"Software Development",
"Leadership"
],
"source": "lead_by_link"
},
"meta": {
"amount_charged": 0.04
}
}{
"status": "error",
"status_code": 400,
"detail": {
"fields": "exactly one of id, linkedin_url, email is required"
}
}{
"status": "error",
"status_code": 401,
"detail": "Authentication credentials were not provided."
}{
"status": "error",
"status_code": 402,
"detail": "Insufficient funds in the account."
}{
"status": "error",
"status_code": 403,
"detail": "You do not have permission to perform this action."
}{
"status": "error",
"status_code": 429,
"detail": "Request was throttled."
}Leads
Enrich lead in realtime
Retrieve a fresh lead profile. Supports internal ID, LinkedIn URL, or email reverse lookup. If no data is found, the request is free.
POST
/
api
/
v1
/
enrich
/
realtime
/
lead
/
curl --request POST \
--url https://api.generect.com/api/v1/enrich/realtime/lead/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9"
}
'{
"data": {
"id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9",
"sales_id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9",
"linkedin_id": "78461298",
"linkedin_url": "https://www.linkedin.com/in/jordan-ellis",
"linkedin_sales_link": "https://www.linkedin.com/sales/lead/ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9,NAME_SEARCH,x7Kq",
"first_name": "Jordan",
"middle_name": "",
"last_name": "Ellis",
"full_name": "Jordan Ellis",
"unformatted_full_name": "Jordan Ellis",
"translated_first_name": null,
"headline": "CEO at Microsoft",
"summary": "Building the platforms other companies build on.",
"gender": "male",
"nationality": "American",
"industry": "Software Development",
"location": "Redmond, Washington, United States",
"location_city": "Redmond",
"location_state": "Washington",
"location_county": "King County",
"location_country": "United States",
"num_of_connections": 500,
"profile_photo": "https://media.licdn.com/dms/image/v2/C5603AQExample/profile-displayphoto-shrink_800_800/0/1",
"twitter_link": null,
"private_website": null,
"contact_info": {
"websites": [
{
"url": "https://jordanellis.example.com",
"category": "PERSONAL",
"dataSource": "LINKEDIN"
}
]
},
"is_premium": true,
"is_openlink": false,
"is_job_seeker": false,
"is_retired": false,
"is_full_data": true,
"has_current_position": true,
"job_title": "Chief Executive Officer",
"raw_job_title": "CEO",
"job_started_on": "Feb 2014",
"job_ended_on": null,
"job_location": "Redmond, Washington, United States",
"job_location_city": "Redmond",
"job_location_state": "Washington",
"job_location_county": "King County",
"job_location_country": "United States",
"company_id": "1035",
"company_name": "Microsoft",
"company_url": "https://www.linkedin.com/company/microsoft",
"company_website": "https://www.microsoft.com",
"company_industry": "Software Development",
"company_location": "Redmond, Washington, United States",
"company_description": "Every company has a mission. What's ours? To empower every person and every organization to achieve more.",
"company_image": "https://media.licdn.com/dms/image/v2/C560BAQExample/company-logo_200_200/0/1",
"jobs": [
{
"job_title": "Chief Executive Officer",
"raw_job_title": "CEO",
"job_description": null,
"job_started_on": "Feb 2014",
"job_ended_on": null,
"job_still_working": true,
"job_location": "Redmond, Washington, United States",
"job_location_city": "Redmond",
"job_location_state": "Washington",
"job_location_county": "King County",
"job_location_country": "United States",
"company_id": "1035",
"company_name": "Microsoft",
"raw_company_name": "Microsoft",
"company_url": "https://www.linkedin.com/company/microsoft",
"company_website": "https://www.microsoft.com",
"company_industry": "Software Development",
"company_headcount_range": "10001+",
"company_location": "Redmond, Washington, United States",
"company_city": "Redmond",
"company_state": "Washington",
"company_country": "United States",
"company_image": "https://media.licdn.com/dms/image/v2/C560BAQExample/company-logo_200_200/0/1",
"company_description": "Every company has a mission. What's ours? To empower every person and every organization to achieve more."
}
],
"educations": [
{
"university_id": "1792",
"university_name": "Stanford University",
"university_url": "https://www.linkedin.com/school/stanford-university",
"university_logo": "https://media.licdn.com/dms/image/v2/C4E0BAQExample/company-logo_200_200/0/1",
"university_description": null,
"degree": "Master of Science (MS)",
"fields_of_study": [
"Computer Science"
],
"started_on": {
"year": 2004
},
"ended_on": {
"year": 2006
}
}
],
"certifications": [],
"languages": [
{
"name": "English",
"proficiency": "NATIVE_OR_BILINGUAL"
}
],
"volunteering": [],
"patents": [],
"publications": [],
"skills": [
"Cloud Computing",
"Software Development",
"Leadership"
],
"source": "lead_by_link"
},
"meta": {
"amount_charged": 0.04
}
}{
"status": "error",
"status_code": 400,
"detail": {
"fields": "exactly one of id, linkedin_url, email is required"
}
}{
"status": "error",
"status_code": 401,
"detail": "Authentication credentials were not provided."
}{
"status": "error",
"status_code": 402,
"detail": "Insufficient funds in the account."
}{
"status": "error",
"status_code": 403,
"detail": "You do not have permission to perform this action."
}{
"status": "error",
"status_code": 429,
"detail": "Request was throttled."
}Use Case:
Retrieve a fresh lead profile, including reverse email lookup, by Generect ID, LinkedIn URL, or email.Optional sections
Recent LinkedIn activity and the “People also viewed” list are opt-in — send the flag to get the section back:| Flag | Adds | Extra cost |
|---|---|---|
posts | The lead’s latest posts, up to 20, reposts included | +1 credit |
comments | The posts the lead commented on most recently, up to 20, each with the lead’s comment | +1 credit |
reactions | The posts the lead reacted to most recently, up to 20 | +1 credit |
people_also_viewed | Profiles LinkedIn lists under “People also viewed” | +1 credit |
get_full_experience | Past positions on top of the current ones | free |
inexact_company | Fuzzy company match when the exact company cannot be resolved | free |
An extra credit is only charged for a section that actually comes back with data. Requesting
posts on a lead who never posted costs nothing.posted_time_ago (2d, 1w, 1mo), the age LinkedIn shows, and no absolute date. One credit is one billable result at this endpoint’s price, so a real-time profile with all three activity sections costs four results.
Pricing
This is a billable endpoint — you are charged only when a lead is found and returned. If nothing is found, the request is free.Your price decreases automatically as your lifetime spend grows. Check your current tier and pricing →
Authorizations
Body
application/json
- By Generect ID
- By LinkedIn URL
- By Email
Response
Fresh full lead profile
A lead profile. Every field below comes back from both the realtime and the database lead enrich. A field the profile does not have comes back null or as an empty list. Database and email lookups add derived fields on top, such as seniority, schools, past_companies, past_job_titles, position_since and company_since, and a realtime lookup by URL adds input_url and raw_headline. Treat any field not listed here as optional.
Show child attributes
Show child attributes
Was this page helpful?