Get Started
Update leads
Enrich or update your database with detailed lead information from a provided URL.
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,
"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:
-
linkedin.com/pub-profile/…
-
https://www.linkedin.com/in/ACwAADIiK28BsZHX22c9Rm80fUW3LiXKvcLu1Cc
(sales id) -
https://www.linkedin.com/sales/lead/ACwAAA0BOw8BTT9lGuZQWNg9Hd3rK2gHtrjTYOw,NAME_SEARCH,c_8o
-
Custom parameter inexact_company = true:
- Will find
Company ID
for output datapointinexact_company
via company search. Only for cases when leadcompany id == None
ANDcompany_name != empty
.
- Will find
-
Custom Parameter:
people_also_viewed
allows to fetch up to 20 similar profiles, costs 1 additional credit -
Custom Parameter
posts
allows to fetch last 20 posts, costs 1 additional credit -
Custom Parameter
comments
allows to fetch last 20 comments, costs 1 additional credit -
Multiple parameters pass are allowed (
posts
+comments
+people_also_viewed
) -
In case of response with
500 status code
, please send request again
Authorizations
Use 'Token <api-key>' as the value
Body
Response
200
The response is of type object
.
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,
"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é"
}
}