Skip to main content
POST
/
api
/
linkedin
/
leads
/
by_link
/
Get Lead by link
curl --request POST \
  --url https://api.generect.com/api/linkedin/leads/by_link/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "comments": false,
  "inexact_company": false,
  "people_also_viewed": false,
  "posts": false,
  "up_to_the_second_fresh": true,
  "get_full_experience": false,
  "url": "https://www.linkedin.com/company/boris-johnson"
}'
{
  "amount": -1,
  "lead": {
    "certifications": [],
    "company_city": null,
    "company_country": "France",
    "company_description": "ENGIE is a global reference in low-carbon energy and services. With its 97,000 employees, clients, partners and stakeholders, the Group strives every day to accelerate the transition towards a carbon-neutral economy, through reduced energy consumption and more environmentally friendly solutions. Inspired by its purpose statement, ENGIE reconciles economic performance with a positive impact on people and the planet, building on its key businesses (gas, renewable energy, services) to offer competitive solutions to its clients. \n\nWe are a united group, committed to inclusiveness and diversity, where everyone can forge their own career path , improve on their skills, and continually enhance their expertise. We work in a caring, flexible, and secure environment that encourages personal and professional development. #WithENGIE \n\n\nTurnover in 2023: EUR82.6 billion. The Group is listed on the Paris and Brussels stock exchanges (ENGI) and is represented in the main financial indices (CAC 40, Euronext 100, FTSE Euro 100, MSCI Europe) and non-financial indices (DJSI World, Euronext Vigeo Eiris - Europe 120 / France 20, MSCI EMU ESG screened, MSCI EUROPE ESG Universal Select, Stoxx Europe 600 ESG-X).",
    "company_headcount_range": "10001+",
    "company_id": "298246",
    "company_image": "https://media.licdn.com/dms/image/v2/C4D0BAQHQn5EB4SKDyg/company-logo_400_400/company-logo_400_400/0/1630570629615/engie_logo?e=1741219200&v=beta&t=-Ga4LKJPrvzQnNm3PuUG9lkHYwO4IRP1R79TgqSeftc",
    "company_industry": "Utilities",
    "company_location": "France",
    "company_name": "ENGIE",
    "company_state": "",
    "company_url": "https://www.linkedin.com/company/engie/",
    "company_website": "https://www.engie.com/en",
    "educations": [
      {
        "degree": "Certificat de formation generale (CFG)",
        "ended_on": {
          "month": 5,
          "year": 2023
        },
        "fields_of_study": null,
        "started_on": {
          "month": 3,
          "year": 2023
        },
        "university_id": "14803",
        "university_name": "CentraleSupelec"
      },
      {
        "degree": "Ingenieur",
        "ended_on": {
          "year": 2007
        },
        "fields_of_study": [
          "Systeme et Reseau"
        ],
        "started_on": {
          "year": 2002
        },
        "university_id": null,
        "university_name": "EITI"
      },
      {
        "degree": "Certification EasyVista",
        "ended_on": null,
        "fields_of_study": null,
        "started_on": {
          "year": 2013
        },
        "university_id": null,
        "university_name": "EasyVista"
      },
      {
        "degree": "Certification HP SM 9",
        "ended_on": null,
        "fields_of_study": null,
        "started_on": {
          "year": 2012
        },
        "university_id": null,
        "university_name": "HP"
      },
      {
        "degree": "Certification ITIL V2",
        "ended_on": null,
        "fields_of_study": null,
        "started_on": {
          "year": 2012
        },
        "university_id": null,
        "university_name": "ITIL"
      }
    ],
    "first_name": "Birama",
    "full_name": "Birama Traoré",
    "headline": "CIO Procurement - Finance - CSR",
    "industry": "IT Services and IT Consulting",
    "input_url": "https://www.linkedin.com/in/birama-traor%c3%a9/",
    "is_full_data": true,
    "is_job_seeker": false,
    "is_openlink": false,
    "is_premium": false,
    "is_retired": false,
    "job_description": null,
    "job_ended_on": null,
    "job_location": "Paris et peripherie",
    "job_location_city": null,
    "job_location_country": "Ethiopia",
    "job_location_county": null,
    "job_location_state": null,
    "job_started_on": "Sep 2023",
    "job_still_working": true,
    "job_title": "CIO Procurement - Finance - CSR",
    "jobs": [
      {
        "company_city": null,
        "company_country": "France",
        "company_description": "ENGIE is a global reference in low-carbon energy and services. With its 97,000 employees, clients, partners and stakeholders, the Group strives every day to accelerate the transition towards a carbon-neutral economy, through reduced energy consumption and more environmentally friendly solutions. Inspired by its purpose statement, ENGIE reconciles economic performance with a positive impact on people and the planet, building on its key businesses (gas, renewable energy, services) to offer competitive solutions to its clients. \n\nWe are a united group, committed to inclusiveness and diversity, where everyone can forge their own career path , improve on their skills, and continually enhance their expertise. We work in a caring, flexible, and secure environment that encourages personal and professional development. #WithENGIE \n\n\nTurnover in 2023: EUR82.6 billion. The Group is listed on the Paris and Brussels stock exchanges (ENGI) and is represented in the main financial indices (CAC 40, Euronext 100, FTSE Euro 100, MSCI Europe) and non-financial indices (DJSI World, Euronext Vigeo Eiris - Europe 120 / France 20, MSCI EMU ESG screened, MSCI EUROPE ESG Universal Select, Stoxx Europe 600 ESG-X).",
        "company_headcount_range": "10001+",
        "company_id": "298246",
        "company_image": "https://media.licdn.com/dms/image/v2/C4D0BAQHQn5EB4SKDyg/company-logo_400_400/company-logo_400_400/0/1630570629615/engie_logo?e=1741219200&v=beta&t=-Ga4LKJPrvzQnNm3PuUG9lkHYwO4IRP1R79TgqSeftc",
        "company_industry": "Utilities",
        "company_location": "France",
        "company_name": "ENGIE",
        "company_state": "",
        "company_url": "https://www.linkedin.com/company/engie/",
        "company_website": "https://www.engie.com/en",
        "job_description": null,
        "job_ended_on": null,
        "job_location": "Paris et peripherie",
        "job_location_city": null,
        "job_location_country": "Ethiopia",
        "job_location_county": null,
        "job_location_state": null,
        "job_started_on": "Sep 2023",
        "job_still_working": true,
        "job_title": "CIO Procurement - Finance - CSR",
        "raw_company_name": "ENGIE",
        "raw_job_title": "CIO Procurement - Finance - CSR"
      }
    ],
    "languages": [],
    "last_name": "Traoré",
    "linkedin_id": "113966911",
    "linkedin_sales_link": "https://www.linkedin.com/sales/lead/ACwAAAbK_z8BitOI-5PxZa_jkG05STRmNLRaK14,NAME_SEARCH,OJWs",
    "linkedin_url": "https://www.linkedin.com/in/birama-traor%C3%A9",
    "location": "Greater Paris Metropolitan Region",
    "location_city": "",
    "location_country": "France",
    "location_county": null,
    "location_state": "Ile-de-France",
    "middle_name": "",
    "num_of_connections": 2253,
    "private_website": null,
    "profile_photo": "https://media.licdn.com/dms/image/v2/C4D03AQFUuSLnGkiKVA/profile-displayphoto-shrink_800_800/profile-displayphoto-shrink_800_800/0/1625575996700?e=1738800000&v=beta&t=y0ZfbWCCWzmJOHFim2Y5_MSDchOztFjtsqbP61ze_EU",
    "raw_company_name": "ENGIE",
    "raw_headline": "CIO Procurement - Finance - CSR",
    "raw_job_title": "CIO Procurement - Finance - CSR",
    "sales_id": "ACwAAAbK_z8BitOI-5PxZa_jkG05STRmNLRaK14",
    "skills": [],
    "source": "lead_by_link",
    "summary": "I have been working in the Information Technology for the last 15 years. I have occupied different consultancy and management roles within the value chain, ranging from Infrastructure ones to transformation lead ones. In these roles I had the privilege to directly manage highly-skilled teams up to 80 people across 5 different geographies. I have managed business IT operations, process and transformation projects.\n\n3 years ago, I joined ENGIE IT as the Head of Enterprise Service Management with notably two major programs in my scope: The Salesforce & Service Now Center Of Excellence - Both initiatives aims to help our client to achieve exponential growth. \n\nMy best contributions are in transformation environments, where we have to lead our teams through changes in business models and culture. I do believe in leadership by example and I like to enable teams and clients to grow and achieve goals they did not think possible.\n\nMy current topics consist of setting up powerful Center of Excellence in order to foster expertise and take it to the next level of the organization in terms of business objectives & value. The goal is to lead transformation and enhance expertise to serve business growth.",
    "twitter_link": null,
    "unformatted_full_name": "Birama Traoré"
  }
}
Parallel requests limit: 500 requests Recommended timeout: 100 seconds

​
Use Case:

Enhance existing CRM records with updated roles, locations, or company data.

​
Additional Information:

  • Supported input urls example:
  • Custom parameter inexact_company = true:
    • Will find Company ID for output datapoint inexact_company via company search. Only for cases when lead company id == None AND company_name != empty.
  • Custom Parameter: people_also_viewed allows to fetch up to 20 similar profiles, costs 1 additional credit (default: false)
  • Custom Parameter posts allows to fetch last 20 posts, costs 1 additional credit (default: false)
  • Custom Parameter comments allows to fetch last 20 comments, costs 1 additional credit
  • Custom Parameter up_to_the_second_fresh = true: enables real-time data retrieval instead of cached data (default: false). Use this when you need the most current information, though it may result in slower response times.
  • Custom Parameter get_full_experience: by default, only current jobs (where job_still_working == true) are returned. Set to true to return full work history including past positions (default: false)
Full Work History: To get all positions (not just current), use both parameters together:
{
  "url": "https://www.linkedin.com/in/username",
  "get_full_experience": true,
  "up_to_the_second_fresh": true
}
Without up_to_the_second_fresh, cached data with only the current position is returned.
  • Multiple parameters pass are allowed (posts + comments + people_also_viewed + up_to_the_second_fresh + get_full_experience)
  • In case of response with 500 status code, please send request again

Authorizations

​
Authorization
string
header
required

Body

application/json
​
url
string
Example:
​
inexact_company
boolean
Example:
​
comments
boolean
Example:
​
people_also_viewed
boolean
Example:
​
posts
boolean
Example:
​
up_to_the_second_fresh
boolean
Example:
​
get_full_experience
boolean
Example:

Response

​
amount
number
Example:
​
lead
object