NAV
shell python

Overview

Proxycurl API is a set of tools designed to serve as plumbing for fresh and processed data in your application. We sit as a fully-managed layer between your application and raw data so that you can focus on building the application instead of worrying about scraping and processing data at scale.

With Proxycurl API, you can

Open API 3.0

Download Our Proxycurl OpenAPI 3.0 Specs

Authentication

Proxycurl's API uses bearer tokens to authenticate users. Each user is assigned a randomly generated secret key under the API section in the dashboard.

The bearer token is injected in the Authorization header

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    https://nubela.co/proxycurl/api/v2/linkedin?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fwilliamhgates
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/v2/linkedin'
linkedin_profile_url = 'https://www.linkedin.com/in/williamhgates'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}

response = requests.get(api_endpoint,
                        params={'url': linkedin_profile_url},
                        headers=header_dic)

Rate limit

You can make up to 300 requests to our API every minute. The window for the rate limit is 5 minutes. So you can burst up to 1500 requests every 5 minutes.

At periods of high load, our system might tighten rate limits for all accounts to ensure that our services remain accessible for all users.

We return a status code of error 429 when you are rate limited. You can also get a status code error of 429 if the capacity on our end limits us.

You should handle 429 errors and apply exponential backoff.

Credits

Each valid request requires at least 1 credit to be processed.

A credit is consumed if and only if the request is parsed successfully.

A successful request is a request that returns with either a 200 or 404 HTTP status code.

404 status code is considered a successful request because we have commited resources to source the profile and have found that it is not a valid profile.

Timeouts and API response time

Proxycurl API endpoints take an average of 2 seconds to complete.

You are encouraged to make concurrent requests to our API service to maximize throughput. See this post on how you can maximise throughput.

We recommend a timeout of 60 seconds.

Errors

These are the common errors that could be returned by our API:

HTTP Code Description
400 Invalid parameters provided. Refer to the documentation and message body for more info
401 Invalid API Key
403 You have run out of credits
404 The requested resource (e.g: user profile, company) could not be found
429 Rate limited. Please retry
500 There is an error with our API. Please Contact us for assistance
503 Enrichment failed, please retry.

You will NOT be charged if a request returns with an error.

Explain it to me like I'm 5

Company API

What you have What you get Which API Endpoint to use?
LinkedIn (Company) Profile URL Profile data with profile picture, office locations, etc Company Profile Endpoint
LinkedIn (Company) Profile URL Number of employees in a company Employee Count Endpoint
LinkedIn (Company) Profile URL List of employees Employee Listing Endpoint
Company name or company domain LinkedIn (Company) Profile URL Company Lookup Endpoint

Contact API

What you have What you get after lookup Which API Endpoint to use?
Work Email Address LinkedIn (Person) Profile URL Reverse Work Email Lookup Endpoint
LinkedIn (Person) Profile URL List of Personal Contact Numbers Personal Contact Number Lookup Endpoint
LinkedIn (Person) Profile URL List of Personal Emails Personal Email Lookup Endpoint
Email Address Disposable Email Check Disposable email Endpoint

Jobs API

What you have What you get Which API Endpoint to use?
Company Profile URL List of open job position Jobs Listing Endpoint
LinkedIn (Company) Profile URL Detailed job data Job Profile Endpoint

People API

What you have What you get Which API Endpoint to use?
Person Profile URL Profile data with profile picture, job history, etc. Person Profile Endpoint
First name and Company domain LinkedIn (Person) Profile URL Person Lookup Endpoint
Company Name and Role LinkedIn (Person) Profile URL Role Lookup Endpoint

School API

What you have What you get Which API Endpoint to use?
LinkedIn (School) Profile URL Profile data with profile picture, school location, etc School Profile Endpoint

Reveal IP

What you have What you get Which API Endpoint to use?
An IPV4 address The owner of the IPV4 address's company profile Reveal Endpoint

Meta API

What you have What you get Which API Endpoint to use?
A Proxycurl API Key Balance of credits View Credit Balance Endpoint

Company API

Employee Count Endpoint

GET /proxycurl/api/linkedin/company/employees/count

Cost: 1 credit / successful request.

Get a number of total employees of a Company.

This API endpoint is limited by LinkDB which is populated with profiles in the US, UK, Canada, Israel, Australia, Ireland, New Zealand and Singapore. As such, this endpoint is best used to list employees working in companies based in the US, UK, Canada, Israel, Australia, Ireland, New Zealand and Singapore only.

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    https://nubela.co/proxycurl/api/linkedin/company/employees/count?employment_status=current&url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fnubela
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/linkedin/company/employees/count'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
params = {
    'employment_status': 'current',
    'url': 'https://www.linkedin.com/company/nubela',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
employment_status no Parameter to tell the API to filter past or current employees.

Valid values are current, past, and all:

* current (default) : count current employees
* past : count past employees
* all : count current & past employees
current
url yes URL of the LinkedIn Company Profile to target.

URL should be in the format of https://www.linkedin.com/company/<public_identifier>
https://www.linkedin.com/company/nubela

Response

{
    "total_employee": 1
}
Key Description Example
total_employee 1

Employee Listing Endpoint

GET /proxycurl/api/linkedin/company/employees/

Cost: 3 credits / employee returned.

Get a list of employees of a Company.

This API endpoint is limited by LinkDB which is populated with profiles in the US, UK, Canada, Israel, Australia, Ireland, New Zealand and Singapore. As such, this endpoint is best used to list employees working in companies based in the US, UK, Canada, Israel, Australia, Ireland, New Zealand and Singapore only.

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    https://nubela.co/proxycurl/api/linkedin/company/employees/?role_search=%5BCc%5D.%2B%5BEe%5D.%2B%5BOo%5D.%2B&page_size=1000&employment_status=current&url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fnubela
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/linkedin/company/employees/'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
params = {
    'role_search': '[Cc].+[Ee].+[Oo].+',
    'page_size': '1000',
    'employment_status': 'current',
    'url': 'https://www.linkedin.com/company/nubela',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
role_search no Filter employees by their title by matching the employee's title against a regular expression.

The default value of this parameter is null.

The accepted value is a regular expression (regex).

(The base cost of calling this API endpoint with this parameter would be 10 credits.
Each employee matched and returned would cost 6 credits per employee returned.)
[Cc].+[Ee].+[Oo].+
page_size no Tune the maximum results returned per API call.

The default value of this parameter is 200000.

Accepted values for this parameter is an integer ranging from 1 to 200000.
1000
employment_status no Parameter to tell the API to return past or current employees.

Valid values are current, past, and all:

* current (default) : lists current employees
* past : lists past employees
* all : lists current & past employees
current
url yes URL of the LinkedIn Company Profile to target.

URL should be in the format of https://www.linkedin.com/company/<public_identifier>
https://www.linkedin.com/company/nubela

Response

{
    "employees": [
        {
            "profile_url": "https://www.linkedin.com/in/steven-goh-6738131b"
        }
    ]
}
Key Description Example
employees List of ProfileUrl See ProfileUrl object
next_page "https://nubela.co/proxycurl/api/linkedin/company/employees/?employment_status=current\u0026url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fnubela\u0026after=token-1f71450f-8feb"

ProfileUrl

Key Description Example
profile_url "https://www.linkedin.com/in/steven-goh-6738131b"

Company Lookup Endpoint

GET /proxycurl/api/linkedin/company/resolve

Cost: 2 credits / successful request.

Resolve Company LinkedIn Profile from company name, domain name and location.

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    https://nubela.co/proxycurl/api/linkedin/company/resolve?location=sg&company_domain=accenture.com&company_name=Accenture
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/linkedin/company/resolve'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
params = {
    'location': 'sg',
    'company_domain': 'accenture.com',
    'company_name': 'Accenture',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
location no The location / region of company.
ISO 3166-1 alpha-2 codes
sg
company_domain Requires either company_domain or company_name Company website or Company domain accenture.com
company_name Requires either company_domain or company_name Company Name Accenture

Response

{
    "url": "https://www.linkedin.com/company/accenture"
}
Key Description Example
url "https://www.linkedin.com/company/accenture"

Remarks

The accuracy of the linkedin company profile returned is on a best-effort basis. Results are not guaranteed to be accurate. We are always improving on the accuracy of these endpoints iteratively.

Company Profile Endpoint

GET /proxycurl/api/linkedin/company

Cost: 1 credit / successful request.

Get structured data of a Company Profile

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    https://nubela.co/proxycurl/api/linkedin/company?resolve_numeric_id=false&categories=include&funding_data=include&extra=include&exit_data=include&acquisitions=include&url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2F70982840%2F&use_cache=if-present
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/linkedin/company'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
params = {
    'resolve_numeric_id': 'false',
    'categories': 'include',
    'funding_data': 'include',
    'extra': 'include',
    'exit_data': 'include',
    'acquisitions': 'include',
    'url': 'https://www.linkedin.com/company/70982840/',
    'use_cache': 'if-present',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
resolve_numeric_id no Enable support for Company Profile URLs with numerical IDs that you most frequently fetch from Sales Navigator.
We achieve this by resolving numerical IDs into vanity IDs with cached company profiles from LinkDB.
For example, we will turn https://www.linkedin.com/company/1234567890 to https://www.linkedin.com/company/acme-corp -- for which the API endpoint only supports the latter.

This parameter accepts the following values:
- false (default value) - Will not resolve numerical IDs.
- true - Enable support for Company Profile URLs with numerical IDs.
Costs an extra 2 credit on top of the base cost of the endpoint.
false
categories no Appends categories data of this company.

Default value is "exclude".
The other acceptable value is "include", which will include these categories (if available) for 1 extra credit.
include
funding_data no Returns a list of funding rounds that this company has received.

Default value is "exclude".
The other acceptable value is "include", which will include these categories (if available) for 1 extra credit.
include
extra no Enriches the Company Profile with extra details from external sources. Details include Crunchbase ranking, contact email, phone number, Facebook account, Twitter account, funding rounds and amount, IPO status, investor information, etc.

Default value is "exclude".
The other acceptable value is "include", which will include these extra details (if available) for 1 extra credit.
include
exit_data no Returns a list of investment portfolio exits.

Default value is "exclude".
The other acceptable value is "include", which will include these categories (if available) for 1 extra credit.
include
acquisitions no Provides further enriched data on acquisitions made by this company from external sources.

Default value is "exclude".
The other acceptable value is "include", which will include these acquisition data (if available) for 1 extra credit.
include
url yes URL of the LinkedIn Company Profile to crawl.

URL should be in the format of https://www.linkedin.com/company/<public_identifier>
https://www.linkedin.com/company/70982840/
use_cache no if-present Fetches profile from cache regardless of age of profile. If profile is not available in cache, API will attempt to source profile externally.

if-recent The default behavior. API will make a best effort to return a fresh profile no older than 29 days.
if-present

Response

{
    "acquisitions": null,
    "background_cover_image_url": "https://media-exp1.licdn.com/dms/image/C561BAQEIwpuC5RIJng/company-background_10000/0/1607565126158?e=2159024400\u0026v=beta\u0026t=Ku1KxfAreW74NIYryJU1lyGYOj0n50uyEiQvuICMW14",
    "categories": [],
    "company_size": [
        1,
        10
    ],
    "company_size_on_linkedin": 5,
    "company_type": "SELF-EMPLOYED",
    "description": "Company To provide more Information about Dota",
    "exit_data": [],
    "extra": null,
    "follower_count": 89,
    "founded_year": 2020,
    "funding_data": [],
    "hq": {
        "city": "Bandung",
        "country": "ID",
        "is_hq": true,
        "line_1": "Jalan Ahmad Yani Nomor 2",
        "postal_code": "64466",
        "state": "Jawa Barat"
    },
    "industry": "Computer Games",
    "linkedin_internal_id": "70982840",
    "locations": [
        {
            "city": "Bandung",
            "country": "ID",
            "is_hq": true,
            "line_1": "Jalan Ahmad Yani Nomor 2",
            "postal_code": "64466",
            "state": "Jawa Barat"
        },
        {
            "city": "Bandung",
            "country": "ID",
            "is_hq": false,
            "line_1": null,
            "postal_code": null,
            "state": null
        }
    ],
    "name": "Silver Edge",
    "profile_pic_url": "https://media-exp1.licdn.com/dms/image/C560BAQHeQnh13j1fjA/company-logo_200_200/0/1607564800824?e=2159024400\u0026v=beta\u0026t=kszRh90wyh5c2RoHQECQj1RCBnSOJOXrY9puC86FShc",
    "search_id": "70982840",
    "similar_companies": [
        {
            "industry": "Information Technology and Services",
            "link": "https://id.linkedin.com/company/wesclic",
            "location": "Yogyakarta, Yogyakarta",
            "name": "Wesclic Indonesia"
        },
        {
            "industry": "Marketing and Advertising",
            "link": "https://fi.linkedin.com/company/kuasi",
            "location": "Turku, Turku",
            "name": "Kuasi"
        },
        {
            "industry": "Internet",
            "link": "https://www.linkedin.com/company/toptal",
            "location": "Work from Anywhere, Remote",
            "name": "Toptal"
        },
        {
            "industry": "Design",
            "link": "https://id.linkedin.com/company/hubton",
            "location": "Jakarta Selatan, Jakarta",
            "name": "Hubton Indonesia"
        },
        {
            "industry": "Computer Software",
            "link": "https://www.linkedin.com/company/empoweringexperts",
            "location": null,
            "name": "EmpoweringExperts"
        },
        {
            "industry": "Computer Software",
            "link": "https://dk.linkedin.com/company/traels-it",
            "location": "Odense V, Fyn",
            "name": "traels.it"
        },
        {
            "industry": "Information Services",
            "link": "https://ru.linkedin.com/company/geoalert",
            "location": "Skolkovo, Moscow",
            "name": "GeoAlert LLC"
        },
        {
            "industry": "Information Technology and Services",
            "link": "https://sg.linkedin.com/company/taksu-teknologi",
            "location": "Singapore, Singapore",
            "name": "Taksu Tech"
        },
        {
            "industry": "Information Technology and Services",
            "link": "https://id.linkedin.com/company/birutekno-inc",
            "location": "Bandung, Jawa Barat",
            "name": "Birutekno Inc."
        },
        {
            "industry": "Information Technology and Services",
            "link": "https://tr.linkedin.com/company/arviatech",
            "location": "Ata\u015fehir, \u0130stanbul",
            "name": "Arvia"
        }
    ],
    "specialities": [
        "Gaming and ESPORT"
    ],
    "tagline": "Once used to slay an unjust king, only to have the kingdom erupt into civil war in the aftermath.",
    "universal_name_id": "silver-edge",
    "updates": [
        {
            "article_link": "https://id.linkedin.com/company/silver-edge",
            "image": "https://media-exp1.licdn.com/dms/image/C560BAQHeQnh13j1fjA/company-logo_400_400/0/1607564800824?e=1651708800\u0026v=beta\u0026t=vBEpc3ASCLNZSZ6_-sCwG5gCyXgqiAeKi_ypifDlMdg",
            "posted_on": {
                "day": 25,
                "month": 1,
                "year": 2022
            },
            "text": "We\u2019ve just updated our Page. Visit our Page to see the latest updates.",
            "total_likes": 0
        },
        {
            "article_link": null,
            "image": "https://media-exp1.licdn.com/dms/image/C5622AQFb2W1fAh9COQ/feedshare-shrink_2048_1536/0/1643095919497?e=1646265600\u0026v=beta\u0026t=haqnrZ5pVONn7jokiQPKoLM3T7HrgAkKnbBDo2VK8UY",
            "posted_on": {
                "day": 25,
                "month": 1,
                "year": 2022
            },
            "text": "Valve is getting sneakier when dropping its new heroes for Dota 2, as Marci joins the game\u2019s roster less than two weeks after being revealed at The International 10. \nThe newest hero is being added alongside gameplay update 7.30e, which is a big post-TI patch that takes into account everything that happened on Dota\u2019s biggest stage, nerfing and buffing heroes and items across the board.\n\nMarci, an original character that first appeared in the Netflix animated series Dota: Dragon\u2019s Blood is the second piece of content added to the game from the show\u2019s universe, alongside a special skin for Davion, the Dragon Knight, the show\u2019s main character. As an added touch, all of her voicelines are whistles since she is mute in the show.\n\nas many expected, she is a melee hero that can play support or carry, acting as a brute that is willing to rush in and deal damage with a flurry of rapid strikes or fling friends and foes alike around the map as a way to displace or initiate in unique ways for herself and her teammates. She also has high survivability and can give herself and an ally both lifesteal and an attack boost with her Sidekick ability. \n\n#dota2 #dota #netflix #marci",
            "total_likes": 0
        }
    ],
    "website": "https://autorpomen.com"
}
Key Description Example
linkedin_internal_id LinkedIn's Internal and immutable ID of this Company profile. "70982840"
description "Company To provide more Information about Dota"
website "https://autorpomen.com"
industry "Computer Games"
company_size Listed range of company head count [1, 10]
company_size_on_linkedin 5
hq A CompanyLocation object See CompanyLocation object
company_type Possible values:

EDUCATIONAL: Educational Institution

GOVERNMENT_AGENCY: Government Agency

NON_PROFIT : Nonprofit

PARTNERSHIP : Partnership

PRIVATELY_HELD: Privately Held

PUBLIC_COMPANY: Public Company

SELF_EMPLOYED: Self-Employed

SELF_OWNED: Sole Proprietorship
"SELF-EMPLOYED"
founded_year 2020
specialities ["Gaming and ESPORT"]
locations List of CompanyLocation See CompanyLocation object
name "Silver Edge"
tagline "Think Different - But Not Too Different"
universal_name_id "silver-edge"
profile_pic_url "https://media-exp1.licdn.com/dms/image/C560BAQHeQnh13j1fjA/company-logo_200_200/0/1607564800824?e=2159024400\u0026v=beta\u0026t=kszRh90wyh5c2RoHQECQj1RCBnSOJOXrY9puC86FShc"
background_cover_image_url "https://media-exp1.licdn.com/dms/image/C561BAQEIwpuC5RIJng/company-background_10000/0/1607565126158?e=2159024400\u0026v=beta\u0026t=Ku1KxfAreW74NIYryJU1lyGYOj0n50uyEiQvuICMW14"
search_id Useable with Job listing endpoint "70982840"
similar_companies List of SimilarCompany See SimilarCompany object
updates List of CompanyUpdate See CompanyUpdate object
follower_count 89
acquisitions An Acquisition object See Acquisition object
exit_data List of Exit See Exit object
extra A CompanyDetails object See CompanyDetails object
funding_data List of Funding See Funding object
categories A list of categories` ["artificial-intelligence", "virtual-reality"]

CompanyLocation

Key Description Example
country "ID"
city "Bandung"
postal_code "64466"
line_1 "Jalan Ahmad Yani Nomor 2"
is_hq true
state "Jawa Barat"

SimilarCompany

Key Description Example
name "Wesclic Indonesia"
link "https://id.linkedin.com/company/wesclic"
industry "Information Technology and Services"
location "Yogyakarta, Yogyakarta"

CompanyUpdate

Key Description Example
article_link The URL for which the post links out to "https://lnkd.in/gr7cb5by"
image The URL to the image to the post (if it exists) "https://media-exp1.licdn.com/dms/image/C5622AQEGh8idEAm14Q/feedshare-shrink_800/0/1633089889886?e=1637798400\u0026v=beta\u0026t=LtGtAUSJNrPYdHpVhTBLhGTWYqrHtFJ86PKSmTpou7c"
posted_on A Date object See Date object
text The body of the update "Introducing Personal Email Lookup API https://lnkd.in/gr7cb5by"
total_likes The total likes a post has received 3

Date

Key Description Example
day 30
month 9
year 2021

Acquisition

Key Description Example
acquired List of AcquiredCompany See AcquiredCompany object
acquired_by An Acquisitor object See Acquisitor object

AcquiredCompany

Key Description Example
linkedin_profile_url LinkedIn Company Profile URL of company that was involved "https://www.linkedin.com/company/apple"
crunchbase_profile_url Crunchbase Profile URL of company that was involved "https://www.crunchbase.com/organization/apple"
announced_date A Date object See Date object
price Price of acquisition 300000000

Date

Key Description Example
day 1
month 4
year 1976

Acquisitor

Key Description Example
linkedin_profile_url LinkedIn Company Profile URL of company that was involved "https://www.linkedin.com/company/nvidia"
crunchbase_profile_url Crunchbase Profile URL of company that was involved "https://www.crunchbase.com/organization/nvidia"
announced_date A Date object See Date object
price Price of acquisition 10000

Date

Key Description Example
day 6
month 3
year 2020

Exit

Key Description Example
linkedin_profile_url LinkedIn Profile URL of the company that has exited "https://www.linkedin.com/company/motiondsp"
crunchbase_profile_url Crunchbase Profile URL of the company that has exited "https://www.crunchbase.com/organization/motiondsp"
name Name of the company "MotionDSP"

CompanyDetails

Key Description Example
ipo_status IPO status of the company "Public"
crunchbase_rank A measure of prominence of this company by Crunchbase 13
founding_date A Date object See Date object
operating_status Status of the company's operational status "Active"
company_type Type of company "For Profit"
contact_email General contact email of the company "[email protected]"
phone_number General contact number of the company "(140) 848-6200"
facebook_id ID of the company's official Facebook account "NVIDIA.IN"
twitter_id ID of the company's official Twitter account "nvidia"
number_of_funding_rounds Total rounds of funding that this company has raised 3
total_funding_amount Total venture capital raised by this company 4000000
stock_symbol Stock symbol of this public company "NASDAQ:NVDA"
ipo_date A Date object See Date object
number_of_lead_investors Total lead investors 3
number_of_investors Total investors 4
total_fund_raised The total amount of funds raised (by this VC firm) to be deployed as subsidiary investments (applicable only for VC firms) 1000
number_of_investments Total investments made by this VC firm (applicable only for VC firms) 50
number_of_lead_investments Total investments that was led by this VC firm (applicable only for VC firms) 3
number_of_exits Total exits by this VC (applicable only for VC firms) 7
number_of_acquisitions Total companies acquired by this company 2

Date

Key Description Example
day 1
month 1
year 2000

Funding

Key Description Example
funding_type Type of funding "Grant"
money_raised Amount of money raised 25000000
announced_date A Date object See Date object
number_of_investor Number of investors in this round 1
investor_list List of Investor See Investor object

Date

Key Description Example
day 1
month 1
year 2001

Investor

Key Description Example
linkedin_profile_url LinkedIn Profile URL of investor "https://linkedin.com/company/darpa"
name Name of investor "DARPA"
type Type of investor "organization"

Contact API

Reverse Work Email Lookup Endpoint

GET /proxycurl/api/linkedin/profile/resolve/email

Cost: 3 credits / successful request.

Resolve LinkedIn Profile from a work email address

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    https://nubela.co/proxycurl/api/linkedin/profile/resolve/email?work_email=danial%40nubela.co
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/linkedin/profile/resolve/email'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
params = {
    'work_email': '[email protected]',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
work_email yes Work email address of the user [email protected]

Response

{
    "url": "https://id.linkedin.com/in/danial-habibi"
}
Key Description Example
url "https://id.linkedin.com/in/danial-habibi"

Remarks

The accuracy of the linkedin profile returned is on a best-effort basis. Results are not guaranteed to be accurate. If you have more data points about the user, you are encouraged to use the Company Lookup Endpoint for better outcome.

Work Email Lookup Endpoint

GET /proxycurl/api/linkedin/profile/email

Cost: 3 credits / request.

Lookup work email address of a LinkedIn Person Profile.

Email addresses returned are verified to not be role-based or catch-all emails. Email addresses returned by our API endpoint come with a 95+% deliverability guarantee

Endpoint behavior

This endpoint may not return results immediately.

If you provided a webhook in your request parameter, our application will call your webhook with the result once. See Webhook payload below.

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    https://nubela.co/proxycurl/api/linkedin/profile/email?linkedin_profile_url=https%3A%2F%2Fsg.linkedin.com%2Fin%2Fwilliamhgates&callback_url=https%3A%2F%2Fwebhook.site%2F29e12f17-d5a2-400a-9d08-42ee9d83600a
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/linkedin/profile/email'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
params = {
    'linkedin_profile_url': 'https://sg.linkedin.com/in/williamhgates',
    'callback_url': 'https://webhook.site/29e12f17-d5a2-400a-9d08-42ee9d83600a',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
linkedin_profile_url yes Linkedin Profile URL of the person you want to
extract work email address from.
https://sg.linkedin.com/in/williamhgates
callback_url no Webhook to notify your application when
the request has finished processing.
https://webhook.site/29e12f17-d5a2-400a-9d08-42ee9d83600a

Status codes

Status codes Description
202 The result is being processed. The API will send
results to you via callback if a callback URL is provided. You can also see the result on your dashboard.
The results sent to the callback will have the following format:
{'email': ..., 'status': ...}

Response

{
    "email_queue_count": 0
}
Key Description Example
email_queue_count Total queue in the email extraction process 0

Personal Contact Number Lookup Endpoint

GET /proxycurl/api/contact-api/personal-contact

Cost: 1 credit / contact number returned.

Given an LinkedIn profile, returns a list of personal contact numbers belonging to this identity.

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    https://nubela.co/proxycurl/api/contact-api/personal-contact?linkedin_profile_url=https%3A%2F%2Flinkedin.com%2Fin%2Ftest-phone-number
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/contact-api/personal-contact'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
params = {
    'linkedin_profile_url': 'https://linkedin.com/in/test-phone-number',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
linkedin_profile_url yes LinkedIn Profile URL of the person you want to extract personal contact numbers from. https://linkedin.com/in/test-phone-number

Response

{
    "numbers": [
        "+1123123123"
    ]
}
Key Description Example
numbers A list of contact numbers ["+1123123123"]

Personal Email Lookup Endpoint

GET /proxycurl/api/contact-api/personal-email

Cost: 1 credit / email returned.

Given an LinkedIn profile, returns a list of personal emails belonging to this identity. Emails are verified to be deliverable.

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    https://nubela.co/proxycurl/api/contact-api/personal-email?email_validation=include&linkedin_profile_url=https%3A%2F%2Flinkedin.com%2Fin%2Fsteven-goh-6738131b
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/contact-api/personal-email'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
params = {
    'email_validation': 'include',
    'linkedin_profile_url': 'https://linkedin.com/in/steven-goh-6738131b',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
email_validation no Perform deliverability validation on each email. (Costs 1 extra credit per email found).

Takes the following values:
* include - Perform email validation.
* exclude (default) - Do not perform email validation.
include
linkedin_profile_url yes LinkedIn Profile URL of the person you want to extract personal email addresses from. https://linkedin.com/in/steven-goh-6738131b

Response

{
    "emails": [
        "[email protected]",
        "[email protected]"
    ],
    "invalid_emails": [
        "[email protected]"
    ]
}
Key Description Example
emails A list of personal emails ["[email protected]", "[email protected]"]
invalid_emails A list of invalid personal emails ["[email protected]"]

Disposable Email Address Check Endpoint

GET /proxycurl/api/disposable-email

Cost: 0 credit / request.

Given an email address, checks if the email address belongs to a disposable email service.

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    https://nubela.co/proxycurl/api/disposable-email?email=steven%40nubela.co
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/disposable-email'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
params = {
    'email': '[email protected]',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
email yes Email address to check [email protected]

Response

{
    "is_disposable_email": false,
    "is_free_email": false
}
Key Description Example
is_disposable_email Returns a boolean value of the disposable nature of the given email address false
is_free_email Returns a boolean value of the free status of the given email address false

Jobs API

Jobs Listing Endpoint

GET /proxycurl/api/v2/linkedin/company/job

Cost: 1 credit / successful request.

List jobs posted by a company on LinkedIn

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    https://nubela.co/proxycurl/api/v2/linkedin/company/job?search_id=4999584
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/v2/linkedin/company/job'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
params = {
    'search_id': '4999584',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
search_id yes The search_id of the company on LinkedIn.
You can get the search_id of a LinkedIn company via Company Profile API.
4999584

Response

{
    "job": [
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Product Trainer",
            "job_url": "https://it.linkedin.com/jobs/view/product-trainer-at-doctolib-2590344814",
            "list_date": "2021-06-12",
            "location": "Milan, Lombardy, Italy"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Operations Strategy Intern (x/f/m)",
            "job_url": "https://fr.linkedin.com/jobs/view/operations-strategy-intern-x-f-m-at-doctolib-2561508431",
            "list_date": "2021-05-26",
            "location": "Greater Paris Metropolitan Region"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Corporate FP\u0026A Intern (x/h/f)",
            "job_url": "https://fr.linkedin.com/jobs/view/corporate-fp-a-intern-x-h-f-at-doctolib-2587845866",
            "list_date": "2021-06-10",
            "location": "Levallois-Perret, \u00cele-de-France, France"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Product Operations Strategy Intern",
            "job_url": "https://fr.linkedin.com/jobs/view/product-operations-strategy-intern-at-doctolib-2490140006",
            "list_date": "2021-06-18",
            "location": "Levallois-Perret, \u00cele-de-France, France"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Marketing Business Analyst Intern",
            "job_url": "https://fr.linkedin.com/jobs/view/marketing-business-analyst-intern-at-doctolib-2561508445",
            "list_date": "2021-05-26",
            "location": "Greater Paris Metropolitan Region"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Product Designer (x/f/m)",
            "job_url": "https://fr.linkedin.com/jobs/view/product-designer-x-f-m-at-doctolib-2528386868",
            "list_date": "2021-06-11",
            "location": "Levallois-Perret, \u00cele-de-France, France"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Stage Strategic Business Analyst",
            "job_url": "https://fr.linkedin.com/jobs/view/stage-strategic-business-analyst-at-doctolib-2500109638",
            "list_date": "2021-06-18",
            "location": "Levallois-Perret, \u00cele-de-France, France"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Commerciale",
            "job_url": "https://it.linkedin.com/jobs/view/commerciale-at-doctolib-2604923019",
            "list_date": "2021-06-21",
            "location": "Bergamo, Lombardy, Italy"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Senior Product Manager",
            "job_url": "https://fr.linkedin.com/jobs/view/senior-product-manager-at-doctolib-2593704383",
            "list_date": "2021-06-14",
            "location": "Levallois-Perret, \u00cele-de-France, France"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "R\u0026D Financing Intern (x/f/m)",
            "job_url": "https://fr.linkedin.com/jobs/view/r-d-financing-intern-x-f-m-at-doctolib-2561506846",
            "list_date": "2021-05-26",
            "location": "Greater Paris Metropolitan Region"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Product Marketing Manager",
            "job_url": "https://fr.linkedin.com/jobs/view/product-marketing-manager-at-doctolib-2490139056",
            "list_date": "2021-06-18",
            "location": "Levallois-Perret, \u00cele-de-France, France"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Operations Strategy Intern (x/f/m)",
            "job_url": "https://fr.linkedin.com/jobs/view/operations-strategy-intern-x-f-m-at-doctolib-2490136448",
            "list_date": "2021-06-18",
            "location": "Levallois-Perret, \u00cele-de-France, France"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Program Manager - Tech \u0026 Product Learning",
            "job_url": "https://fr.linkedin.com/jobs/view/program-manager-tech-product-learning-at-doctolib-2585145595",
            "list_date": "2021-06-09",
            "location": "Levallois-Perret, \u00cele-de-France, France"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "People Strategy Associate - Global Operations Team (x/f/m)",
            "job_url": "https://fr.linkedin.com/jobs/view/people-strategy-associate-global-operations-team-x-f-m-at-doctolib-2551259268",
            "list_date": "2021-06-18",
            "location": "Levallois-Perret, \u00cele-de-France, France"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Junior Account Manager (x/f/h)",
            "job_url": "https://fr.linkedin.com/jobs/view/junior-account-manager-x-f-h-at-doctolib-2539689891",
            "list_date": "2021-06-17",
            "location": "Levallois-Perret, \u00cele-de-France, France"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Engineering Program Manager (x/f/m)",
            "job_url": "https://fr.linkedin.com/jobs/view/engineering-program-manager-x-f-m-at-doctolib-2594474723",
            "list_date": "2021-06-15",
            "location": "Levallois-Perret, \u00cele-de-France, France"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Assistant(e) marketing digital (x/f/m)",
            "job_url": "https://fr.linkedin.com/jobs/view/assistant-e-marketing-digital-x-f-m-at-doctolib-2597314424",
            "list_date": "2021-06-16",
            "location": "Levallois-Perret, \u00cele-de-France, France"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Business Developer (x/f/m) - Milan",
            "job_url": "https://it.linkedin.com/jobs/view/business-developer-x-f-m-milan-at-doctolib-2593705285",
            "list_date": "2021-06-14",
            "location": "Milan, Lombardy, Italy"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Assistant(e) marketing digital (x/f/m)",
            "job_url": "https://fr.linkedin.com/jobs/view/assistant-e-marketing-digital-x-f-m-at-doctolib-2561507819",
            "list_date": "2021-05-26",
            "location": "Paris, \u00cele-de-France, France"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Brand Designer (x/f/m)",
            "job_url": "https://fr.linkedin.com/jobs/view/brand-designer-x-f-m-at-doctolib-2595435660",
            "list_date": "2021-06-15",
            "location": "Levallois-Perret, \u00cele-de-France, France"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Field Sales Account (x/f/m) - Varese",
            "job_url": "https://it.linkedin.com/jobs/view/field-sales-account-x-f-m-varese-at-doctolib-2593707075",
            "list_date": "2021-06-14",
            "location": "Milan, Lombardy, Italy"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Engineering Manager (x/f/h)",
            "job_url": "https://fr.linkedin.com/jobs/view/engineering-manager-x-f-h-at-doctolib-2583430359",
            "list_date": "2021-06-08",
            "location": "Nantes, Pays de la Loire, France"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "B to C Marketing Manager Italy (x/f/m)",
            "job_url": "https://it.linkedin.com/jobs/view/b-to-c-marketing-manager-italy-x-f-m-at-doctolib-2572077585",
            "list_date": "2021-06-01",
            "location": "Milan, Lombardy, Italy"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Ethics \u0026 Compliance Officer (x/h/f)",
            "job_url": "https://fr.linkedin.com/jobs/view/ethics-compliance-officer-x-h-f-at-doctolib-2564936530",
            "list_date": "2021-06-18",
            "location": "Levallois-Perret, \u00cele-de-France, France"
        },
        {
            "company": "Doctolib",
            "company_url": "https://fr.linkedin.com/company/doctolib",
            "job_title": "Engineering Manager (x/f/h)",
            "job_url": "https://fr.linkedin.com/jobs/view/engineering-manager-x-f-h-at-doctolib-2551257616",
            "list_date": "2021-06-18",
            "location": "Levallois-Perret, \u00cele-de-France, France"
        }
    ],
    "next_page_api_url": "http://nubela.co/proxycurl-dev/proxycurl-dev/api/v2/linkedin/company/job?pagination=eyJwYWdlIjogMSwgImNvb2tpZXMiOiBbeyJ2ZXJzaW9uIjogMCwgIm5hbWUiOiAiYmNvb2tpZSIsICJ2YWx1ZSI6ICJcInY9MiYwNDMxY2I0YS0yZmI2LTQ5ZTUtOGYxMC01ZTQ2MDU0NGEyMTNcIiIsICJwb3J0IjogbnVsbCwgInBvcnRfc3BlY2lmaWVkIjogZmFsc2UsICJkb21haW4iOiAiLmxpbmtlZGluLmNvbSIsICJkb21haW5fc3BlY2lmaWVkIjogdHJ1ZSwgImRvbWFpbl9pbml0aWFsX2RvdCI6IHRydWUsICJwYXRoIjogIi8iLCAicGF0aF9zcGVjaWZpZWQiOiB0cnVlLCAic2VjdXJlIjogdHJ1ZSwgImV4cGlyZXMiOiAxNjg3MzgwMzE0LCAiZGlzY2FyZCI6IGZhbHNlLCAiY29tbWVudCI6IG51bGwsICJjb21tZW50X3VybCI6IG51bGwsICJyZmMyMTA5IjogZmFsc2UsICJyZXN0IjogeyJTYW1lU2l0ZSI6ICJOb25lIn19LCB7InZlcnNpb24iOiAwLCAibmFtZSI6ICJsYW5nIiwgInZhbHVlIjogInY9MiZsYW5nPWVuLXVzIiwgInBvcnQiOiBudWxsLCAicG9ydF9zcGVjaWZpZWQiOiBmYWxzZSwgImRvbWFpbiI6ICIubGlua2VkaW4uY29tIiwgImRvbWFpbl9zcGVjaWZpZWQiOiB0cnVlLCAiZG9tYWluX2luaXRpYWxfZG90IjogZmFsc2UsICJwYXRoIjogIi8iLCAicGF0aF9zcGVjaWZpZWQiOiB0cnVlLCAic2VjdXJlIjogdHJ1ZSwgImV4cGlyZXMiOiBudWxsLCAiZGlzY2FyZCI6IHRydWUsICJjb21tZW50IjogbnVsbCwgImNvbW1lbnRfdXJsIjogbnVsbCwgInJmYzIxMDkiOiBmYWxzZSwgInJlc3QiOiB7IlNhbWVTaXRlIjogIk5vbmUifX0sIHsidmVyc2lvbiI6IDAsICJuYW1lIjogImxpZGMiLCAidmFsdWUiOiAiXCJiPVZHU1QwNDpzPVY6cj1WOmE9VjpwPVY6Zz0yMzg1OnU9MTppPTE2MjQyNjY0NjI6dD0xNjI0MzUyODYyOnY9MjpzaWc9QVFFV0RfVlJ1NERoOHRBam5PY1NrNl9Rc2IzQkxjNTFcIiIsICJwb3J0IjogbnVsbCwgInBvcnRfc3BlY2lmaWVkIjogZmFsc2UsICJkb21haW4iOiAiLmxpbmtlZGluLmNvbSIsICJkb21haW5fc3BlY2lmaWVkIjogdHJ1ZSwgImRvbWFpbl9pbml0aWFsX2RvdCI6IHRydWUsICJwYXRoIjogIi8iLCAicGF0aF9zcGVjaWZpZWQiOiB0cnVlLCAic2VjdXJlIjogdHJ1ZSwgImV4cGlyZXMiOiAxNjI0MzUyODYyLCAiZGlzY2FyZCI6IGZhbHNlLCAiY29tbWVudCI6IG51bGwsICJjb21tZW50X3VybCI6IG51bGwsICJyZmMyMTA5IjogZmFsc2UsICJyZXN0IjogeyJTYW1lU2l0ZSI6ICJOb25lIn19LCB7InZlcnNpb24iOiAwLCAibmFtZSI6ICJKU0VTU0lPTklEIiwgInZhbHVlIjogImFqYXg6Mjc5OTYwNDI3NjIzMDA1NzY0NCIsICJwb3J0IjogbnVsbCwgInBvcnRfc3BlY2lmaWVkIjogZmFsc2UsICJkb21haW4iOiAiLnd3dy5saW5rZWRpbi5jb20iLCAiZG9tYWluX3NwZWNpZmllZCI6IHRydWUsICJkb21haW5faW5pdGlhbF9kb3QiOiB0cnVlLCAicGF0aCI6ICIvIiwgInBhdGhfc3BlY2lmaWVkIjogdHJ1ZSwgInNlY3VyZSI6IHRydWUsICJleHBpcmVzIjogbnVsbCwgImRpc2NhcmQiOiB0cnVlLCAiY29tbWVudCI6IG51bGwsICJjb21tZW50X3VybCI6IG51bGwsICJyZmMyMTA5IjogZmFsc2UsICJyZXN0IjogeyJTYW1lU2l0ZSI6ICJOb25lIn19LCB7InZlcnNpb24iOiAwLCAibmFtZSI6ICJic2Nvb2tpZSIsICJ2YWx1ZSI6ICJcInY9MSYyMDIxMDYyMTA5MDc0MjYwZDBhODgwLWUyZWMtNDMzZS04NzY5LTRmOWIxZDIwZWI3NkFRSE94ekJsQWxvWnVSYzBySlVmNXJBQ2RWSnBaZmNLXCIiLCAicG9ydCI6IG51bGwsICJwb3J0X3NwZWNpZmllZCI6IGZhbHNlLCAiZG9tYWluIjogIi53d3cubGlua2VkaW4uY29tIiwgImRvbWFpbl9zcGVjaWZpZWQiOiB0cnVlLCAiZG9tYWluX2luaXRpYWxfZG90IjogdHJ1ZSwgInBhdGgiOiAiLyIsICJwYXRoX3NwZWNpZmllZCI6IHRydWUsICJzZWN1cmUiOiB0cnVlLCAiZXhwaXJlcyI6IDE2ODczODAzMTQsICJkaXNjYXJkIjogZmFsc2UsICJjb21tZW50IjogbnVsbCwgImNvbW1lbnRfdXJsIjogbnVsbCwgInJmYzIxMDkiOiBmYWxzZSwgInJlc3QiOiB7Ikh0dHBPbmx5IjogbnVsbCwgIlNhbWVTaXRlIjogIk5vbmUifX1dfQ\u0026search_id=4999584",
    "next_page_no": 1,
    "previous_page_api_url": null,
    "previous_page_no": null
}
Key Description Example
job List of Job See Job object
next_page_no 1
next_page_api_url "http://nubela.co/proxycurl-dev/proxycurl-dev/api/v2/linkedin/company/job?pagination=eyJwYWdlIjogMSwgImNvb2tpZXMiOiBbeyJ2ZXJzaW9uIjogMCwgIm5hbWUiOiAiYmNvb2tpZSIsICJ2YWx1ZSI6ICJcInY9MiYwNDMxY2I0YS0yZmI2LTQ5ZTUtOGYxMC01ZTQ2MDU0NGEyMTNcIiIsICJwb3J0IjogbnVsbCwgInBvcnRfc3BlY2lmaWVkIjogZmFsc2UsICJkb21haW4iOiAiLmxpbmtlZGluLmNvbSIsICJkb21haW5fc3BlY2lmaWVkIjogdHJ1ZSwgImRvbWFpbl9pbml0aWFsX2RvdCI6IHRydWUsICJwYXRoIjogIi8iLCAicGF0aF9zcGVjaWZpZWQiOiB0cnVlLCAic2VjdXJlIjogdHJ1ZSwgImV4cGlyZXMiOiAxNjg3MzgwMzE0LCAiZGlzY2FyZCI6IGZhbHNlLCAiY29tbWVudCI6IG51bGwsICJjb21tZW50X3VybCI6IG51bGwsICJyZmMyMTA5IjogZmFsc2UsICJyZXN0IjogeyJTYW1lU2l0ZSI6ICJOb25lIn19LCB7InZlcnNpb24iOiAwLCAibmFtZSI6ICJsYW5nIiwgInZhbHVlIjogInY9MiZsYW5nPWVuLXVzIiwgInBvcnQiOiBudWxsLCAicG9ydF9zcGVjaWZpZWQiOiBmYWxzZSwgImRvbWFpbiI6ICIubGlua2VkaW4uY29tIiwgImRvbWFpbl9zcGVjaWZpZWQiOiB0cnVlLCAiZG9tYWluX2luaXRpYWxfZG90IjogZmFsc2UsICJwYXRoIjogIi8iLCAicGF0aF9zcGVjaWZpZWQiOiB0cnVlLCAic2VjdXJlIjogdHJ1ZSwgImV4cGlyZXMiOiBudWxsLCAiZGlzY2FyZCI6IHRydWUsICJjb21tZW50IjogbnVsbCwgImNvbW1lbnRfdXJsIjogbnVsbCwgInJmYzIxMDkiOiBmYWxzZSwgInJlc3QiOiB7IlNhbWVTaXRlIjogIk5vbmUifX0sIHsidmVyc2lvbiI6IDAsICJuYW1lIjogImxpZGMiLCAidmFsdWUiOiAiXCJiPVZHU1QwNDpzPVY6cj1WOmE9VjpwPVY6Zz0yMzg1OnU9MTppPTE2MjQyNjY0NjI6dD0xNjI0MzUyODYyOnY9MjpzaWc9QVFFV0RfVlJ1NERoOHRBam5PY1NrNl9Rc2IzQkxjNTFcIiIsICJwb3J0IjogbnVsbCwgInBvcnRfc3BlY2lmaWVkIjogZmFsc2UsICJkb21haW4iOiAiLmxpbmtlZGluLmNvbSIsICJkb21haW5fc3BlY2lmaWVkIjogdHJ1ZSwgImRvbWFpbl9pbml0aWFsX2RvdCI6IHRydWUsICJwYXRoIjogIi8iLCAicGF0aF9zcGVjaWZpZWQiOiB0cnVlLCAic2VjdXJlIjogdHJ1ZSwgImV4cGlyZXMiOiAxNjI0MzUyODYyLCAiZGlzY2FyZCI6IGZhbHNlLCAiY29tbWVudCI6IG51bGwsICJjb21tZW50X3VybCI6IG51bGwsICJyZmMyMTA5IjogZmFsc2UsICJyZXN0IjogeyJTYW1lU2l0ZSI6ICJOb25lIn19LCB7InZlcnNpb24iOiAwLCAibmFtZSI6ICJKU0VTU0lPTklEIiwgInZhbHVlIjogImFqYXg6Mjc5OTYwNDI3NjIzMDA1NzY0NCIsICJwb3J0IjogbnVsbCwgInBvcnRfc3BlY2lmaWVkIjogZmFsc2UsICJkb21haW4iOiAiLnd3dy5saW5rZWRpbi5jb20iLCAiZG9tYWluX3NwZWNpZmllZCI6IHRydWUsICJkb21haW5faW5pdGlhbF9kb3QiOiB0cnVlLCAicGF0aCI6ICIvIiwgInBhdGhfc3BlY2lmaWVkIjogdHJ1ZSwgInNlY3VyZSI6IHRydWUsICJleHBpcmVzIjogbnVsbCwgImRpc2NhcmQiOiB0cnVlLCAiY29tbWVudCI6IG51bGwsICJjb21tZW50X3VybCI6IG51bGwsICJyZmMyMTA5IjogZmFsc2UsICJyZXN0IjogeyJTYW1lU2l0ZSI6ICJOb25lIn19LCB7InZlcnNpb24iOiAwLCAibmFtZSI6ICJic2Nvb2tpZSIsICJ2YWx1ZSI6ICJcInY9MSYyMDIxMDYyMTA5MDc0MjYwZDBhODgwLWUyZWMtNDMzZS04NzY5LTRmOWIxZDIwZWI3NkFRSE94ekJsQWxvWnVSYzBySlVmNXJBQ2RWSnBaZmNLXCIiLCAicG9ydCI6IG51bGwsICJwb3J0X3NwZWNpZmllZCI6IGZhbHNlLCAiZG9tYWluIjogIi53d3cubGlua2VkaW4uY29tIiwgImRvbWFpbl9zcGVjaWZpZWQiOiB0cnVlLCAiZG9tYWluX2luaXRpYWxfZG90IjogdHJ1ZSwgInBhdGgiOiAiLyIsICJwYXRoX3NwZWNpZmllZCI6IHRydWUsICJzZWN1cmUiOiB0cnVlLCAiZXhwaXJlcyI6IDE2ODczODAzMTQsICJkaXNjYXJkIjogZmFsc2UsICJjb21tZW50IjogbnVsbCwgImNvbW1lbnRfdXJsIjogbnVsbCwgInJmYzIxMDkiOiBmYWxzZSwgInJlc3QiOiB7Ikh0dHBPbmx5IjogbnVsbCwgIlNhbWVTaXRlIjogIk5vbmUifX1dfQ\u0026search_id=4999584"
previous_page_no null
previous_page_api_url null

Job

Key Description Example
company "Doctolib"
company_url "https://fr.linkedin.com/company/doctolib"
job_title "Product Trainer"
job_url "https://it.linkedin.com/jobs/view/product-trainer-at-doctolib-2590344814"
list_date "2021-06-12"
location "Milan, Lombardy, Italy"

Job Profile Endpoint

GET /proxycurl/api/linkedin/job

Cost: 1 credit / successful request.

Get structured data of a LinkedIn Job Profile

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    https://nubela.co/proxycurl/api/linkedin/job?url=https%3A%2F%2Fwww.linkedin.com%2Fjobs%2Fview%2F3046202003%2F
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/linkedin/job'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
params = {
    'url': 'https://www.linkedin.com/jobs/view/3046202003/',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
url yes URL of the LinkedIn Job Profile to target.

URL should be in the format of https://www.linkedin.com/jobs/view/<job_id>.
Jobs Listing Endpoint can be used to retrieve a job URL.
https://www.linkedin.com/jobs/view/3046202003/

Response

{
    "apply_url": "https://ph.linkedin.com/jobs/view/externalApply/2924094184?url=https%3A%2F%2Fgrab%2Ewd3%2Emyworkdayjobs%2Ecom%2Fen-US%2FCareers%2Fjob%2FManila-Exquadra-Tower%2FPartnerships-Marketing---Executive_R-2022-2-0313-1%3Fsource%3DLinkedIn\u0026urlHash=caow\u0026trk=public_jobs_apply-link-offsite",
    "company": {
        "logo": "https://media-exp1.licdn.com/dms/image/C510BAQGDlPEJILPXbw/company-logo_100_100/0/1586755776220?e=1655337600\u0026v=beta\u0026t=Vfs6bmQtJDAnrZMK0WpEQd7gdLzKBAoS23voIXbsqmU",
        "name": "Grab",
        "url": "https://sg.linkedin.com/company/grabapp"
    },
    "employment_type": null,
    "industry": [],
    "job_description": "Job Description:\n\nLife at Grab\n\nAt Grab, every Grabber is guided by The Grab Way, which spells out our mission, how we believe we can achieve it, and our operating principles - the 4Hs: Heart, Hunger, Honour and Humility. These principles guide and help us make decisions as we work to create economic empowerment for the people of Southeast Asia.\n\nGet to know the team\n\nThe Merchant and Partnerships Marketing team is a young team responsible for helping Country organization achieve its success by leveraging on the collective strength of our Merchants and Partners. We make an impact by helping our Merchants and Partners find success within the Grab Platform, in a way that is sustainable and equally rewarding for Grab. Our team is made up of young, intelligent, energized and inspired leaders who are committed to bringing the Grab vision to life. If you are looking for an opportunity to showcase your best self as you grow into a more seasoned marketer within the tech space, then you should join our team!\n\nGet to know the role\n\nWe are looking for a Partnerships Marketing Executive to lead the development, coordination, and execution of strategic partnership marketing campaigns that are aligned with company-wide objectives, as well as do campaign performance tracking and research. You will work on developing campaign proposals to drive brand recognition, unlock partnership values, and/or generate incremental demand across Grab\u2019s various services. You will have to collaborate with multiple functions within the marketing team (e.g. Creatives, Public Relations, Performance, Social, and Product teams) and with Country Operations and Business Development teams, and be comfortable negotiating and presenting to marketing leads of Grab\u2019s Corporate Partners and Prospective Brand Partners. We believe a successful candidate has leadership potential and is a self-motivated, resourceful and solutions-oriented individual who can perform under pressure in a dynamic, fast-paced environment; but if you believe you have what it takes then we\u2019d love to hear from you either way. This role is required because we are looking more into Partnerships Marketing to help deliver business growth. In return, you will get an opportunity to work in Southeast Asia\u2019s largest mobile technology company, in a role that is evolving in importance, setting you up to more opportunities within Grab, and solidifying your career experience in Marketing within the Tech space.\n\nThe Day-to-Day Activities\nYou lead the Ideation, pitching, and execution of brand partnership marketing campaigns in collaboration with the Business Development team.You drive end-to-end marketing campaign management: from brief writing, timeline planning, development of campaign in collaboration with other internal teams (ex. Creative, Social, PR, etc) to campaign performance trackingYou will develop and optimize partnership ROI models and segmentation of partnership opportunities.You will drive development of partnership opportunities with business needs (ex. identifying and pitching partner brands to support a Grab campaign).You are responsible for total Marketing needs of Country Business Development.You are accountable for the growth of Total Relationship Value with Business Development partners.You support Vertical growth and achievement of Country Business Development goals.You make an impact by showing leadership and ownership when driving marketing discussions and negotiations with key partners.\nThe Must-HavesYou have Heart, Hunger, Honour and HumilityResourceful with a problem-solving mind: Able to find creative solutions to roadblocks, navigate complexities, influence and persuade feedback/approval to get things moving.Relentlessly driven and seeks challenges: Willingness to drive growth and able to embrace and tackle challenges.You have meaningful experience with managing integrated marketing communications that involve several brands working together.You are experienced in planning an end-to-end marketing campaign: from brief writing, timeline planning, providing clear feedback to creatives, collaborating with other teams (PR, Media, Product, Legal) to campaign performance tracking.You are highly organized, detailed and meticulous: Enjoys improving processes to achieve day-to-day efficiency. Sound time management skills to tackle both urgent short-term tasks and important long-term tasks within compressed timeframes in a deadline-driven organization. Thrives in an ultrafast-paced tech/digitally-inclined environment. Quite the perfectionist.You showcase a can-do attitude: able to follow through with the end-to-end execution and optimization of the campaigns that you are leading, and to adapt to obstacles / changes you might encounter.You have strong working knowledge of brand partnerships, digital marketing and digital activations.\nThe Nice-to-Haves\nExperience in Client management from a wide range of industries, especially among FMCG, tech and telco brands.Experience in driving retail sales, online or offlineYou can derive insights from analysis of Sales data and other relevant retail metrics\nOur Commitment\n\nWe are committed to building diverse teams and creating an inclusive workplace that enables all Grabbers to perform at their best, regardless of nationality, ethnicity, religion, age, gender identity or sexual orientation and other attributes that make each Grabber unique.\n\nAbout Grab\n\nGrab is the leading superapp platform in Southeast Asia, providing everyday services that matter to consumers. Today, the Grab app has been downloaded onto millions of mobile devices, giving users access to over 9 million drivers, merchants, and agents. Grab offers a wide range of on-demand services in the region, including mobility, food, package and grocery delivery services, mobile payments, and financial services across 428 cities in eight countries.\n\nJoin us today to drive Southeast Asia forward, together.",
    "job_functions": [],
    "linkedin_internal_id": "2924094184",
    "location": {
        "city": "Manila",
        "country": "PH",
        "latitude": 14.582259,
        "longitude": 120.9748,
        "postal_code": null,
        "region": null,
        "street": null
    },
    "seniority_level": null,
    "title": "Partnerships Marketing - Executive",
    "total_applicants": 88
}
Key Description Example
linkedin_internal_id "2924094184"
job_description "Job Description:\n\nLife at Grab\n\nAt Grab, every Grabber is guided by The Grab Way, which spells out our mission, how we believe we can achieve it, and our operating principles - the 4Hs: Heart, Hunger, Honour and Humility. These principles guide and help us make decisions as we work to create economic empowerment for the people of Southeast Asia.\n\nGet to know the team\n\nThe Merchant and Partnerships Marketing team is a young team responsible for helping Country organization achieve its success by leveraging on the collective strength of our Merchants and Partners. We make an impact by helping our Merchants and Partners find success within the Grab Platform, in a way that is sustainable and equally rewarding for Grab. Our team is made up of young, intelligent, energized and inspired leaders who are committed to bringing the Grab vision to life. If you are looking for an opportunity to showcase your best self as you grow into a more seasoned marketer within the tech space, then you should join our team!\n\nGet to know the role\n\nWe are looking for a Partnerships Marketing Executive to lead the development, coordination, and execution of strategic partnership marketing campaigns that are aligned with company-wide objectives, as well as do campaign performance tracking and research. You will work on developing campaign proposals to drive brand recognition, unlock partnership values, and/or generate incremental demand across Grab\u2019s various services. You will have to collaborate with multiple functions within the marketing team (e.g. Creatives, Public Relations, Performance, Social, and Product teams) and with Country Operations and Business Development teams, and be comfortable negotiating and presenting to marketing leads of Grab\u2019s Corporate Partners and Prospective Brand Partners. We believe a successful candidate has leadership potential and is a self-motivated, resourceful and solutions-oriented individual who can perform under pressure in a dynamic, fast-paced environment; but if you believe you have what it takes then we\u2019d love to hear from you either way. This role is required because we are looking more into Partnerships Marketing to help deliver business growth. In return, you will get an opportunity to work in Southeast Asia\u2019s largest mobile technology company, in a role that is evolving in importance, setting you up to more opportunities within Grab, and solidifying your career experience in Marketing within the Tech space.\n\nThe Day-to-Day Activities\nYou lead the Ideation, pitching, and execution of brand partnership marketing campaigns in collaboration with the Business Development team.You drive end-to-end marketing campaign management: from brief writing, timeline planning, development of campaign in collaboration with other internal teams (ex. Creative, Social, PR, etc) to campaign performance trackingYou will develop and optimize partnership ROI models and segmentation of partnership opportunities.You will drive development of partnership opportunities with business needs (ex. identifying and pitching partner brands to support a Grab campaign).You are responsible for total Marketing needs of Country Business Development.You are accountable for the growth of Total Relationship Value with Business Development partners.You support Vertical growth and achievement of Country Business Development goals.You make an impact by showing leadership and ownership when driving marketing discussions and negotiations with key partners.\nThe Must-HavesYou have Heart, Hunger, Honour and HumilityResourceful with a problem-solving mind: Able to find creative solutions to roadblocks, navigate complexities, influence and persuade feedback/approval to get things moving.Relentlessly driven and seeks challenges: Willingness to drive growth and able to embrace and tackle challenges.You have meaningful experience with managing integrated marketing communications that involve several brands working together.You are experienced in planning an end-to-end marketing campaign: from brief writing, timeline planning, providing clear feedback to creatives, collaborating with other teams (PR, Media, Product, Legal) to campaign performance tracking.You are highly organized, detailed and meticulous: Enjoys improving processes to achieve day-to-day efficiency. Sound time management skills to tackle both urgent short-term tasks and important long-term tasks within compressed timeframes in a deadline-driven organization. Thrives in an ultrafast-paced tech/digitally-inclined environment. Quite the perfectionist.You showcase a can-do attitude: able to follow through with the end-to-end execution and optimization of the campaigns that you are leading, and to adapt to obstacles / changes you might encounter.You have strong working knowledge of brand partnerships, digital marketing and digital activations.\nThe Nice-to-Haves\nExperience in Client management from a wide range of industries, especially among FMCG, tech and telco brands.Experience in driving retail sales, online or offlineYou can derive insights from analysis of Sales data and other relevant retail metrics\nOur Commitment\n\nWe are committed to building diverse teams and creating an inclusive workplace that enables all Grabbers to perform at their best, regardless of nationality, ethnicity, religion, age, gender identity or sexual orientation and other attributes that make each Grabber unique.\n\nAbout Grab\n\nGrab is the leading superapp platform in Southeast Asia, providing everyday services that matter to consumers. Today, the Grab app has been downloaded onto millions of mobile devices, giving users access to over 9 million drivers, merchants, and agents. Grab offers a wide range of on-demand services in the region, including mobility, food, package and grocery delivery services, mobile payments, and financial services across 428 cities in eight countries.\n\nJoin us today to drive Southeast Asia forward, together."
apply_url "https://ph.linkedin.com/jobs/view/externalApply/2924094184?url=https%3A%2F%2Fgrab%2Ewd3%2Emyworkdayjobs%2Ecom%2Fen-US%2FCareers%2Fjob%2FManila-Exquadra-Tower%2FPartnerships-Marketing---Executive_R-2022-2-0313-1%3Fsource%3DLinkedIn\u0026urlHash=caow\u0026trk=public_jobs_apply-link-offsite"
title "Partnerships Marketing - Executive"
location {"city": "Manila", "country": "PH", "latitude": 14.582259, "longitude": 120.9748, "postal_code": null, "region": null, "street": null}
company {"logo": "https://media-exp1.licdn.com/dms/image/C510BAQGDlPEJILPXbw/company-logo_100_100/0/1586755776220?e=1655337600\u0026v=beta\u0026t=Vfs6bmQtJDAnrZMK0WpEQd7gdLzKBAoS23voIXbsqmU", "name": "Grab", "url": "https://sg.linkedin.com/company/grabapp"}
seniority_level null
industry []
employment_type null
job_functions []
total_applicants 88

People API

Person Lookup Endpoint

GET /proxycurl/api/linkedin/profile/resolve

Cost: 2 credits / successful request.

Resolve LinkedIn Profile

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    https://nubela.co/proxycurl/api/linkedin/profile/resolve?company_domain=gatesfoundation.org&location=Singapore&title=Co-chair&last_name=Gates&first_name=Bill
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/linkedin/profile/resolve'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
params = {
    'company_domain': 'gatesfoundation.org',
    'location': 'Singapore',
    'title': 'Co-chair',
    'last_name': 'Gates',
    'first_name': 'Bill',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
company_domain yes Company name or domain gatesfoundation.org
location no The location of this user.

Name of country, city or state.
Singapore
title no Title that user is holding at his/her current job Co-chair
last_name no Last name of the user Gates
first_name yes First name of the user Bill

Response

{
    "url": "https://www.linkedin.com/in/williamhgates"
}
Key Description Example
url "https://www.linkedin.com/in/williamhgates"

Remarks

The accuracy of the linkedin profile returned is on a best-effort basis. Results are not guaranteed to be accurate. We are always improving on the accuracy of these endpoints iteratively.

Role Lookup Endpoint

GET /proxycurl/api/find/company/role

Cost: 3 credits / successful request.

Finds the closest (person) profile with a given role in a Company. For example, you can use this endpoint to find the "CTO" of "Apple".

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    https://nubela.co/proxycurl/api/find/company/role?role=ceo&company_name=nubela
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/find/company/role'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
params = {
    'role': 'ceo',
    'company_name': 'nubela',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
role yes Role of the profile that you are lookin up ceo
company_name yes Name of the company that you are searching for nubela

Response

{
    "linkedin_profile_url": "https://sg.linkedin.com/in/steven-goh-6738131b"
}
Key Description Example
linkedin_profile_url LinkedIn Profile URL of the person that most closely matches the role "https://sg.linkedin.com/in/steven-goh-6738131b"

Person Profile Endpoint

GET /proxycurl/api/v2/linkedin

Cost: 1 credit / successful request.

Get structured data of a Personal Profile

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    https://nubela.co/proxycurl/api/v2/linkedin?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fjohnrmarty%2F&use_cache=if-present&skills=include&inferred_salary=include&personal_email=include&personal_contact_number=include&twitter_profile_id=include&facebook_profile_id=include&github_profile_id=include&extra=include
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/v2/linkedin'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
params = {
    'url': 'https://www.linkedin.com/in/johnrmarty/',
    'use_cache': 'if-present',
    'skills': 'include',
    'inferred_salary': 'include',
    'personal_email': 'include',
    'personal_contact_number': 'include',
    'twitter_profile_id': 'include',
    'facebook_profile_id': 'include',
    'github_profile_id': 'include',
    'extra': 'include',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
url yes URL of the LinkedIn Profile to crawl.

URL should be in the format of https://www.linkedin.com/in/<public-identifier>
https://www.linkedin.com/in/johnrmarty/
use_cache no if-present Fetches profile from cache regardless of age of profile. If profile is not available in cache, API will attempt to source profile externally.

if-recent The default behavior. API will make a best effort to return a fresh profile no older than 29 days.
if-present
skills no Include skills data from external sources.

This parameter accepts the following values:
- exclude (default value) - Does not provide skills data field.
- include - Append skills data to the person profile object. Costs an extra 1 credit on top of the cost of the base endpoint (if data is available).
include
inferred_salary no Include inferred salary range from external sources.

This parameter accepts the following values:
- exclude (default value) - Does not provide inferred salary data field.
- include - Append inferred salary range data to the person profile object. Costs an extra 1 credit on top of the cost of the base endpoint (if data is available).
include
personal_email no Enriches the Person Profile with personal emails from external sources.

This parameter accepts the following values:
- exclude (default value) - Does not provide personal emails data field.
- include - Append personal emails data to the person profile object. Costs an extra 1 credit per email returned on top of the cost of the base endpoint (if data is available).
include
personal_contact_number no Enriches the Person Profile with personal numbers from external sources.

This parameter accepts the following values:
- exclude (default value) - Does not provide personal numbers data field.
- include - Append personal numbers data to the person profile object. Costs an extra 1 credit per email returned on top of the cost of the base endpoint (if data is available).
include
twitter_profile_id no Enriches the Person Profile with Twitter Id from external sources.

This parameter accepts the following values:
- exclude (default value) - Does not provide Twitter Id data field.
- include - Append Twitter Id data to the person profile object. Costs an extra 1 credit on top of the cost of the base endpoint (if data is available).
include
facebook_profile_id no Enriches the Person Profile with Facebook Id from external sources.

This parameter accepts the following values:
- exclude (default value) - Does not provide Facebook Id data field.
- include - Append Facebook Id data to the person profile object. Costs an extra 1 credit on top of the cost of the base endpoint (if data is available).
include
github_profile_id no Enriches the Person Profile with Github Id from external sources.

This parameter accepts the following values:
- exclude (default value) - Does not provide Github Id data field.
- include - Append Github Id data to the person profile object. Costs an extra 1 credit on top of the cost of the base endpoint (if data is available).
include
extra no Enriches the Person Profile with extra details from external sources. Extra details include gender, birth date, industry and interests.

This parameter accepts the following values:
- exclude (default value) - Does not provide extra data field.
- include - Append extra data to the person profile object. Costs an extra 1 credit on top of the cost of the base endpoint (if data is available).
include

Response

{
    "accomplishment_courses": [],
    "accomplishment_honors_awards": [],
    "accomplishment_organisations": [],
    "accomplishment_patents": [],
    "accomplishment_projects": [
        {
            "description": "gMessenger was built using Ruby on Rails, and the Bootstrap HTML, CSS, and JavaScript framework. It uses a Websocket-Rails integration to post a user\u0027s message content to the page in real time, with no page refresh required. gMessenger also includes custom authentication with three different permissions levels.",
            "ends_at": null,
            "starts_at": {
                "day": 1,
                "month": 3,
                "year": 2015
            },
            "title": "gMessenger",
            "url": "http://gmessenger.herokuapp.com/"
        },
        {
            "description": "A task and project management responsive web app utilizing Ruby on Rails - CSS and HTML",
            "ends_at": null,
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2015
            },
            "title": "Taskly",
            "url": "https://hidden-coast-7204.herokuapp.com/"
        },
        {
            "description": "Injection molded residential and commercial wall mounts for iPads and iPods. This stylish flush wall mounted solution is meant to be used in conjunction with any Home Automation System.",
            "ends_at": null,
            "starts_at": {
                "day": 1,
                "month": 5,
                "year": 2013
            },
            "title": "Simple Wall Mount",
            "url": "http://www.simplewallmount.com"
        },
        {
            "description": "Overwatch Safety Systems is developing an advanced warning and information distribution system to assist law enforcement and first responders with active shooter situations in public and private venues. The system utilizes modern sonic detection algorithms to sense and announce the position of active threats to people and property. This technology is also being designed as a hi-tech electronic deterrent for high profile or vulnerable venues.",
            "ends_at": null,
            "starts_at": null,
            "title": "Overwatch Safety Systems",
            "url": null
        }
    ],
    "accomplishment_publications": [],
    "accomplishment_test_scores": [],
    "activities": [
        {
            "activity_status": "Posted by John Marty",
            "link": "https://www.linkedin.com/posts/johnrmarty_honest-conversations-i-wish-i-could-have-share-6925074748875960320-e48_",
            "title": "Honest conversations I wish I could have had during salary negations for any new job when I was in corporate: Me: Thank you for the written offer\u2026"
        },
        {
            "activity_status": "Liked by John Marty",
            "link": "https://www.linkedin.com/posts/ara-feinstein-620466160_overheard-in-the-or-can-i-get-a-share-6924383713443155969-nr91",
            "title": "\ud83e\udd7c\ud83e\uddb4\ud83d\udc36OVERHEARD IN THE O.R.: CAN I GET A TREAT??? \ud83d\udc36\ud83e\uddb4\ud83e\udd7c Me: \"This part of the case is so awesome. It\u0027s painful to watch you do this without just\u2026"
        },
        {
            "activity_status": "Liked by John Marty",
            "link": "https://www.linkedin.com/posts/heather-austin_do-you-struggle-with-not-having-a-fully-optimized-share-6923007129708630016-PEsD",
            "title": "Do you struggle with not having a fully optimized LinkedIn profile? What about not knowing how to use LinkedIn to develop stronger relationships? \ud83d\ude15\u2026"
        }
    ],
    "articles": [],
    "background_cover_image_url": "https://media-exp1.licdn.com/dms/image/C5616AQH9tkBTUhHfng/profile-displaybackgroundimage-shrink_200_800/0/1614530499015?e=2147483647\u0026v=beta\u0026t=VEoCyedtZulnAVYWT9BXfKHi5OFp8avElNjiz8kjSTU",
    "birth_date": null,
    "certifications": [
        {
            "authority": "Scaled Agile, Inc.",
            "display_source": null,
            "ends_at": null,
            "license_number": null,
            "name": "SAFe Agile Framework Practitioner - ( Scrum, XP, and Lean Practices in the SAFe Enterprise)",
            "starts_at": null,
            "url": null
        },
        {
            "authority": "Scrum Alliance",
            "display_source": null,
            "ends_at": null,
            "license_number": null,
            "name": "SCRUM Alliance Certified Product Owner",
            "starts_at": null,
            "url": null
        },
        {
            "authority": "Scaled Agile, Inc.",
            "display_source": null,
            "ends_at": null,
            "license_number": null,
            "name": "Scaled Agile Framework PM/PO",
            "starts_at": null,
            "url": null
        }
    ],
    "city": "Seattle",
    "connections": 500,
    "country": "US",
    "country_full_name": "United States of America",
    "education": [
        {
            "degree_name": "Master of Business Administration (MBA)",
            "description": null,
            "ends_at": {
                "day": 31,
                "month": 12,
                "year": 2015
            },
            "field_of_study": "Finance + Economics",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQGbanOkHdRLiQ/company-logo_100_100/0/1600382740152?e=2147483647\u0026v=beta\u0026t=GDDMz5Zb_4glJ94GLP2N_l-JHFdSnrDkF95FesngJdA",
            "school": "University of Colorado Denver",
            "school_linkedin_profile_url": "https://www.linkedin.com/school/university-of-colorado-denver/",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2013
            }
        },
        {
            "degree_name": "School of Software Development",
            "description": "rails, ruby, rspec, capybara, bootstrap, css, html, api integration, Jquery, Javascript",
            "ends_at": {
                "day": 31,
                "month": 12,
                "year": 2015
            },
            "field_of_study": null,
            "logo_url": "https://media-exp1.licdn.com/dms/image/C4E0BAQG1D1RHEvbQZQ/company-logo_100_100/0/1519872735270?e=2147483647\u0026v=beta\u0026t=ww_R6rRsCb2M_xkEta5ynMn6VxkUt1XwOhVEtLZXSfA",
            "school": "Galvanize Inc",
            "school_linkedin_profile_url": "https://www.linkedin.com/school/galvanize-it/",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2015
            }
        },
        {
            "degree_name": "BA",
            "description": null,
            "ends_at": {
                "day": 31,
                "month": 12,
                "year": 2005
            },
            "field_of_study": "Business",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C4D0BAQGs5hZ3ROf-iw/company-logo_100_100/0/1519856111543?e=2147483647\u0026v=beta\u0026t=62k4mEoRdeQf4C6AF12Z05_t6i1VgNk50jr7RHkEsf8",
            "school": "Fort Lewis College",
            "school_linkedin_profile_url": "https://www.linkedin.com/school/fort-lewis-college/",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 1999
            }
        },
        {
            "degree_name": "Japanese Language and Literature",
            "description": null,
            "ends_at": {
                "day": 31,
                "month": 12,
                "year": 2002
            },
            "field_of_study": null,
            "logo_url": null,
            "school": "Yamasa Institute Okazaki Japan",
            "school_linkedin_profile_url": null,
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2002
            }
        },
        {
            "degree_name": "Spanish Language and Literature",
            "description": null,
            "ends_at": {
                "day": 31,
                "month": 12,
                "year": 2000
            },
            "field_of_study": null,
            "logo_url": null,
            "school": "Inter American University of Puerto Rico",
            "school_linkedin_profile_url": "https://www.linkedin.com/school/inter-american-university-of-puerto-rico/",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2000
            }
        },
        {
            "degree_name": "High School",
            "description": null,
            "ends_at": {
                "day": 31,
                "month": 12,
                "year": 1999
            },
            "field_of_study": null,
            "logo_url": null,
            "school": "Western Reserve Academy",
            "school_linkedin_profile_url": null,
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 1996
            }
        }
    ],
    "experiences": [
        {
            "company": "Freedom Fund Real Estate",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/freedomfund",
            "description": "Our mission is to provide everyday people seeking financial freedom long before the age of 65 with the ability to invest in high yield, short-term real estate investments that were only accessible in the past for a select few wealthy individuals. Each of our single family rehab projects require a minimum investment contribution of only $10K, we have simple terms, no multi-year hold periods, and no fees. With our unique model investors can log into our easy to use website, select the projects that they want to invest in, and get realtime updates on the status of their investments.\n\nWebsite: https://www.freedomfundinvestments.com/home",
            "ends_at": null,
            "location": null,
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQEYxazZM_hXgQ/company-logo_100_100/0/1634934418976?e=2147483647\u0026v=beta\u0026t=wI0YdMmxIctkzvnKxRfuAbT8h5eok_DlUqEph68J37s",
            "starts_at": {
                "day": 1,
                "month": 8,
                "year": 2021
            },
            "title": "Co-Founder"
        },
        {
            "company": "Mindset Reset Podcast",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/mindset-reset-podcast",
            "description": "We dive into the mindsets of the world\u2019s foremost thought leaders and turn them into actionable insights so that others can discover greater happiness, success, and fulfillment.\n\nhttps://podcasts.apple.com/us/podcast/mindset-reset/id1553212607",
            "ends_at": null,
            "location": "Denver, Colorado, United States",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQF9QJVQm3SOvA/company-logo_100_100/0/1614527476576?e=2147483647\u0026v=beta\u0026t=m3tx83nMN-E3XQFoJG0Wmch8U4qKnJ9i--5NSAfffC0",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2021
            },
            "title": "Founder"
        },
        {
            "company": "Product School",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/product-school",
            "description": "Product School is a global leader in Product Management training with a community of over one million product professionals. As a featured speaker, I help inspire the next generation of Product Managers to create innovative products and apply best practices in their work.",
            "ends_at": {
                "day": 31,
                "month": 12,
                "year": 2020
            },
            "location": "Seattle, Washington, United States",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C4E0BAQFZfSlbfUe9yA/company-logo_100_100/0/1648642857246?e=2147483647\u0026v=beta\u0026t=IlML7yVPdwyH9BOKnvQjRNuIuY39qk6muYQ0uCDRt8o",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2020
            },
            "title": "Featured Speaker"
        },
        {
            "company": "Project 1B",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/project-1b",
            "description": "The mission of Project 1B is to help 1 Billion people around the world maximize their sense of meaning so that they can lead more fulfilling lives. We do this through exposing the truth about success and happiness through the Mindset Reset Podcast, corporate training, youth education programs, group coaching, and investments in tech startups aligned with our mission.\n\nThe word success is widely understood as the attainment of financial gain, but somewhere along the lines we began believing that money = happiness, self worth, and meaning even though money has nothing to do with these things. Because of this twisted equation, young adults often make career decisions that solely maximize earning potential. And Ironically, if they manage to achieve society\u2019s definition of success, It often leaves many with a sense of meaninglessness.\n\nIf you want to live a meaningful life chase the word meaning as opposed to the word success - this simple shift in mindset will lead to a more authentic set of questions about the direction you should take your life.",
            "ends_at": null,
            "location": "Denver, Colorado, United States",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQFG_MrwBC_iZg/company-logo_100_100/0/1594610187483?e=2147483647\u0026v=beta\u0026t=7NNWG1ZclbNsUW0k0PuD-v5xTmfpIcthOmHCDyMwWMk",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2020
            },
            "title": "Founder"
        },
        {
            "company": "Amazon",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/amazon",
            "description": null,
            "ends_at": {
                "day": 31,
                "month": 3,
                "year": 2021
            },
            "location": "Greater Seattle Area",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQHTvZwCx4p2Qg/company-logo_100_100/0/1612205615891?e=2147483647\u0026v=beta\u0026t=PG9v_TmuSDxc9nAjnwxAFTWfFwhri5iJcJ4bcODhtPA",
            "starts_at": {
                "day": 1,
                "month": 2,
                "year": 2019
            },
            "title": "Sr. Product Manager - New Business Innovation"
        },
        {
            "company": "Amazon",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/amazon",
            "description": null,
            "ends_at": {
                "day": 28,
                "month": 2,
                "year": 2019
            },
            "location": "Seattle, Washington, United States",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQHTvZwCx4p2Qg/company-logo_100_100/0/1612205615891?e=2147483647\u0026v=beta\u0026t=PG9v_TmuSDxc9nAjnwxAFTWfFwhri5iJcJ4bcODhtPA",
            "starts_at": {
                "day": 1,
                "month": 3,
                "year": 2017
            },
            "title": "Senior Manager of Product Management - Marketplace Product Quality"
        },
        {
            "company": "YouTube",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/youtube",
            "description": "Mission: to help others land their dream jobs at a top tech companies that aligns with their passions.",
            "ends_at": null,
            "location": "Greater Seattle Area",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C4D0BAQEfoRsyU4yUzg/company-logo_100_100/0/1631053379295?e=2147483647\u0026v=beta\u0026t=CmnUj5LeO5Yi-nA9xLgEYBPU5eZdLrPBG2qXmPhhoe4",
            "starts_at": {
                "day": 1,
                "month": 2,
                "year": 2019
            },
            "title": "YouTube Content Creator - \"Tech Careers for Non-Engineers\""
        },
        {
            "company": "YouTube",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/youtube",
            "description": null,
            "ends_at": null,
            "location": "Seattle, Washington",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C4D0BAQEfoRsyU4yUzg/company-logo_100_100/0/1631053379295?e=2147483647\u0026v=beta\u0026t=CmnUj5LeO5Yi-nA9xLgEYBPU5eZdLrPBG2qXmPhhoe4",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2017
            },
            "title": "Youtube Content Creator - \"John Marty\""
        },
        {
            "company": "American Express",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/american-express",
            "description": null,
            "ends_at": {
                "day": 31,
                "month": 3,
                "year": 2017
            },
            "location": "Phoenix, Arizona Area",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C4D0BAQGRhsociEn4gQ/company-logo_100_100/0/1523269243842?e=2147483647\u0026v=beta\u0026t=SHRbiG3uqsCTfE1Gyd77tgJWtHAm4cYp-c6uILKTVNs",
            "starts_at": {
                "day": 1,
                "month": 7,
                "year": 2015
            },
            "title": "Senior Global Product Manager"
        },
        {
            "company": "Mile High Automation, Inc.",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/mile-high-automation-inc-",
            "description": "Mile High Automation is a Smart Home Technology (Internet of Things) software and hardware development company. Our mission is to flawlessly develop and deliver impeccable software, hardware and system design for the high-end consumer market nationally and internationally. \n\n\u2022  Performed a short term change management engagement to lead a 12 member cross functional team through a major strategy and vision transition\n\u2022  Developed an international supply chain that increased profit margin by 30% on core products\n\u2022  Conceptualized, implemented, and rolled out a CRM that led to a 15% higher month over month close rate; trained sales team on newly created key performance indicators to maximize growth\n\u2022  Developed, implemented and oversaw a training process that scaled to 180+ national subcontractors\n\u2022  Translated user stories into detailed product requirements documents that the software development team used to build new features and functionality \n\u2022  Developed benchmarks for customer service, sales, and traffic conversion to maximize profit",
            "ends_at": {
                "day": 31,
                "month": 7,
                "year": 2014
            },
            "location": "Denver Colorado",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C4E0BAQHofg3toK4P7A/company-logo_100_100/0/1519903210468?e=2147483647\u0026v=beta\u0026t=vasirOnrmfFkQru9S8JBNtci00COt_s9x2AOexxqd-8",
            "starts_at": {
                "day": 1,
                "month": 3,
                "year": 2014
            },
            "title": "Sr. Product Manager"
        },
        {
            "company": "EOS Controls",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/eos-controls",
            "description": "A Smart Home Technology (Internet of Things) software and hardware development company specializing in the mid to high-end condominium market in the United States and South America. \nEOS Controls supports the advancement of affordable and easy to user smart home technology through a network of non-traditional sales channels of architects, designers, and contractors. \n\n\u2022  Coordinated engineering, design, and marketing strategy for the launch of 6 iOS apps\n\u2022  Led a 5 member product team of engineers; conducted daily stand-ups and weekly design review meetings\n\u2022  Managed and prioritized product backlog for development Sprints as well as tested products before release\n\u2022  Effectively placed products through non-traditional distribution channels by identifying and developing relationships with over 100 national and international builders, architects, and designers",
            "ends_at": {
                "day": 31,
                "month": 5,
                "year": 2014
            },
            "location": "Miami, Florida",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQFV1hvbuwyU-A/company-logo_100_100/0/1519867781218?e=2147483647\u0026v=beta\u0026t=s5UGQj-N-5VatokXj3YN6IxOPmKpUZeetC5OZH-B-xU",
            "starts_at": {
                "day": 1,
                "month": 2,
                "year": 2012
            },
            "title": "Founder/ Chief Operating Officer"
        },
        {
            "company": "Axxis Audio",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/axxis-audio",
            "description": "Specializing in Smart Home Technology - Home Automation, Internet of Things\n\n\u2022  Raised $10,000 in investment to develop a home theater and home automation sales and installation business that grew to multi-million dollar sales (sold the company in 2011)\n\u2022  Developed mission-centric training, responsibility, and accountability framework \n\u2022  10 Direct Reports\n\u2022  Responsible for resource planning, scheduling, and project management \n\u2022  Filled the role of HR and developed a team building program for 10 direct reports, that included formal training, personal and professional peer support, mentoring and professional development; resulting in 20% higher retention rate and improved trust and communication\n\u2022  Deployed an ERP Solution in 2007 that unified 5 departments and provided a central reporting and accountability framework for a 23% employees productivity gain\n\u2022  Handled acquisition of 2nd largest competitor Cobalt Automation",
            "ends_at": {
                "day": 31,
                "month": 1,
                "year": 2012
            },
            "location": "Durango Colorado",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQHI-DLifzJs9Q/company-logo_100_100/0/1519868629336?e=2147483647\u0026v=beta\u0026t=l1Sk5NQO2Mtpo7HpppRkMhogjVXCwx5yxIxhcwUpNuc",
            "starts_at": {
                "day": 1,
                "month": 11,
                "year": 2002
            },
            "title": "President/Founder"
        }
    ],
    "extra": {
        "facebook_profile_id": null,
        "github_profile_id": null,
        "twitter_profile_id": null
    },
    "first_name": "John",
    "full_name": "John Marty",
    "gender": null,
    "groups": [
        {
            "name": "Find Your Why (webinar follow-up)",
            "profile_pic_url": "https://media-exp1.licdn.com/dms/image/C4E07AQF2EKTooicxbg/group-logo_image-shrink_92x92/0/1631006354581?e=2147483647\u0026v=beta\u0026t=MghKnD-DdMBp7z9807LXUA7vueLDr1OJ0A3PbkSSG0g",
            "url": "https://www.linkedin.com/groups/12431669"
        },
        {
            "name": "Harvard Business Review Discussion Group",
            "profile_pic_url": "https://media-exp1.licdn.com/dms/image/C5607AQFoObVGhIVOMw/group-logo_image-shrink_92x92/0/1631009516456?e=2147483647\u0026v=beta\u0026t=7g5B1odI-AL9ixvziIAliPsaUPOsha-cnLjrYRv46nI",
            "url": "https://www.linkedin.com/groups/3044917"
        },
        {
            "name": "Local Seattle Connections",
            "profile_pic_url": "https://media-exp1.licdn.com/dms/image/C5607AQEF-0lU7YuvFw/group-logo_image-shrink_92x92/0/1631011968285?e=2147483647\u0026v=beta\u0026t=TeNaGmANBvpFRcvUFbWJRDjFGfQJFkqawDPL7BcwTo0",
            "url": "https://www.linkedin.com/groups/13612052"
        },
        {
            "name": "On Startups - The Community For Entrepreneurs",
            "profile_pic_url": "https://media-exp1.licdn.com/dms/image/C4E07AQEpOgpQbQSzlw/group-logo_image-shrink_92x92/0/1631005705998?e=2147483647\u0026v=beta\u0026t=YEVppNyjLKAt0mnKBMIDQ7hYdx9VAOrJAqBkl1wm574",
            "url": "https://www.linkedin.com/groups/2877"
        },
        {
            "name": "University of Colorado Executive MBA Program Alumni (official)",
            "profile_pic_url": "https://static-exp1.licdn.com/sc/h/4h1ldzvvebtszyx75ve7dst1v",
            "url": "https://www.linkedin.com/groups/981"
        }
    ],
    "headline": "Financial Freedom through Real Estate - LinkedIn Top Voice",
    "industry": null,
    "inferred_salary": {
        "max": null,
        "min": null
    },
    "interests": [],
    "languages": [
        "English",
        "Spanish",
        "Japanese"
    ],
    "last_name": "Marty",
    "occupation": "Co-Founder at Freedom Fund Real Estate",
    "people_also_viewed": [
        {
            "link": "https://in.linkedin.com/in/warikoo",
            "location": "India",
            "name": "Ankur Warikoo",
            "summary": "Founder nearbuy.com, Mentor, Angel Investor, Public Speaker"
        },
        {
            "link": "https://www.linkedin.com/in/hollylee",
            "location": "Seattle, WA",
            "name": "Holly Lee, SPCC (She/Her)",
            "summary": "Ex-Amazon Recruiting Leader | Leadership Career Coach | Forbes Coaches Council | \u279b hollylee.co/interview-coaching"
        },
        {
            "link": "https://www.linkedin.com/in/renoperry",
            "location": "Greater Chicago Area",
            "name": "Reno Perry",
            "summary": "[Out of Office] Follow for Job Search Advice Used by the Top 1% | Founder @ Wiseful | Helping People Land Top Jobs in Tech | Feat. NBC, Business Insider, LinkedIn News, protocol"
        },
        {
            "link": "https://www.linkedin.com/in/livelyliz",
            "location": "Greater Seattle Area",
            "name": "Elizabeth Morgan",
            "summary": "Career Content - 23M views | Amazon | Social Media Expert | Handmade Earring Etsy Shop Owner \u0027Lively Liz Creations\u0027| Ex-Google Recruiting"
        },
        {
            "link": "https://www.linkedin.com/in/jonathan-wonsulting",
            "location": "Los Angeles, CA",
            "name": "Jonathan Javier\ud83d\udca1",
            "summary": "CEO @ Wonsulting | Forbes 30U30 | FREE Job Resources in bio | Helping non-traditional backgrounds land jobs | Cisco, Google, Snap | Ft: Forbes, Insider, CNBC, Times, etc | TikTok+YouTube+LI Creator Accelerator Program\ud83d\udca1"
        },
        {
            "link": "https://www.linkedin.com/in/jehakjerrylee",
            "location": "Los Angeles Metropolitan Area",
            "name": "Jerry Lee \ud83d\udca1",
            "summary": "Co-Founder @ Wonsulting \u0026 The20 | Need free resume feedback? Visit bit.ly/wonsulting-free-resume-review | LinkedIn Top Voice 2020, Tech, Forbes 30 under 30"
        },
        {
            "link": "https://www.linkedin.com/in/kevindnaughtonjr",
            "location": "New York City Metropolitan Area",
            "name": "Kevin Naughton",
            "summary": "Software Engineer at Google"
        },
        {
            "link": "https://www.linkedin.com/in/adamrbroda",
            "location": "Greater Seattle Area",
            "name": "Adam Broda",
            "summary": "I Help People Break Into Technology \u0026 Engineering Careers | Sr. Manager, Product Management | Founder @ Broda Coaching | Hiring Manager | Wellness Advocate"
        },
        {
            "link": "https://www.linkedin.com/in/clementmihailescu",
            "location": "Las Vegas, NV",
            "name": "Clement Mihailescu",
            "summary": "Co-Founder \u0026 CEO, AlgoExpert | Ex-Google \u0026 Ex-Facebook Software Engineer | LinkedIn Top Voice"
        },
        {
            "link": "https://th.linkedin.com/in/lillianpierson",
            "location": "Ko Samui",
            "name": "Lillian Pierson, P.E.",
            "summary": "\ud83e\udd84 Data / AI Expert \u25aa CMO \u25aa CEO / Head of Product \u25aa Data Startup Mentor \u25aa Data Strategy / Data Science Instructor (1.3 MM+ learners \ud83c\udf89)"
        },
        {
            "link": "https://www.linkedin.com/in/rohankamath",
            "location": "Seattle, WA",
            "name": "Rohan Kamath",
            "summary": "Passionately curious, often wrong, always learning."
        },
        {
            "link": "https://www.linkedin.com/in/abelcak",
            "location": "New York, NY",
            "name": "Austin Belcak",
            "summary": "I Teach People How To Land Amazing Jobs Without Applying Online // Need Help With Your Job Search? Head To \ud83d\udc49 CultivatedCulture.com/Coaching"
        },
        {
            "link": "https://www.linkedin.com/in/mayagrossman",
            "location": "Austin, Texas Metropolitan Area",
            "name": "Maya Grossman",
            "summary": "I\u2019ll teach you how to get promoted without waiting for your turn or working 60 hour weeks! | Career Coach | Best-Selling Author: Invaluable | Ex Google, Microsoft | Startup Adviser"
        },
        {
            "link": "https://www.linkedin.com/in/gretchen-smith-56a234186",
            "location": "Murfreesboro, TN",
            "name": "Gretchen Smith",
            "summary": "Opinions are my own. Join. Donate. Share our mission. codeofvets.com"
        },
        {
            "link": "https://www.linkedin.com/in/aishwarya-srinivasan",
            "location": "San Francisco Bay Area",
            "name": "Aishwarya Srinivasan",
            "summary": "Data Scientist - Google Cloud | LinkedIn Top Voice Data \u0026 AI 2020 | 310k Followers"
        },
        {
            "link": "https://www.linkedin.com/in/mauricephilogene",
            "location": "Washington, DC",
            "name": "Maurice Philogene",
            "summary": "Investor | Public Servant | Philanthropist                            Lifestyle Design \u0026 Financial Freedom Coach"
        },
        {
            "link": "https://www.linkedin.com/in/diegogranadosh",
            "location": "San Francisco Bay Area",
            "name": "Diego Granados",
            "summary": "Sr. Product Manager @ LinkedIn | Ask me for my free step-by-step guide to be a PM | I\u0027ll help you become a Product Manager! | DMs open! \u270c\ufe0f"
        },
        {
            "link": "https://www.linkedin.com/in/alliekmiller",
            "location": "San Francisco Bay Area",
            "name": "Allie K. Miller",
            "summary": "Global Head of Machine Learning BD, Startups and Venture Capital at AWS | 1MM+ followers | LinkedIn Top Voice 2019, 2020, 2021"
        },
        {
            "link": "https://www.linkedin.com/in/michaelgat",
            "location": "Seattle, WA",
            "name": "Michael Gat",
            "summary": "A new position in May! Technical Program Manager with over 20 years\u0027 experience driving strategic cloud, infrastructure, and systems programs to completion."
        },
        {
            "link": "https://www.linkedin.com/in/danpriceseattle",
            "location": "Greater Seattle Area",
            "name": "Dan Price",
            "summary": "Founder/CEO, Gravity Payments"
        }
    ],
    "personal_emails": [],
    "personal_numbers": [],
    "profile_pic_url": "https://media-exp1.licdn.com/dms/image/C5603AQHaJSx0CBAUIA/profile-displayphoto-shrink_200_200/0/1558325759208?e=1656547200\u0026v=beta\u0026t=jMh42ICgb76O1pz0t6-HtnnXRNWlVs7DZXoLXB5k3_k",
    "public_identifier": "johnrmarty",
    "recommendations": [
        "Rebecca Canfield\n      \n          \n\n\n\n              \n                \n        \n              \n  \n\n      \n          John Marty is a genius at his craft. He is skilled in the art of making people feel empowered to seek out roles that they are qualified for, ask for salaries that they deserve, and creates a kind of pay it forward lifestyle. John helps you to get to places that you only thought were possible for other people. Anyone that is fortunate enough to learn from John should consider themselves extremely lucky. I know I do. ",
        "Zoe Sanoff\n      \n          \n\n\n\n              \n                \n        \n              \n  \n\n      \n          John is so focused on helping guide you through an interview process not just for Amazon but on interviewing in general.  I\u0027ve generally done well at interviewing, my skills are top notch now.  John is so focused on on his clients and really goes above and beyond.  John is genuine, knowledgeable, well spoken and non-judgemental.  He is so encouraging, so positive and really easy to talk to.  Thank you John!"
    ],
    "similarly_named_profiles": [
        {
            "link": "https://www.linkedin.com/in/john-martinez-90384a229",
            "location": "San Antonio, TX",
            "name": "John Martinez",
            "summary": "Owner of Fight or Flight Medical Consultants, LLC  , Owner Marty\u2019s Hardwood Works"
        },
        {
            "link": "https://www.linkedin.com/in/jomarty",
            "location": "Springfield, Illinois Metropolitan Area",
            "name": "John Marty",
            "summary": "John Michael Marty WSMI Show at WSMI-FM 106.1"
        },
        {
            "link": "https://www.linkedin.com/in/senatormarty",
            "location": "St Paul, MN",
            "name": "John Marty",
            "summary": null
        },
        {
            "link": "https://www.linkedin.com/in/johnmarty",
            "location": "Orlando, FL",
            "name": "John Marty",
            "summary": "Lead Software Engineer, Commerce at Disney Parks  \u0026 Resorts Digital"
        }
    ],
    "skills": [],
    "state": "Washington",
    "summary": "Most people go through life lost, disengaged, and unhappy at work and in their lives - I\u0027m on a mission to solve that.\n\nI spent 10 years as the founder of Axxis Audio, an electronics company that grew to multi-million dollar sales, which I sold in 2012. At that time, I funneled my earnings into the creation of an Internet of Things company, but numerous factors lead to its demise after 2 hard fought years. \n\nAt 31, I was penny-less, had a baby on the way, and had zero job prospects (despite applying to 150 companies). My desperate situation led me to take a job at Best Buy for $12 an hour while reinventing myself through the completion of an MBA at the University of Colorado, and a 6-month software development boot camp. \n\nAfter graduation, I landed at American Express as a Senior Product Manager and then got poached by Amazon in 2017 (because of my LinkedIn profile). My journey has led to a deep sense of perspective, humility, and purpose that I draw on to help others find clarity, meaning, and happiness in their careers and lives. \n\nCheck out my website for details on my Mindset Reset Podcast, Public Speaking, Consulting, or my free 40 page LinkedIn guide\n\nhttp://www.johnraphaelmarty.com/\n\nFAQ\u0027s\n\nQ: Can you speak at my Company, University, event or podcast?\nA: I\u0027d love to! I\u0027ve shared my message on the future of employment, breaking into big tech, and my personal story of reinventing myself and discovering my sense of purpose (and how you can too!).\n\n\u2611\ufe0f  YouTube Channel #1 (John Marty) : http://www.youtube.com/c/JohnMarty-uncommon\n\u2611\ufe0f  YouTube Channel #2 (Tech Careers for non-engineers: https://www.youtube.com/channel/UC900gMMPLwRGGXSTW1gdZHA\n\nFUN FACTS:\n\u2611\ufe0f I am an Avid cyclist and runner, and I just started learning to skateboard a half-pipe.\n\u2611\ufe0f Into the Enneagram? - I\u0027m a #3 (The Achiever)\n\nLETS CONNECT:\n\u2611\ufe0f Email: [email protected] (don\u0027t forget that \"R\"....The other guy gets my emails all the time)",
    "volunteer_work": [
        {
            "cause": "Children",
            "company": "IDEO",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/ideo",
            "description": "Early Childhood Innovation Prize Mentorship",
            "ends_at": null,
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQGmdpnS6sur1A/company-logo_100_100/0/1625244393084?e=2147483647\u0026v=beta\u0026t=fnjSw89OIZIAyXuM_ey1ecShgPWzS-kDfszAo5uPf34",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2018
            },
            "title": "Mentor"
        }
    ]
}
Key Description Example
public_identifier "johnrmarty"
profile_pic_url "https://media-exp1.licdn.com/dms/image/C5603AQHaJSx0CBAUIA/profile-displayphoto-shrink_200_200/0/1558325759208?e=1656547200\u0026v=beta\u0026t=jMh42ICgb76O1pz0t6-HtnnXRNWlVs7DZXoLXB5k3_k"
background_cover_image_url "https://media-exp1.licdn.com/dms/image/C5616AQH9tkBTUhHfng/profile-displaybackgroundimage-shrink_200_800/0/1614530499015?e=2147483647\u0026v=beta\u0026t=VEoCyedtZulnAVYWT9BXfKHi5OFp8avElNjiz8kjSTU"
first_name "John"
last_name "Marty"
full_name "John Marty"
occupation "Co-Founder at Freedom Fund Real Estate"
headline "Financial Freedom through Real Estate - LinkedIn Top Voice"
summary "Most people go through life lost, disengaged, and unhappy at work and in their lives - I\u0027m on a mission to solve that.\n\nI spent 10 years as the founder of Axxis Audio, an electronics company that grew to multi-million dollar sales, which I sold in 2012. At that time, I funneled my earnings into the creation of an Internet of Things company, but numerous factors lead to its demise after 2 hard fought years. \n\nAt 31, I was penny-less, had a baby on the way, and had zero job prospects (despite applying to 150 companies). My desperate situation led me to take a job at Best Buy for $12 an hour while reinventing myself through the completion of an MBA at the University of Colorado, and a 6-month software development boot camp. \n\nAfter graduation, I landed at American Express as a Senior Product Manager and then got poached by Amazon in 2017 (because of my LinkedIn profile). My journey has led to a deep sense of perspective, humility, and purpose that I draw on to help others find clarity, meaning, and happiness in their careers and lives. \n\nCheck out my website for details on my Mindset Reset Podcast, Public Speaking, Consulting, or my free 40 page LinkedIn guide\n\nhttp://www.johnraphaelmarty.com/\n\nFAQ\u0027s\n\nQ: Can you speak at my Company, University, event or podcast?\nA: I\u0027d love to! I\u0027ve shared my message on the future of employment, breaking into big tech, and my personal story of reinventing myself and discovering my sense of purpose (and how you can too!).\n\n\u2611\ufe0f YouTube Channel #1 (John Marty) : http://www.youtube.com/c/JohnMarty-uncommon\n\u2611\ufe0f YouTube Channel #2 (Tech Careers for non-engineers: https://www.youtube.com/channel/UC900gMMPLwRGGXSTW1gdZHA\n\nFUN FACTS:\n\u2611\ufe0f I am an Avid cyclist and runner, and I just started learning to skateboard a half-pipe.\n\u2611\ufe0f Into the Enneagram? - I\u0027m a #3 (The Achiever)\n\nLETS CONNECT:\n\u2611\ufe0f Email: [email protected] (don\u0027t forget that \"R\"....The other guy gets my emails all the time)"
country "US"
country_full_name "United States of America"
city "Seattle"
state "Singapore"
experiences List of Experience See Experience object
education List of Education See Education object
languages ["English", "Spanish", "Japanese"]
accomplishment_organisations List of AccomplishmentOrg See AccomplishmentOrg object
accomplishment_publications List of Publication See Publication object
accomplishment_honors_awards List of HonourAward See HonourAward object
accomplishment_patents List of Patent See Patent object
accomplishment_courses List of Course See Course object
accomplishment_projects List of Project See Project object
accomplishment_test_scores List of TestScore See TestScore object
volunteer_work List of VolunteeringExperience See VolunteeringExperience object
certifications List of Certification See Certification object
connections 500
people_also_viewed List of PeopleAlsoViewed See PeopleAlsoViewed object
recommendations ["Professional and dedicated approach towards clients and collegues."]
activities List of Activity See Activity object
similarly_named_profiles List of SimilarProfile See SimilarProfile object
articles List of Article See Article object
groups List of PersonGroup See PersonGroup object
skills ["branding", "cad tools", "art"]
inferred_salary An InferredSalary object See InferredSalary object
gender "male"
birth_date A Date object See Date object
industry "government administration"
interests ["education", "health", "human rights"]
extra A PersonExtra object See PersonExtra object
personal_emails ["[email protected]", "[email protected]", "[email protected]@outlook.com"]
personal_numbers ["+6512345678", "+6285123450953", "+6502300340"]

Experience

Key Description Example
starts_at A Date object See Date object
ends_at A Date object See Date object
company The company's display name. "Freedom Fund Real Estate"
company_linkedin_profile_url The company's profile URL.

If present, could be used with Company Profile Endpoint for more info.
"https://www.linkedin.com/company/freedomfund"
title "Co-Founder"
description "Our mission is to provide everyday people seeking financial freedom long before the age of 65 with the ability to invest in high yield, short-term real estate investments that were only accessible in the past for a select few wealthy individuals. Each of our single family rehab projects require a minimum investment contribution of only $10K, we have simple terms, no multi-year hold periods, and no fees. With our unique model investors can log into our easy to use website, select the projects that they want to invest in, and get realtime updates on the status of their investments.\n\nWebsite: https://www.freedomfundinvestments.com/home"
location null
logo_url URL of the logo of the organisation. "https://media-exp1.licdn.com/dms/image/C560BAQEYxazZM_hXgQ/company-logo_100_100/0/1634934418976?e=2147483647\u0026v=beta\u0026t=wI0YdMmxIctkzvnKxRfuAbT8h5eok_DlUqEph68J37s"

Date

Key Description Example
day 1
month 8
year 2021

Education

Key Description Example
starts_at A Date object See Date object
ends_at A Date object See Date object
field_of_study "Finance + Economics"
degree_name "Master of Business Administration (MBA)"
school "University of Colorado Denver"
school_linkedin_profile_url "https://www.linkedin.com/school/university-of-colorado-denver/"
description null
logo_url "https://media-exp1.licdn.com/dms/image/C560BAQGbanOkHdRLiQ/company-logo_100_100/0/1600382740152?e=2147483647\u0026v=beta\u0026t=GDDMz5Zb_4glJ94GLP2N_l-JHFdSnrDkF95FesngJdA"

Date

Key Description Example
day 1
month 1
year 2013

Project

Key Description Example
starts_at A Date object See Date object
ends_at A Date object See Date object
title "gMessenger"
description "gMessenger was built using Ruby on Rails, and the Bootstrap HTML, CSS, and JavaScript framework. It uses a Websocket-Rails integration to post a user\u0027s message content to the page in real time, with no page refresh required. gMessenger also includes custom authentication with three different permissions levels."
url "http://gmessenger.herokuapp.com/"

Date

Key Description Example
day 1
month 3
year 2015

VolunteeringExperience

Key Description Example
starts_at A Date object See Date object
ends_at A Date object See Date object
cause "Children"
company The company's display name. "IDEO"
company_linkedin_profile_url The company's profile URL.

If present, could be used with Company Profile Endpoint for more info.
"https://www.linkedin.com/company/ideo"
title "Mentor"
description "Early Childhood Innovation Prize Mentorship"
logo_url URL of the logo of the organisation. "https://media-exp1.licdn.com/dms/image/C560BAQGmdpnS6sur1A/company-logo_100_100/0/1625244393084?e=2147483647\u0026v=beta\u0026t=fnjSw89OIZIAyXuM_ey1ecShgPWzS-kDfszAo5uPf34"

Date

Key Description Example
day 1
month 1
year 2018

Certification

Key Description Example
starts_at A Date object See Date object
ends_at A Date object See Date object
url null
name "SAFe Agile Framework Practitioner - ( Scrum, XP, and Lean Practices in the SAFe Enterprise)"
license_number null
display_source null
authority "Scaled Agile, Inc."

PeopleAlsoViewed

Key Description Example
link URL of the profile.

Useable with Person profile endpoint
"https://in.linkedin.com/in/warikoo"
name "Ankur Warikoo"
summary "Founder nearbuy.com, Mentor, Angel Investor, Public Speaker"
location "India"

Activity

Key Description Example
title "Honest conversations I wish I could have had during salary negations for any new job when I was in corporate: Me: Thank you for the written offer\u2026"
link "https://www.linkedin.com/posts/johnrmarty_honest-conversations-i-wish-i-could-have-share-6925074748875960320-e48_"
activity_status "Posted by John Marty"

SimilarProfile

Key Description Example
name "John Martinez"
link "https://www.linkedin.com/in/john-martinez-90384a229"
summary "Owner of Fight or Flight Medical Consultants, LLC , Owner Marty\u2019s Hardwood Works"
location "San Antonio, TX"

Article

Key Description Example
title "Manufacturing opportunity"
link "https://www.linkedin.com/pulse/manufacturing-opportunity-bill-gates/"
published_date A Date object See Date object
author "Bill Gates"
image_url "https://media-exp1.licdn.com/dms/image/C4E12AQFftuPi0UiqWA/article-cover_image-shrink_720_1280/0/1574801149114?e=1640822400\u0026v=beta\u0026t=ZAe3ERmQCM8QHGmRPS2LJ-C76GD5PR7FBHMVL4Z6iVg"

Date

Key Description Example
day 27
month 11
year 2019

PersonGroup

Key Description Example
profile_pic_url The URL to the profile picture of this LinkedIn Group "https://media-exp1.licdn.com/dms/image/C4D07AQG9IK9V0pk3mQ/group-logo_image-shrink_92x92/0/1631371531293?e=1642060800\u0026v=beta\u0026t=UK1tfIppWa-Nx7k9whmm5f9XdZoBdJhApf9N3ke3204"
name Name of LinkedIn group for which this user is in "Hadoop Users"
url URL to the LinkedIn Group "https://www.linkedin.com/groups/988957"

InferredSalary

Key Description Example
min 35000
max 45000

Date

Key Description Example
day 1
month 1
year 1990

PersonExtra

Key Description Example
github_profile_id "github-username"
facebook_profile_id "facebook-username"
twitter_profile_id "twitter-username"

School API

School Profile Endpoint

GET /proxycurl/api/linkedin/school

Cost: 1 credit / successful request.

Get structured data of a LinkedIn School Profile

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    https://nubela.co/proxycurl/api/linkedin/school?url=https%3A%2F%2Fwww.linkedin.com%2Fschool%2Fnational-university-of-singapore&use_cache=if-present
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/linkedin/school'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
params = {
    'url': 'https://www.linkedin.com/school/national-university-of-singapore',
    'use_cache': 'if-present',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
url yes URL of the LinkedIn School Profile to crawl.

URL should be in the format of https://www.linkedin.com/school/<public_identifier>
https://www.linkedin.com/school/national-university-of-singapore
use_cache no if-present Fetches profile from cache regardless of age of profile. If profile is not available in cache, API will attempt to source profile externally..

if-recent The default behavior. API will make a best effort to return a fresh profile no older than 29 days.
if-present

Response

{
    "background_cover_image_url": "http://localhost:4566/proxycurl-web-dev/company/national-university-of-singapore/cover?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20211027%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20211027T045605Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=50af822a98cb11c73fea6d330da1b2c963d608277bb1d6e36656e6dc8d6e0e55",
    "company_size": [
        5001,
        10000
    ],
    "company_size_on_linkedin": 14771,
    "company_type": "EDUCATIONAL_INSTITUTION",
    "description": "At NUS, we are shaping the future through our people and our pursuit of new frontiers in knowledge. In a single century, we have become a university of global influence and an Asian thought leader. Our location at the crossroads of Asia informs our mission and gives us a tremendous vantage point to help create opportunities and address the pressing issues facing Singapore, Asia and the world.At NUS, we believe in education, research and service that change lives.",
    "follower_count": 417789,
    "founded_year": 1905,
    "hq": {
        "city": "Singapore",
        "country": "SG",
        "is_hq": true,
        "line_1": "21 Lower Kent Ridge Road, Singapore",
        "postal_code": null,
        "state": null
    },
    "industry": "Higher Education",
    "linkedin_internal_id": "14576902",
    "locations": [
        {
            "city": "Singapore",
            "country": "SG",
            "is_hq": true,
            "line_1": "21 Lower Kent Ridge Road, Singapore",
            "postal_code": null,
            "state": null
        }
    ],
    "name": "National University of Singapore",
    "profile_pic_url": "http://localhost:4566/proxycurl-web-dev/company/national-university-of-singapore/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20211027%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20211027T045605Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=f5d4b8415cac032b5c46beb626d5fc5f59e9494c07c4dc67b0005c636a520b18",
    "search_id": "14576902",
    "similar_companies": [
        {
            "industry": "Higher Education",
            "link": "https://hk.linkedin.com/school/universityofhongkong/",
            "location": "Hong Kong, Pokfulam",
            "name": "The University of Hong Kong"
        },
        {
            "industry": "Higher Education",
            "link": "https://au.linkedin.com/school/unsw/",
            "location": "Sydney, New South Wales (NSW)",
            "name": "UNSW"
        },
        {
            "industry": "Higher Education",
            "link": "https://cn.linkedin.com/school/fudan-university/",
            "location": "\u4e0a\u6d77, \u4e0a\u6d77\u5e02",
            "name": "Fudan University"
        },
        {
            "industry": "Research",
            "link": "https://cn.linkedin.com/school/peking-university/",
            "location": "\u5317\u4eac, Beijing",
            "name": "Peking University"
        },
        {
            "industry": "Higher Education",
            "link": "https://sg.linkedin.com/school/ntusg/",
            "location": "Singapore, singapore",
            "name": "Nanyang Technological University"
        },
        {
            "industry": "Higher Education",
            "link": "https://hk.linkedin.com/school/cityu/",
            "location": "Kowloon Tong, Kowloon",
            "name": "City University of Hong Kong"
        },
        {
            "industry": "Higher Education",
            "link": "https://ie.linkedin.com/school/university-college-dublin/",
            "location": "Dublin, dublin",
            "name": "University College Dublin"
        },
        {
            "industry": "Higher Education",
            "link": "https://hk.linkedin.com/school/the-chinese-university-of-hong-kong/",
            "location": "Shatin, NT",
            "name": "The Chinese University of Hong Kong"
        },
        {
            "industry": "Higher Education",
            "link": "https://hk.linkedin.com/school/hkust/",
            "location": null,
            "name": "The Hong Kong University of Science and Technology"
        },
        {
            "industry": "Higher Education",
            "link": "https://www.linkedin.com/school/university-of-manchester/",
            "location": null,
            "name": "The University of Manchester"
        }
    ],
    "specialities": [
        "education",
        "research",
        "broad-based curriculum",
        "cross-faculty enrichment"
    ],
    "tagline": null,
    "universal_name_id": "national-university-of-singapore",
    "updates": [],
    "website": "http://nus.edu.sg"
}
Key Description Example
linkedin_internal_id LinkedIn's Internal and immutable ID of this Company profile. "14576902"
description "At NUS, we are shaping the future through our people and our pursuit of new frontiers in knowledge. In a single century, we have become a university of global influence and an Asian thought leader. Our location at the crossroads of Asia informs our mission and gives us a tremendous vantage point to help create opportunities and address the pressing issues facing Singapore, Asia and the world.At NUS, we believe in education, research and service that change lives."
website "http://nus.edu.sg"
industry "Higher Education"
company_size Listed range of company head count [5001, 10000]
company_size_on_linkedin 14771
hq A CompanyLocation object See CompanyLocation object
company_type Possible values:

EDUCATIONAL: Educational Institution

GOVERNMENT_AGENCY: Government Agency

NON_PROFIT : Nonprofit

PARTNERSHIP : Partnership

PRIVATELY_HELD: Privately Held

PUBLIC_COMPANY: Public Company

SELF_EMPLOYED: Self-Employed

SELF_OWNED: Sole Proprietorship
"EDUCATIONAL_INSTITUTION"
founded_year 1905
specialities ["education", "research", "broad-based curriculum", "cross-faculty enrichment"]
locations List of CompanyLocation See CompanyLocation object
name "National University of Singapore"
tagline "Think Different - But Not Too Different"
universal_name_id "national-university-of-singapore"
profile_pic_url "http://localhost:4566/proxycurl-web-dev/company/national-university-of-singapore/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20211027%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20211027T045605Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=f5d4b8415cac032b5c46beb626d5fc5f59e9494c07c4dc67b0005c636a520b18"
background_cover_image_url "http://localhost:4566/proxycurl-web-dev/company/national-university-of-singapore/cover?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20211027%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20211027T045605Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=50af822a98cb11c73fea6d330da1b2c963d608277bb1d6e36656e6dc8d6e0e55"
search_id Useable with Job listing endpoint "14576902"
similar_companies List of SimilarCompany See SimilarCompany object
updates List of CompanyUpdate See CompanyUpdate object
follower_count 417789

CompanyLocation

Key Description Example
country "SG"
city "Singapore"
postal_code null
line_1 "21 Lower Kent Ridge Road, Singapore"
is_hq true
state null

SimilarCompany

Key Description Example
name "The University of Hong Kong"
link "https://hk.linkedin.com/school/universityofhongkong/"
industry "Higher Education"
location "Hong Kong, Pokfulam"

CompanyUpdate

Key Description Example
article_link The URL for which the post links out to "https://lnkd.in/gr7cb5by"
image The URL to the image to the post (if it exists) "https://media-exp1.licdn.com/dms/image/C5622AQEGh8idEAm14Q/feedshare-shrink_800/0/1633089889886?e=1637798400\u0026v=beta\u0026t=LtGtAUSJNrPYdHpVhTBLhGTWYqrHtFJ86PKSmTpou7c"
posted_on A Date object See Date object
text The body of the update "Introducing Personal Email Lookup API https://lnkd.in/gr7cb5by"
total_likes The total likes a post has received 3

Date

Key Description Example
day 30
month 9
year 2021

Reveal IP

Reveal Endpoint

GET /proxycurl/api/reveal/company

Cost: 2 credits / successful request.

Deanonymize an IPv4 address and associate the Company behind the IPv4 address.

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    https://nubela.co/proxycurl/api/reveal/company?role_contact_number=include&role_personal_email=include&role=ceo&ip=8.8.8.8
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/reveal/company'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
params = {
    'role_contact_number': 'include',
    'role_personal_email': 'include',
    'role': 'ceo',
    'ip': '8.8.8.8',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
role_contact_number no Append personal contact numbers to the response if the system finds a relevant person profile. include
role_personal_email no Append personal email addresses to the response if the system finds a relevant person profile. include
role no Lookup and append an employee of a certain role of the company.
Within the same API call, You can choose to lookup a person with a given role within this organisation that you might want to reach out to.
ceo
ip yes The target IPv4 address. 8.8.8.8

Response

{
    "company": {
        "acquisitions": null,
        "background_cover_image_url": "https://media-exp1.licdn.com/dms/image/C4E1BAQH5nC0DmQkbdw/company-background_10000/0/1521522820274?e=2147483647\u0026v=beta\u0026t=tTLKsh5fX2xnS-vyapQl9EBvrwv3NNEhl6Ku8WMeR8s",
        "categories": [],
        "company_size": [
            10001,
            null
        ],
        "company_size_on_linkedin": 278172,
        "company_type": "PUBLIC_COMPANY",
        "description": "A problem isn\u0027t truly solved until it\u0027s solved for all. Googlers build products that help create opportunities for everyone, whether down the street or across the globe. Bring your insight, imagination and a healthy disregard for the impossible. Bring everything that makes you unique. Together, we can build for everyone.\n\nCheck out our career opportunities at careers.google.com.",
        "exit_data": [],
        "extra": null,
        "follower_count": 24343989,
        "founded_year": null,
        "funding_data": [],
        "hq": {
            "city": "Mountain View",
            "country": "US",
            "is_hq": true,
            "line_1": "1600 Amphitheatre Parkway",
            "postal_code": "94043",
            "state": "CA"
        },
        "industry": "Internet Publishing",
        "linkedin_internal_id": "1441",
        "locations": [
            {
                "city": "Mountain View",
                "country": "US",
                "is_hq": true,
                "line_1": "1600 Amphitheatre Parkway",
                "postal_code": "94043",
                "state": "CA"
            },
            {
                "city": "Berlin",
                "country": "DE",
                "is_hq": false,
                "line_1": "Unter den Linden 14",
                "postal_code": "10117",
                "state": "BE"
            },
            {
                "city": "Bogota",
                "country": null,
                "is_hq": false,
                "line_1": "Carrera 11A 94-45",
                "postal_code": null,
                "state": "Carrera 11A 94-45  110221 , D.C. CO"
            },
            {
                "city": "Buenos Aires City",
                "country": "AR",
                "is_hq": false,
                "line_1": "Avenida Alicia Moreau de Justo 350",
                "postal_code": "1107",
                "state": "Buenos Aires Autonomous City"
            },
            {
                "city": "Munich",
                "country": "DE",
                "is_hq": false,
                "line_1": "Erika-Mann-Strasse 33",
                "postal_code": "80636",
                "state": "BY"
            },
            {
                "city": "Irvine",
                "country": "US",
                "is_hq": false,
                "line_1": "19510 Jamboree Rd",
                "postal_code": "92612",
                "state": "CA"
            },
            {
                "city": "Los Angeles",
                "country": "US",
                "is_hq": false,
                "line_1": "340 Main St",
                "postal_code": "90291",
                "state": "CA"
            },
            {
                "city": "San Bruno",
                "country": "US",
                "is_hq": false,
                "line_1": "901 Cherry Ave",
                "postal_code": "94066",
                "state": "CA"
            },
            {
                "city": "San Francisco",
                "country": "US",
                "is_hq": false,
                "line_1": "345 Spear St",
                "postal_code": "94105",
                "state": "CA"
            },
            {
                "city": "Miguel Hidalgo",
                "country": "MX",
                "is_hq": false,
                "line_1": "Montes Urales",
                "postal_code": "11000",
                "state": "CDMX"
            },
            {
                "city": "Boulder",
                "country": "US",
                "is_hq": false,
                "line_1": "2590 Pearl St",
                "postal_code": "80302",
                "state": "CO"
            },
            {
                "city": "Madrid",
                "country": "ES",
                "is_hq": false,
                "line_1": "Plaza Pablo Ruiz Picasso",
                "postal_code": "28046",
                "state": "Community of Madrid"
            },
            {
                "city": "Madrid",
                "country": "ES",
                "is_hq": false,
                "line_1": "Plaza Pablo Ruiz Picasso",
                "postal_code": "28020",
                "state": "Community of Madrid"
            },
            {
                "city": "Dublin",
                "country": null,
                "is_hq": false,
                "line_1": "Barrow Street",
                "postal_code": null,
                "state": "Barrow Street  County IE"
            },
            {
                "city": "Washington",
                "country": "US",
                "is_hq": false,
                "line_1": "25 Massachusetts Ave NW",
                "postal_code": "20001",
                "state": "DC"
            },
            {
                "city": "London",
                "country": "GB",
                "is_hq": false,
                "line_1": "St Giles High Street",
                "postal_code": "WC2H 8AG",
                "state": "England"
            },
            {
                "city": "Atlanta",
                "country": "US",
                "is_hq": false,
                "line_1": "10 10th St NE",
                "postal_code": "30309",
                "state": "GA"
            },
            {
                "city": "Hamburg",
                "country": "DE",
                "is_hq": false,
                "line_1": "ABC-Strasse 19",
                "postal_code": "20354",
                "state": "HH"
            },
            {
                "city": "Wan Chai",
                "country": null,
                "is_hq": false,
                "line_1": "2 Matheson St",
                "postal_code": null,
                "state": "2 Matheson St  Hong Kong HK"
            },
            {
                "city": "Gurugram",
                "country": "IN",
                "is_hq": false,
                "line_1": "15",
                "postal_code": "122001",
                "state": "HR"
            },
            {
                "city": "Paris",
                "country": "FR",
                "is_hq": false,
                "line_1": "8 Rue de Londres",
                "postal_code": "75009",
                "state": "IdF"
            },
            {
                "city": "Chicago",
                "country": "US",
                "is_hq": false,
                "line_1": "320 N Morgan St",
                "postal_code": "60607",
                "state": "IL"
            },
            {
                "city": "Bengaluru",
                "country": "IN",
                "is_hq": false,
                "line_1": "Old Madras Road",
                "postal_code": "560016",
                "state": "Karnataka"
            },
            {
                "city": "Bengaluru",
                "country": "IN",
                "is_hq": false,
                "line_1": "3 Swamy Vivekananda Road",
                "postal_code": "560016",
                "state": "Karnataka"
            },
            {
                "city": "Milan",
                "country": "IT",
                "is_hq": false,
                "line_1": "Via Federico Confalonieri, 4",
                "postal_code": "20124",
                "state": "Lomb."
            },
            {
                "city": "Cambridge",
                "country": "US",
                "is_hq": false,
                "line_1": "355 Main St",
                "postal_code": "02142",
                "state": "MA"
            },
            {
                "city": "Warsaw",
                "country": "PL",
                "is_hq": false,
                "line_1": "ulica Emilii Plater 53",
                "postal_code": "00-125",
                "state": "MA"
            },
            {
                "city": "Mumbai",
                "country": "IN",
                "is_hq": false,
                "line_1": "3 Bandra Kurla Complex Road",
                "postal_code": "400051",
                "state": "Maharashtra"
            },
            {
                "city": "Ann Arbor",
                "country": "US",
                "is_hq": false,
                "line_1": "2300 Traverwood Dr",
                "postal_code": "48105",
                "state": "MI"
            },
            {
                "city": "Taguig City",
                "country": "PH",
                "is_hq": false,
                "line_1": "5th Ave",
                "postal_code": null,
                "state": "National Capital Region"
            },
            {
                "city": "Amsterdam",
                "country": "NL",
                "is_hq": false,
                "line_1": "Claude Debussylaan 34",
                "postal_code": "1082 MD",
                "state": "North Holland"
            },
            {
                "city": "Sydney",
                "country": "AU",
                "is_hq": false,
                "line_1": "48 Pirrama Rd",
                "postal_code": "2009",
                "state": "NSW"
            },
            {
                "city": "New York",
                "country": "US",
                "is_hq": false,
                "line_1": "111 8th Ave",
                "postal_code": "10011",
                "state": "NY"
            },
            {
                "city": "Kitchener",
                "country": "CA",
                "is_hq": false,
                "line_1": "51 Breithaupt St",
                "postal_code": "N2H 5G5",
                "state": "ON"
            },
            {
                "city": "Toronto",
                "country": "CA",
                "is_hq": false,
                "line_1": "111 Richmond St W",
                "postal_code": "M5H 2G4",
                "state": "ON"
            },
            {
                "city": "Las Condes",
                "country": "CL",
                "is_hq": false,
                "line_1": "Avenida Costanera Sur",
                "postal_code": "7550000",
                "state": "Santiago Metropolitan"
            },
            {
                "city": "Singapore",
                "country": "SG",
                "is_hq": false,
                "line_1": "3 Pasir Panjang Rd",
                "postal_code": "118484",
                "state": "Singapore"
            },
            {
                "city": "Sao Paulo",
                "country": "BR",
                "is_hq": false,
                "line_1": "Avenida Brigadeiro Faria Lima, 3477",
                "postal_code": "04538-133",
                "state": "SP"
            },
            {
                "city": "Stockholm",
                "country": "SE",
                "is_hq": false,
                "line_1": "Kungsbron 2",
                "postal_code": "111 22",
                "state": "Stockholm County"
            },
            {
                "city": "Tel Aviv-Yafo",
                "country": "IL",
                "is_hq": false,
                "line_1": "Yigal Allon 98",
                "postal_code": "67891",
                "state": "Tel Aviv"
            },
            {
                "city": "Hyderabad",
                "country": "IN",
                "is_hq": false,
                "line_1": "13",
                "postal_code": "500084",
                "state": "TS"
            },
            {
                "city": "Austin",
                "country": "US",
                "is_hq": false,
                "line_1": "9606 N Mopac Expy",
                "postal_code": "78759",
                "state": "TX"
            },
            {
                "city": "Frisco",
                "country": "US",
                "is_hq": false,
                "line_1": "6175 Main St",
                "postal_code": "75034",
                "state": "TX"
            },
            {
                "city": "Reston",
                "country": "US",
                "is_hq": false,
                "line_1": "1875 Explorer St",
                "postal_code": "20190",
                "state": "VA"
            },
            {
                "city": "Melbourne",
                "country": "AU",
                "is_hq": false,
                "line_1": "90 Collins St",
                "postal_code": "3000",
                "state": "VIC"
            },
            {
                "city": "Kirkland",
                "country": "US",
                "is_hq": false,
                "line_1": "777 6th St S",
                "postal_code": "98033",
                "state": "WA"
            },
            {
                "city": "Seattle",
                "country": "US",
                "is_hq": false,
                "line_1": "601 N 34th St",
                "postal_code": "98103",
                "state": "WA"
            },
            {
                "city": "Zurich",
                "country": "CH",
                "is_hq": false,
                "line_1": "Brandschenkestrasse 110",
                "postal_code": "8002",
                "state": "ZH"
            }
        ],
        "name": "Google",
        "profile_pic_url": "https://media-exp1.licdn.com/dms/image/C4D0BAQHiNSL4Or29cg/company-logo_200_200/0/1519856215226?e=2147483647\u0026v=beta\u0026t=kJv1gX0_sqLG1g7LKLD5uh_6uEFpWGUTuzpuvVJVdEw",
        "search_id": "1441",
        "similar_companies": [
            {
                "industry": "Internet Publishing",
                "link": "https://www.linkedin.com/company/amazon",
                "location": "Seattle, WA",
                "name": "Amazon"
            },
            {
                "industry": "Software Development",
                "link": "https://www.linkedin.com/company/microsoft",
                "location": "Redmond, Washington",
                "name": "Microsoft"
            },
            {
                "industry": "Computers and Electronics Manufacturing",
                "link": "https://www.linkedin.com/company/apple",
                "location": "Cupertino, California",
                "name": "Apple"
            },
            {
                "industry": "Internet Publishing",
                "link": "https://www.linkedin.com/company/meta",
                "location": "Menlo Park, CA",
                "name": "Meta"
            },
            {
                "industry": "Entertainment Providers",
                "link": "https://www.linkedin.com/company/netflix",
                "location": "Los Gatos, CA",
                "name": "Netflix"
            },
            {
                "industry": "IT Services and IT Consulting",
                "link": "https://www.linkedin.com/company/ibm",
                "location": "Armonk, New York, NY",
                "name": "IBM"
            },
            {
                "industry": "Internet Publishing",
                "link": "https://www.linkedin.com/company/linkedin",
                "location": "Sunnyvale, CA",
                "name": "LinkedIn"
            },
            {
                "industry": "Manufacturing",
                "link": "https://www.linkedin.com/company/unilever",
                "location": "Blackfriars, London",
                "name": "Unilever"
            },
            {
                "industry": "IT Services and IT Consulting",
                "link": "https://in.linkedin.com/company/tata-consultancy-services",
                "location": "Mumbai, Maharashtra",
                "name": "Tata Consultancy Services"
            },
            {
                "industry": "Motor Vehicle Manufacturing",
                "link": "https://www.linkedin.com/company/tesla-motors",
                "location": "Austin, Texas",
                "name": "Tesla"
            }
        ],
        "specialities": [
            "search",
            "ads",
            "mobile",
            "android",
            "online video",
            "apps",
            "machine learning",
            "virtual reality",
            "cloud",
            "hardware",
            "artificial intelligence",
            "youtube",
            "software"
        ],
        "tagline": null,
        "universal_name_id": "google",
        "updates": [
            {
                "article_link": "https://blog.youtube/inside-youtube/work-diaries-how-designer-youtube-shorts-also-supports-womenyoutube/",
                "image": "https://media-exp1.licdn.com/dms/image/sync/C5627AQEYMlZ9yQWN3g/articleshare-shrink_800/0/1649096565303?e=1649235600\u0026v=beta\u0026t=o2TfNCXTIRUbL9DX4Nz-Jq4HCTpkRvP-ljogI5uKrg8",
                "posted_on": {
                    "day": 4,
                    "month": 4,
                    "year": 2022
                },
                "text": "Featured in the latest #YouTube Work Diaries \u2014 spend a week with Alexandria Won, a UX designer on the YouTube Shorts team, who also co-leads the Community \u0026 Inclusion pillar of the [email protected] employee resource group. https://goo.gle/3NK65O9",
                "total_likes": 596
            },
            {
                "article_link": null,
                "image": "https://media-exp1.licdn.com/dms/image/C5605AQGYnt-vEuvZtw/feedshare-thumbnail_720_1280/0/1649095895695?e=2147483647\u0026v=beta\u0026t=KQPCiYiSjsnHFl_UTijnN2M0b9r2y5A5OEM0F8WuAOQ",
                "posted_on": {
                    "day": 4,
                    "month": 4,
                    "year": 2022
                },
                "text": "\ud83c\udf1fUniversity students: LEAD a Google #DeveloperStudentClubs near you! Applications are now open! Apply today \u2192 http://goo.gle/gdsc-leads\n\nThis is your chance to:\n\u2714\ufe0f Gain professional development\n\u2714\ufe0f Empower other students\n\u2714\ufe0f Host hands-on workshops\nand more!",
                "total_likes": 181
            },
            {
                "article_link": null,
                "image": "https://media-exp1.licdn.com/dms/image/C5622AQHY6FJjt_Bs8A/feedshare-shrink_2048_1536/0/1648661701812?e=2147483647\u0026v=beta\u0026t=-baJeZx5VLknaHdsGO17kmO3cwIB4B5thxvQEUS7nHY",
                "posted_on": {
                    "day": 30,
                    "month": 3,
                    "year": 2022
                },
                "text": "Get firsthand interview advice from a Googler who has experienced every step of the process!\nIanka Bhatia, a Government Inquiries Project Manager, urges you to be yourself.\n\nExplore more #LifeAtGoogle tips and tricks now \u2192  https://goo.gle/2PT1uji",
                "total_likes": 3899
            },
            {
                "article_link": "https://blog.google/around-the-globe/google-asia/10-years-google-indonesia/",
                "image": "https://media-exp1.licdn.com/dms/image/sync/C4D27AQFYzT6Sm7zUEw/articleshare-shrink_800/0/1648649394790?e=1649235600\u0026v=beta\u0026t=cVdWaGmRI3klyC0qFgy2bGDdfxC1MCt9VtdYRdo4Kko",
                "posted_on": {
                    "day": 30,
                    "month": 3,
                    "year": 2022
                },
                "text": "Happy 10th anniversary to Google Indonesia! In the past 10 years, our Jakarta office has grown from just four employees to the dozens of Googlers working on impactful projects in Indonesia today.  To mark the occasion, Managing Director Randy Jusuf shares some of the top moments from the past decade supporting over 200,000 Indonesian mobile developers, protecting the ocean with technology and bringing Indonesian landmarks to the world through Street View \u2192  https://goo.gle/3K427xq\n\nInterested in exploring jobs at our Indonesia office? Start here \u2192 https://goo.gle/3J3Gix3",
                "total_likes": 5468
            },
            {
                "article_link": null,
                "image": "https://media-exp1.licdn.com/dms/image/C5605AQFVAlme6jejvQ/feedshare-thumbnail_720_1280/0/1648422520569?e=2147483647\u0026v=beta\u0026t=TdMsArC5x7n21O5vG656FT1doW-h_B-uRlGYvA9ElEA",
                "posted_on": {
                    "day": 29,
                    "month": 3,
                    "year": 2022
                },
                "text": "\u201cI love being part of the #IamRemarkable community because of what it stands for and the incredible life-changing impact that the workshops provide for participants.\u201d #IamRemarkable facilitator Karen Zhang spoke to us about challenging perceptions around self-promotion as well as her work at Google. \n\nLearn more and sign up for a workshop at \u2192 https://lnkd.in/fMse_Bt",
                "total_likes": 928
            },
            {
                "article_link": null,
                "image": "https://media-exp1.licdn.com/dms/image/C5622AQFZJSQKB95aAw/feedshare-shrink_800/0/1648308649845?e=2147483647\u0026v=beta\u0026t=TIM-8mI5VDg2uWmz5tL2SyKHBl5VYMOkrhFgl6sQjfI",
                "posted_on": {
                    "day": 29,
                    "month": 3,
                    "year": 2022
                },
                "text": "#CodeJam, Google\u0027s longest running global coding competition, is back for its 19th year \u27a1\ufe0f https://goo.gle/3bxE4We\n\nSolve intriguing algorithmic puzzles for a chance to earn the title of Code Jam Champion and win $15,000 USD at the World Finals. \ud83c\udfc6",
                "total_likes": 1620
            },
            {
                "article_link": null,
                "image": null,
                "posted_on": {
                    "day": 22,
                    "month": 3,
                    "year": 2022
                },
                "text": "Google employees - What is the single most important thing you\u2019ve learned during your time at Google?\n\nWe\u2019ll be sharing your responses throughout the next few weeks! #LifeAtGoogle",
                "total_likes": 1370
            }
        ],
        "website": "https://goo.gle/3m1IN7m"
    },
    "company_linkedin_profile_url": "https://www.linkedin.com/company/google",
    "role_contact_number": [
        "+16502530000"
    ],
    "role_personal_email": [
        "[email protected]"
    ],
    "role_profile": null
}
Key Description Example
company A LinkedinCompany object See LinkedinCompany object
company_linkedin_profile_url LinkedIn Profile URL of the Company returned. "https://www.linkedin.com/company/apple"
role_contact_number A list of personal contact numbers. ["+1123123123"]
role_personal_email A list of personal email addresses. ["[email protected]", "[email protected]"]
role_profile A PersonEndpointResponse object See PersonEndpointResponse object

LinkedinCompany

Key Description Example
linkedin_internal_id LinkedIn's Internal and immutable ID of this Company profile. "1441"
description "A problem isn\u0027t truly solved until it\u0027s solved for all. Googlers build products that help create opportunities for everyone, whether down the street or across the globe. Bring your insight, imagination and a healthy disregard for the impossible. Bring everything that makes you unique. Together, we can build for everyone.\n\nCheck out our career opportunities at careers.google.com."
website "https://goo.gle/3m1IN7m"
industry "Internet Publishing"
company_size Listed range of company head count [10001, null]
company_size_on_linkedin 278172
hq A CompanyLocation object See CompanyLocation object
company_type Possible values:

EDUCATIONAL: Educational Institution

GOVERNMENT_AGENCY: Government Agency

NON_PROFIT : Nonprofit

PARTNERSHIP : Partnership

PRIVATELY_HELD: Privately Held

PUBLIC_COMPANY: Public Company

SELF_EMPLOYED: Self-Employed

SELF_OWNED: Sole Proprietorship
"PUBLIC_COMPANY"
founded_year null
specialities ["search", "ads", "mobile", "android", "online video", "apps", "machine learning", "virtual reality", "cloud", "hardware", "artificial intelligence", "youtube", "software"]
locations List of CompanyLocation See CompanyLocation object
name "Google"
tagline "Think Different - But Not Too Different"
universal_name_id "google"
profile_pic_url "https://media-exp1.licdn.com/dms/image/C4D0BAQHiNSL4Or29cg/company-logo_200_200/0/1519856215226?e=2147483647\u0026v=beta\u0026t=kJv1gX0_sqLG1g7LKLD5uh_6uEFpWGUTuzpuvVJVdEw"
background_cover_image_url "https://media-exp1.licdn.com/dms/image/C4E1BAQH5nC0DmQkbdw/company-background_10000/0/1521522820274?e=2147483647\u0026v=beta\u0026t=tTLKsh5fX2xnS-vyapQl9EBvrwv3NNEhl6Ku8WMeR8s"
search_id Useable with Job listing endpoint "1441"
similar_companies List of SimilarCompany See SimilarCompany object
updates List of CompanyUpdate See CompanyUpdate object
follower_count 24343989
acquisitions An Acquisition object See Acquisition object
exit_data List of Exit See Exit object
extra A CompanyDetails object See CompanyDetails object
funding_data List of Funding See Funding object
categories A list of categories` ["artificial-intelligence", "virtual-reality"]

CompanyLocation

Key Description Example
country "US"
city "Mountain View"
postal_code "94043"
line_1 "1600 Amphitheatre Parkway"
is_hq true
state "CA"

SimilarCompany

Key Description Example
name "Amazon"
link "https://www.linkedin.com/company/amazon"
industry "Internet Publishing"
location "Seattle, WA"

CompanyUpdate

Key Description Example
article_link The URL for which the post links out to "https://lnkd.in/gr7cb5by"
image The URL to the image to the post (if it exists) "https://media-exp1.licdn.com/dms/image/C5622AQEGh8idEAm14Q/feedshare-shrink_800/0/1633089889886?e=1637798400\u0026v=beta\u0026t=LtGtAUSJNrPYdHpVhTBLhGTWYqrHtFJ86PKSmTpou7c"
posted_on A Date object See Date object
text The body of the update "Introducing Personal Email Lookup API https://lnkd.in/gr7cb5by"
total_likes The total likes a post has received 3

Date

Key Description Example
day 30
month 9
year 2021

Acquisition

Key Description Example
acquired List of AcquiredCompany See AcquiredCompany object
acquired_by An Acquisitor object See Acquisitor object

AcquiredCompany

Key Description Example
linkedin_profile_url LinkedIn Company Profile URL of company that was involved "https://www.linkedin.com/company/apple"
crunchbase_profile_url Crunchbase Profile URL of company that was involved "https://www.crunchbase.com/organization/apple"
announced_date A Date object See Date object
price Price of acquisition 300000000

Date

Key Description Example
day 1
month 4
year 1976

Acquisitor

Key Description Example
linkedin_profile_url LinkedIn Company Profile URL of company that was involved "https://www.linkedin.com/company/nvidia"
crunchbase_profile_url Crunchbase Profile URL of company that was involved "https://www.crunchbase.com/organization/nvidia"
announced_date A Date object See Date object
price Price of acquisition 10000

Date

Key Description Example
day 6
month 3
year 2020

Exit

Key Description Example
linkedin_profile_url LinkedIn Profile URL of the company that has exited "https://www.linkedin.com/company/motiondsp"
crunchbase_profile_url Crunchbase Profile URL of the company that has exited "https://www.crunchbase.com/organization/motiondsp"
name Name of the company "MotionDSP"

CompanyDetails

Key Description Example
ipo_status IPO status of the company "Public"
crunchbase_rank A measure of prominence of this company by Crunchbase 13
founding_date A Date object See Date object
operating_status Status of the company's operational status "Active"
company_type Type of company "For Profit"
contact_email General contact email of the company "[email protected]"
phone_number General contact number of the company "(140) 848-6200"
facebook_id ID of the company's official Facebook account "NVIDIA.IN"
twitter_id ID of the company's official Twitter account "nvidia"
number_of_funding_rounds Total rounds of funding that this company has raised 3
total_funding_amount Total venture capital raised by this company 4000000
stock_symbol Stock symbol of this public company "NASDAQ:NVDA"
ipo_date A Date object See Date object
number_of_lead_investors Total lead investors 3
number_of_investors Total investors 4
total_fund_raised The total amount of funds raised (by this VC firm) to be deployed as subsidiary investments (applicable only for VC firms) 1000
number_of_investments Total investments made by this VC firm (applicable only for VC firms) 50
number_of_lead_investments Total investments that was led by this VC firm (applicable only for VC firms) 3
number_of_exits Total exits by this VC (applicable only for VC firms) 7
number_of_acquisitions Total companies acquired by this company 2

Date

Key Description Example
day 1
month 1
year 2000

Funding

Key Description Example
funding_type Type of funding "Grant"
money_raised Amount of money raised 25000000
announced_date A Date object See Date object
number_of_investor Number of investors in this round 1
investor_list List of Investor See Investor object

Date

Key Description Example
day 1
month 1
year 2001

Investor

Key Description Example
linkedin_profile_url LinkedIn Profile URL of investor "https://linkedin.com/company/darpa"
name Name of investor "DARPA"
type Type of investor "organization"

Meta API

View Credit Balance Endpoint

GET /proxycurl/api/credit-balance

Cost: 0 credit / successful request.

Get your current credit(s) balance

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    https://nubela.co/proxycurl/api/credit-balance
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/credit-balance'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
response = requests.get(api_endpoint,
                        headers=header_dic)

Response

{
    "credit_balance": 100000
}
Key Description Example
credit_balance Your current credit(s) 100000