Skip to main content
POST

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:
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.
“Latest” is a count, not a date window: a section holds up to 20 items however old they are. Each item carries 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

Authorization
string
header
required

Use the required Token prefix. Example: Authorization: Token xxxxxxxxx

Body

application/json
id
string
required

Internal Generect lead identifier returned by Search or Preview.

Example:

"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9"

people_also_viewed
boolean
default:false

Include the profile's "People also viewed" list (+1 credit when data is returned).

posts
boolean
default:false

Include the lead's latest posts, up to 20, reposts included. No date window (+1 credit when data is returned).

comments
boolean
default:false

Include the posts the lead commented on most recently, up to 20, each with the lead's comment (+1 credit when data is returned).

reactions
boolean
default:false

Include the posts the lead reacted to most recently, up to 20 (+1 credit when data is returned).

get_full_experience
boolean
default:true

Work history returned in jobs. Defaults to the full history — current and past positions alike. Set to false to receive current positions only. Free.

inexact_company
boolean
default:false

Fall back to a fuzzy company match when the exact company cannot be resolved. Free.

Response

Fresh full lead profile

data
object

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.

meta
object

Operation metadata returned in every data/meta response.