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?

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 API

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 those locations 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&resolve_numeric_id=false&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',
    'resolve_numeric_id': 'false',
    '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
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
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=true&categories=include&funding_data=include&extra=include&exit_data=include&acquisitions=include&url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fapple%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': 'true',
    'categories': 'include',
    'funding_data': 'include',
    'extra': 'include',
    'exit_data': 'include',
    'acquisitions': 'include',
    'url': 'https://www.linkedin.com/company/apple/',
    '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.
true
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/apple/
use_cache no if-present The default behavior. 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 API will make a best effort to return a fresh profile no older than 29 days.Costs an extra 1 credit on top of the cost of the base endpoint.
if-present

Response

{
    "acquisitions": {
        "acquired": [
            {
                "announced_date": {
                    "day": 7,
                    "month": 2,
                    "year": 2022
                },
                "crunchbase_profile_url": "https://www.crunchbase.com/organization/ai-music",
                "linkedin_profile_url": "https://www.linkedin.com/company/ai-music",
                "price": null
            },
            {
                "announced_date": {
                    "day": 23,
                    "month": 3,
                    "year": 2022
                },
                "crunchbase_profile_url": "https://www.crunchbase.com/organization/credit-kudos",
                "linkedin_profile_url": "https://www.linkedin.com/company/credit-kudos",
                "price": 150000000
            },
            {
                "announced_date": {
                    "day": 24,
                    "month": 6,
                    "year": 2020
                },
                "crunchbase_profile_url": "https://www.crunchbase.com/organization/fleetsmith",
                "linkedin_profile_url": "https://www.linkedin.com/company/fleetsmith",
                "price": null
            },
            {
                "announced_date": {
                    "day": 27,
                    "month": 5,
                    "year": 2020
                },
                "crunchbase_profile_url": "https://www.crunchbase.com/organization/inductiv",
                "linkedin_profile_url": null,
                "price": null
            },
            {
                "announced_date": {
                    "day": 1,
                    "month": 4,
                    "year": 2022
                },
                "crunchbase_profile_url": "https://www.crunchbase.com/organization/joby-aviation",
                "linkedin_profile_url": "https://www.linkedin.com/company/joby-aviation",
                "price": null
            },
            {
                "announced_date": {
                    "day": 1,
                    "month": 8,
                    "year": 2020
                },
                "crunchbase_profile_url": "https://www.crunchbase.com/organization/mobeewave",
                "linkedin_profile_url": "https://www.linkedin.com/company/mobeewave",
                "price": 100000000
            },
            {
                "announced_date": {
                    "day": 4,
                    "month": 4,
                    "year": 2020
                },
                "crunchbase_profile_url": "https://www.crunchbase.com/organization/nextvr",
                "linkedin_profile_url": "https://www.linkedin.com/company/nextvr",
                "price": 100000000
            },
            {
                "announced_date": {
                    "day": 30,
                    "month": 8,
                    "year": 2021
                },
                "crunchbase_profile_url": "https://www.crunchbase.com/organization/paws-inc",
                "linkedin_profile_url": null,
                "price": null
            },
            {
                "announced_date": {
                    "day": 24,
                    "month": 9,
                    "year": 2020
                },
                "crunchbase_profile_url": "https://www.crunchbase.com/organization/scout-fm",
                "linkedin_profile_url": null,
                "price": null
            },
            {
                "announced_date": {
                    "day": 6,
                    "month": 5,
                    "year": 2021
                },
                "crunchbase_profile_url": "https://www.crunchbase.com/organization/sourcedna",
                "linkedin_profile_url": "https://www.linkedin.com/company/sourcedna",
                "price": null
            },
            {
                "announced_date": {
                    "day": 24,
                    "month": 8,
                    "year": 2020
                },
                "crunchbase_profile_url": "https://www.crunchbase.com/organization/spaces-6",
                "linkedin_profile_url": "https://www.linkedin.com/company/7943613",
                "price": null
            },
            {
                "announced_date": {
                    "day": 31,
                    "month": 3,
                    "year": 2020
                },
                "crunchbase_profile_url": "https://www.crunchbase.com/organization/the-dark-sky-company",
                "linkedin_profile_url": "https://www.linkedin.com/company/the-dark-sky-company",
                "price": null
            },
            {
                "announced_date": {
                    "day": 27,
                    "month": 10,
                    "year": 2020
                },
                "crunchbase_profile_url": "https://www.crunchbase.com/organization/vilynx",
                "linkedin_profile_url": "https://www.linkedin.com/company/vilynx",
                "price": 50000000
            },
            {
                "announced_date": {
                    "day": 3,
                    "month": 4,
                    "year": 2020
                },
                "crunchbase_profile_url": "https://www.crunchbase.com/organization/voysis",
                "linkedin_profile_url": "https://www.linkedin.com/company/scream-technologies",
                "price": null
            }
        ],
        "acquired_by": null
    },
    "background_cover_image_url": "https://s3.us-west-000.backblazeb2.com/proxycurl/company/apple/cover?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=0004d7f56a0400b0000000001%2F20220726%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20220726T154504Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=a3246f6ee4c2e3f25753f3e4c1d9d16e96398edf9af787b34ea2e3becf353234",
    "categories": [
        "consumer-electronics",
        "electronics",
        "hardware",
        "mobile-devices",
        "retail",
        "software"
    ],
    "company_size": [
        null,
        null
    ],
    "company_size_on_linkedin": 381951,
    "company_type": null,
    "description": null,
    "exit_data": [
        {
            "crunchbase_profile_url": "https://www.crunchbase.com/organization/adobe-systems",
            "linkedin_profile_url": "https://www.linkedin.com/company/adobe",
            "name": "Adobe"
        },
        {
            "crunchbase_profile_url": "https://www.crunchbase.com/organization/corning",
            "linkedin_profile_url": "https://www.linkedin.com/company/3678",
            "name": "Corning"
        },
        {
            "crunchbase_profile_url": "https://www.crunchbase.com/organization/didi-dache",
            "linkedin_profile_url": "https://www.linkedin.com/company/didiglobal",
            "name": "Didi"
        },
        {
            "crunchbase_profile_url": "https://www.crunchbase.com/organization/elan-microelectronics",
            "linkedin_profile_url": "https://www.linkedin.com/company/elan-microelectronics",
            "name": "ELAN Microelectronics"
        },
        {
            "crunchbase_profile_url": "https://www.crunchbase.com/organization/emagin",
            "linkedin_profile_url": "https://www.linkedin.com/company/1328664",
            "name": "eMagin"
        },
        {
            "crunchbase_profile_url": "https://www.crunchbase.com/organization/finisar",
            "linkedin_profile_url": "https://www.linkedin.com/company/163813",
            "name": "Finisar"
        },
        {
            "crunchbase_profile_url": "https://www.crunchbase.com/organization/global-online-devices",
            "linkedin_profile_url": "https://www.linkedin.com/company/global-online-devices",
            "name": "God-i"
        },
        {
            "crunchbase_profile_url": "https://www.crunchbase.com/organization/ii-vi",
            "linkedin_profile_url": "https://www.linkedin.com/company/ii-vi-incorporated",
            "name": "II-VI"
        },
        {
            "crunchbase_profile_url": "https://www.crunchbase.com/organization/imagination-technologies",
            "linkedin_profile_url": "https://www.linkedin.com/company/imagination-technologies",
            "name": "Imagination Technologies"
        },
        {
            "crunchbase_profile_url": "https://www.crunchbase.com/organization/kanisa-inc",
            "linkedin_profile_url": null,
            "name": "Kanisa"
        },
        {
            "crunchbase_profile_url": "https://www.crunchbase.com/organization/zomato",
            "linkedin_profile_url": "https://www.linkedin.com/company/zomato",
            "name": "Zomato"
        }
    ],
    "extra": {
        "company_type": "For Profit",
        "contact_email": null,
        "crunchbase_rank": 15,
        "facebook_id": "apple",
        "founding_date": {
            "day": 1,
            "month": 4,
            "year": 1976
        },
        "ipo_date": null,
        "ipo_status": "Public",
        "number_of_acquisitions": null,
        "number_of_exits": null,
        "number_of_funding_rounds": null,
        "number_of_investments": null,
        "number_of_investors": 6,
        "number_of_lead_investments": null,
        "number_of_lead_investors": 3,
        "operating_status": "Active",
        "phone_number": "408-996-1010",
        "stock_symbol": "NASDAQ:AAPL",
        "total_fund_raised": 375000000,
        "total_funding_amount": 6200000000,
        "twitter_id": "apple"
    },
    "follower_count": 16814202,
    "founded_year": null,
    "funding_data": [
        {
            "announced_date": {
                "day": 6,
                "month": 9,
                "year": 2017
            },
            "funding_type": "Post-IPO Debt",
            "investor_list": [],
            "money_raised": 5000000000,
            "number_of_investor": null
        },
        {
            "announced_date": {
                "day": 16,
                "month": 5,
                "year": 2016
            },
            "funding_type": "Post-IPO Equity",
            "investor_list": [
                {
                    "linkedin_profile_url": "https://linkedin.com/company/berkshire-hathaway",
                    "name": "Berkshire Hathaway",
                    "type": "organization"
                }
            ],
            "money_raised": 1000000000,
            "number_of_investor": 1
        },
        {
            "announced_date": {
                "day": 1,
                "month": 8,
                "year": 1997
            },
            "funding_type": "Post-IPO Equity",
            "investor_list": [
                {
                    "linkedin_profile_url": "https://linkedin.com/company/microsoft",
                    "name": "Microsoft",
                    "type": "organization"
                }
            ],
            "money_raised": 150000000,
            "number_of_investor": 1
        },
        {
            "announced_date": {
                "day": 12,
                "month": 7,
                "year": 2017
            },
            "funding_type": "Private Equity Round",
            "investor_list": [],
            "money_raised": null,
            "number_of_investor": null
        },
        {
            "announced_date": {
                "day": 15,
                "month": 5,
                "year": 1977
            },
            "funding_type": "Seed Round",
            "investor_list": [
                {
                    "linkedin_profile_url": "https://linkedin.com/company/matrix-partners",
                    "name": "Matrix Partners",
                    "type": "organization"
                },
                {
                    "linkedin_profile_url": null,
                    "name": "Mike Markkula",
                    "type": "person"
                }
            ],
            "money_raised": 80000,
            "number_of_investor": 2
        },
        {
            "announced_date": {
                "day": 4,
                "month": 5,
                "year": 1978
            },
            "funding_type": "Seed Round",
            "investor_list": [
                {
                    "linkedin_profile_url": "https://linkedin.com/company/sequoia",
                    "name": "Sequoia Capital",
                    "type": "organization"
                },
                {
                    "linkedin_profile_url": "https://linkedin.com/company/venrock",
                    "name": "Venrock",
                    "type": "organization"
                }
            ],
            "money_raised": 150000,
            "number_of_investor": 2
        }
    ],
    "hq": {
        "city": "Cupertino",
        "country": "US",
        "is_hq": true,
        "line_1": "1 Apple Park Way",
        "postal_code": "95014",
        "state": "California"
    },
    "industry": null,
    "linkedin_internal_id": "162479",
    "locations": [
        {
            "city": "Cupertino",
            "country": "US",
            "is_hq": true,
            "line_1": "1 Apple Park Way",
            "postal_code": "95014",
            "state": "California"
        }
    ],
    "name": "Apple",
    "profile_pic_url": null,
    "search_id": "162479",
    "similar_companies": [
        {
            "industry": "Technology, Information and Internet",
            "link": "https://www.linkedin.com/company/google",
            "location": "Mountain View, CA",
            "name": "Google"
        },
        {
            "industry": "Technology, Information and Internet",
            "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": "Technology, Information and Internet",
            "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": "Motor Vehicle Manufacturing",
            "link": "https://www.linkedin.com/company/tesla-motors",
            "location": "Austin, Texas",
            "name": "Tesla"
        },
        {
            "industry": "IT Services and IT Consulting",
            "link": "https://www.linkedin.com/company/ibm",
            "location": "Armonk, New York, NY",
            "name": "IBM"
        },
        {
            "industry": "Computers and Electronics Manufacturing",
            "link": "https://kr.linkedin.com/company/samsung-electronics",
            "location": "Suwon-Si, Gyeonggi-Do",
            "name": "Samsung Electronics"
        },
        {
            "industry": "Technology, Information and Internet",
            "link": "https://www.linkedin.com/company/linkedin",
            "location": "Sunnyvale, CA",
            "name": "LinkedIn"
        },
        {
            "industry": "Musicians",
            "link": "https://se.linkedin.com/company/spotify",
            "location": "Stockholm, Stockholm County",
            "name": "Spotify"
        }
    ],
    "specialities": [],
    "tagline": null,
    "universal_name_id": "apple",
    "updates": [],
    "website": "http://www.apple.com/careers"
}
Key Description Example
linkedin_internal_id LinkedIn's Internal and immutable ID of this Company profile. "162479"
description null
website "http://www.apple.com/careers"
industry null
company_size Listed range of company head count [null, null]
company_size_on_linkedin 381951
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
null
founded_year null
specialities []
locations List of CompanyLocation See CompanyLocation object
name "Apple"
tagline "Think Different - But Not Too Different"
universal_name_id "apple"
profile_pic_url null
background_cover_image_url "https://s3.us-west-000.backblazeb2.com/proxycurl/company/apple/cover?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=0004d7f56a0400b0000000001%2F20220726%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20220726T154504Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=a3246f6ee4c2e3f25753f3e4c1d9d16e96398edf9af787b34ea2e3becf353234"
search_id Useable with Job listing endpoint "162479"
similar_companies List of SimilarCompany See SimilarCompany object
updates List of CompanyUpdate See CompanyUpdate object
follower_count 16814202
acquisitions An Acquisition object See Acquisition object
exit_data List of Exit See Exit object
extra Company extra when extra=include See CompanyDetails object
funding_data Company Funding data when funding_data=include See Funding object
categories A list of categories` ["artificial-intelligence", "virtual-reality"]

CompanyLocation

Key Description Example
country "US"
city "Cupertino"
postal_code "95014"
line_1 "1 Apple Park Way"
is_hq true
state "California"

SimilarCompany

Key Description Example
name "Google"
link "https://www.linkedin.com/company/google"
industry "Technology, Information and Internet"
location "Mountain View, CA"

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 Date by which this event was announced 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 Date by which this event was announced 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 Date of founding 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 The date by which this public company went public 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 Date of announcement 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: 2 credits / 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=1035
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': '1035',
}
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]
(#company-api-linkedin-company-profile-endpoint).
1035

Response

{
    "job": [
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Security Analyst (DART) - Detection and Response Team",
            "job_url": "https://www.linkedin.com/jobs/view/3099474469",
            "list_date": null,
            "location": "London, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Technology Specialists BizApps",
            "job_url": "https://www.linkedin.com/jobs/view/3073299528",
            "list_date": null,
            "location": "Reading, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Customer Success Management IC4",
            "job_url": "https://www.linkedin.com/jobs/view/3088297589",
            "list_date": null,
            "location": "Reading, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Web Sales \u0026 Customer Support Advisor - Consumer Customers",
            "job_url": "https://www.linkedin.com/jobs/view/3073408044",
            "list_date": null,
            "location": "London, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Digital Advisor",
            "job_url": "https://www.linkedin.com/jobs/view/3091944620",
            "list_date": null,
            "location": "Manchester, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Digital Advisor",
            "job_url": "https://www.linkedin.com/jobs/view/3091945492",
            "list_date": null,
            "location": "London, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Meeting Room Global Black Belt Sales Professional",
            "job_url": "https://www.linkedin.com/jobs/view/3073695907",
            "list_date": null,
            "location": "London, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Customer Success Manager - Modern Work",
            "job_url": "https://www.linkedin.com/jobs/view/3092059527",
            "list_date": null,
            "location": "Reading, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Business Administrator",
            "job_url": "https://www.linkedin.com/jobs/view/3073292283",
            "list_date": null,
            "location": "Cambridge, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Account Delivery Management IC6",
            "job_url": "https://www.linkedin.com/jobs/view/3073466352",
            "list_date": null,
            "location": "Reading, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Executive Producer-Xbox Publishing",
            "job_url": "https://www.linkedin.com/jobs/view/3089096967",
            "list_date": null,
            "location": "London, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Digital Advisor",
            "job_url": "https://www.linkedin.com/jobs/view/3091944622",
            "list_date": null,
            "location": "Reading, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Full Time Opportunities - AI Researcher",
            "job_url": "https://www.linkedin.com/jobs/view/2982837417",
            "list_date": null,
            "location": "Cambridge, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Escalation Engineer Technical Support - Azure/Telco",
            "job_url": "https://www.linkedin.com/jobs/view/3095506397",
            "list_date": null,
            "location": "Reading, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Intune Support Engineer",
            "job_url": "https://www.linkedin.com/jobs/view/3073267700",
            "list_date": null,
            "location": "Reading, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Customer Success Account Mgmt - Application Development",
            "job_url": "https://www.linkedin.com/jobs/view/3085586525",
            "list_date": null,
            "location": "Cambridge, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Security Analyst (DART) - Detection and Response Team",
            "job_url": "https://www.linkedin.com/jobs/view/3099476216",
            "list_date": null,
            "location": "Cambridge, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Researcher in User Experience Design",
            "job_url": "https://www.linkedin.com/jobs/view/3073409764",
            "list_date": null,
            "location": "Cambridge, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Product Manager",
            "job_url": "https://www.linkedin.com/jobs/view/3097096699",
            "list_date": null,
            "location": "London, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Internship opportunities: Confidential Computing",
            "job_url": "https://www.linkedin.com/jobs/view/3043459039",
            "list_date": null,
            "location": "Cambridge, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Internship opportunities: Machine Learning for Visual Communication",
            "job_url": "https://www.linkedin.com/jobs/view/3037128666",
            "list_date": null,
            "location": "Reading, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Solution Area Specialists Cyber Security",
            "job_url": "https://www.linkedin.com/jobs/view/3073693634",
            "list_date": null,
            "location": "Reading, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Studio Discipline Lead",
            "job_url": "https://www.linkedin.com/jobs/view/3094117901",
            "list_date": null,
            "location": "London, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Studio Discipline Lead",
            "job_url": "https://www.linkedin.com/jobs/view/3094119661",
            "list_date": null,
            "location": "Reading, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Studio Discipline Lead",
            "job_url": "https://www.linkedin.com/jobs/view/3094124026",
            "list_date": null,
            "location": "Cambridge, England, United Kingdom"
        }
    ],
    "next_page_api_url": "http://proxycurl-web.127.0.0.1.nip.io:5002/proxycurl-dev/proxycurl-dev/api/v2/linkedin/company/job?pagination=eyJwYWdlIjogMX0\u0026search_id=1035",
    "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://proxycurl-web.127.0.0.1.nip.io:5002/proxycurl-dev/proxycurl-dev/api/v2/linkedin/company/job?pagination=eyJwYWdlIjogMX0\u0026search_id=1035"
previous_page_no null
previous_page_api_url null

Job

Key Description Example
company "Microsoft"
company_url "https://www.linkedin.com/company/microsoft"
job_title "Security Analyst (DART) - Detection and Response Team"
job_url "https://www.linkedin.com/jobs/view/3099474469"
list_date null
location "London, England, United Kingdom"

Job Profile Endpoint

GET /proxycurl/api/linkedin/job

Cost: 2 credits / 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": null,
    "company": {
        "logo": "https://media-exp1.licdn.com/dms/image/C4D0BAQHiNSL4Or29cg/company-logo_400_400/0/1519856215226?e=1661385600\u0026v=beta\u0026t=rUecQpduLPDavL3JswjLsJAUNgSu1Q2l3JS5sGp8nHk",
        "name": "Google",
        "url": "https://www.linkedin.com/company/google"
    },
    "employment_type": "Full-time",
    "industry": [
        "Internet"
    ],
    "job_description": "This role may also be located in our Playa Vista, CA campus.\n\nNote: By applying to this position you will have an opportunity to share your preferred working location from the following: Redwood City, CA, USA; Ann Arbor, MI, USA; Chicago, IL, USA; New York, NY, USA; Los Angeles, CA, USA.\n\nMinimum qualifications:\nBachelor\u2019s degree in Engineering, Computer Science, Information Systems, Statistics, Economics, Mathematics, Finance, a related quantitative field, or equivalent practical experience.2 years of experience in business intelligence, data engineering, data modeling, or using analytics with SQL.Experience with programming languages (e.g. Python).Experience partnering or working with stakeholders across organizational boundaries.\n\nPreferred qualifications:\n4 years of experience designing and building scalable data pipelines to enable data-driven business selections.Experience in statistical tools (e.g., R, SPSS, MATLAB, etc.).Experience in machine learning models (e.g., scikit-learn, TensorFlow, etc.).Knowledge of commercial and other reporting tools and technologies (e.g., Tableau, QlikView, D3, Microstrategy, BusinessObjects, Cognos, etc.).Ability to manage multiple projects, and communicate findings/reports to stakeholders and non-techincal audiences. Excellent verbal and written communication skills.\n\nAbout The Job\n\nAs a Data Engineer, you will use an analytical, data-driven approach to drive understanding of business changes. You will build data pipelines that enable engineers, analysts, and other stakeholders across the organization. You will also build data models to deliver insightful analytics while ensuring data integrity.\n\nWhen our millions of advertisers and publishers are happy, so are we! Our Google Customer Solutions (GCS) team of entrepreneurial, enthusiastic and client-focused members are the \"human face\" of Google, helping entrepreneurs both individually and broadly build their online presence and grow their businesses. We are dedicated to growing the unique needs of advertising companies. Our teams of strategists, analysts, advisers and support specialists collaborate closely to spot and analyze customer needs and trends. In collaboration, we create and implement business plans broadly for all types of businesses.\n\nResponsibilities\n\nBuild data pipelines, reports, best practices, and frameworks that enable analysts and stakeholders across the organization.Recognize and adopt best practices in developing pipelines and analytical insights, including data integrity, test design, analysis, validation, and documentation.Design and develop scalable and actionable solutions that provide insights to help advertisers grow.Work with stakeholders to understand feature and tool gaps and innovate on behalf of our customers.\n\nGoogle is proud to be an equal opportunity workplace and is an affirmative action employer. We are committed to equal employment opportunity regardless of race, color, ancestry, religion, sex, national origin, sexual orientation, age, citizenship, marital status, disability, gender identity or Veteran status. We also consider qualified applicants regardless of criminal histories, consistent with legal requirements. See also Google\u0027s EEO Policy and EEO is the Law. If you have a disability or special need that requires accommodation, please let us know by completing our Accommodations for Applicants form .",
    "job_functions": [],
    "linkedin_internal_id": "3046202003",
    "location": null,
    "seniority_level": null,
    "title": "Data Engineer, Google Customer Solutions",
    "total_applicants": null
}
Key Description Example
linkedin_internal_id "3046202003"
job_description "This role may also be located in our Playa Vista, CA campus.\n\nNote: By applying to this position you will have an opportunity to share your preferred working location from the following: Redwood City, CA, USA; Ann Arbor, MI, USA; Chicago, IL, USA; New York, NY, USA; Los Angeles, CA, USA.\n\nMinimum qualifications:\nBachelor\u2019s degree in Engineering, Computer Science, Information Systems, Statistics, Economics, Mathematics, Finance, a related quantitative field, or equivalent practical experience.2 years of experience in business intelligence, data engineering, data modeling, or using analytics with SQL.Experience with programming languages (e.g. Python).Experience partnering or working with stakeholders across organizational boundaries.\n\nPreferred qualifications:\n4 years of experience designing and building scalable data pipelines to enable data-driven business selections.Experience in statistical tools (e.g., R, SPSS, MATLAB, etc.).Experience in machine learning models (e.g., scikit-learn, TensorFlow, etc.).Knowledge of commercial and other reporting tools and technologies (e.g., Tableau, QlikView, D3, Microstrategy, BusinessObjects, Cognos, etc.).Ability to manage multiple projects, and communicate findings/reports to stakeholders and non-techincal audiences. Excellent verbal and written communication skills.\n\nAbout The Job\n\nAs a Data Engineer, you will use an analytical, data-driven approach to drive understanding of business changes. You will build data pipelines that enable engineers, analysts, and other stakeholders across the organization. You will also build data models to deliver insightful analytics while ensuring data integrity.\n\nWhen our millions of advertisers and publishers are happy, so are we! Our Google Customer Solutions (GCS) team of entrepreneurial, enthusiastic and client-focused members are the \"human face\" of Google, helping entrepreneurs both individually and broadly build their online presence and grow their businesses. We are dedicated to growing the unique needs of advertising companies. Our teams of strategists, analysts, advisers and support specialists collaborate closely to spot and analyze customer needs and trends. In collaboration, we create and implement business plans broadly for all types of businesses.\n\nResponsibilities\n\nBuild data pipelines, reports, best practices, and frameworks that enable analysts and stakeholders across the organization.Recognize and adopt best practices in developing pipelines and analytical insights, including data integrity, test design, analysis, validation, and documentation.Design and develop scalable and actionable solutions that provide insights to help advertisers grow.Work with stakeholders to understand feature and tool gaps and innovate on behalf of our customers.\n\nGoogle is proud to be an equal opportunity workplace and is an affirmative action employer. We are committed to equal employment opportunity regardless of race, color, ancestry, religion, sex, national origin, sexual orientation, age, citizenship, marital status, disability, gender identity or Veteran status. We also consider qualified applicants regardless of criminal histories, consistent with legal requirements. See also Google\u0027s EEO Policy and EEO is the Law. If you have a disability or special need that requires accommodation, please let us know by completing our Accommodations for Applicants form ."
apply_url null
title "Data Engineer, Google Customer Solutions"
location A JobLocation object See JobLocation object
company A JobCompany object See JobCompany object
seniority_level null
industry ["Internet"]
employment_type "Full-time"
job_functions []
total_applicants null

JobCompany

Key Description Example
name "Google"
url "https://www.linkedin.com/company/google"
logo "https://media-exp1.licdn.com/dms/image/C4D0BAQHiNSL4Or29cg/company-logo_400_400/0/1519856215226?e=1661385600\u0026v=beta\u0026t=rUecQpduLPDavL3JswjLsJAUNgSu1Q2l3JS5sGp8nHk"

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&fallback_to_cache=on-error&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/',
    'fallback_to_cache': 'on-error',
    '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/
fallback_to_cache yes Tweaks the fallback behavior if an error arises from fetching a fresh profile.

This parameter accepts the following values:
* on-error (default value) - Fallback to reading the profile from cache if an error arises.
* never - Do not ever read profile from cache.
on-error
use_cache no if-present The default behavior. 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 API will make a best effort to return a fresh profile no older than 29 days.Costs an extra 1 credit on top of the cost of the base endpoint.
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": {
                "day": 31,
                "month": 3,
                "year": 2015
            },
            "starts_at": {
                "day": 1,
                "month": 3,
                "year": 2015
            },
            "title": "gMessenger",
            "url": null
        },
        {
            "description": "A task and project management responsive web app utilizing Ruby on Rails - CSS and HTML",
            "ends_at": {
                "day": 31,
                "month": 1,
                "year": 2015
            },
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2015
            },
            "title": "Taskly",
            "url": null
        },
        {
            "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": {
                "day": 31,
                "month": 5,
                "year": 2013
            },
            "starts_at": {
                "day": 1,
                "month": 5,
                "year": 2013
            },
            "title": "Simple Wall Mount",
            "url": null
        },
        {
            "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": [],
    "articles": [],
    "background_cover_image_url": null,
    "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": null,
    "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_400_400/0/1600382740152?e=1661990400\u0026v=beta\u0026t=NE6-GRxbPCK6yoZZIHc0qn87UwdCGbBqHUglAWvnQNM",
            "school": "University of Colorado Denver",
            "school_linkedin_profile_url": null,
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2013
            }
        },
        {
            "degree_name": null,
            "description": null,
            "ends_at": {
                "day": 31,
                "month": 12,
                "year": 2015
            },
            "field_of_study": "School of Software Development",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C4E0BAQG1D1RHEvbQZQ/company-logo_400_400/0/1519872735270?e=1661990400\u0026v=beta\u0026t=aQWFCArK9d_gc1XvWDonalqfEE7SvJKsGKAYE3rLad4",
            "school": "Galvanize Inc",
            "school_linkedin_profile_url": null,
            "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_400_400/0/1519856111543?e=1661990400\u0026v=beta\u0026t=BozaT-EP5L7XfWIEdosRTXy1t6aVEvLY9DFV2YNo35I",
            "school": "Fort Lewis College",
            "school_linkedin_profile_url": null,
            "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": null,
            "description": null,
            "ends_at": {
                "day": 31,
                "month": 12,
                "year": 2000
            },
            "field_of_study": "Spanish Language and Literature",
            "logo_url": null,
            "school": "Inter American University of Puerto Rico",
            "school_linkedin_profile_url": null,
            "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": null,
            "ends_at": null,
            "location": null,
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQEYxazZM_hXgQ/company-logo_400_400/0/1634934418976?e=1661990400\u0026v=beta\u0026t=OPaZ-Z2rkcMyincCywvRt8cg0sxTajgPBm9UksHjGQ4",
            "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": null,
            "ends_at": null,
            "location": "Denver, Colorado, United States",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQF9QJVQm3SOvA/company-logo_400_400/0/1614527476576?e=1661990400\u0026v=beta\u0026t=l9AUZlO1BwfdEfjeRtD1wLQEZ7-pi6vrgJs9sfQBBrE",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2021
            },
            "title": "Founder"
        },
        {
            "company": "Project 1B",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/project-1b/",
            "description": null,
            "ends_at": null,
            "location": "Denver, Colorado, United States",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQFG_MrwBC_iZg/company-logo_400_400/0/1594610187483?e=1661990400\u0026v=beta\u0026t=HiYBoS9-DC_jqsPJLZO5fw2KvwnGNdFMwiT-PbEiR2Y",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2020
            },
            "title": "Founder"
        },
        {
            "company": "Product School",
            "company_linkedin_profile_url": "https://www.linkedin.com/school/product-school/",
            "description": null,
            "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_400_400/0/1648642857246?e=1661990400\u0026v=beta\u0026t=41GQaQ09Hr1HRJ3fIAuEEcVW_DwHdfaWpygTPESCZLk",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2020
            },
            "title": "Featured Speaker"
        },
        {
            "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_400_400/0/1612205615891?e=1661990400\u0026v=beta\u0026t=N3_3zvgg5WFQf3T7gVn_SJbvNh_QVyDCsY90Vdgt9mk",
            "starts_at": {
                "day": 1,
                "month": 3,
                "year": 2017
            },
            "title": "Sr. Product Manager - New Business Innovation"
        },
        {
            "company": "YouTube",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/youtube/",
            "description": null,
            "ends_at": null,
            "location": "Greater Seattle Area",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C4D0BAQEfoRsyU4yUzg/company-logo_400_400/0/1631053379295?e=1661990400\u0026v=beta\u0026t=2UZrnMBcR30gmVXQokskMU9uEJdKCUWBMP0cc0XXFL8",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2017
            },
            "title": "YouTube Content Creator - \"Tech Careers for Non-Engineers\""
        },
        {
            "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_400_400/0/1523269243842?e=1661990400\u0026v=beta\u0026t=oAtQoOa5eWnF_YXSryRIx1iHOOOhsdY66n1IM9xhDQI",
            "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": null,
            "ends_at": {
                "day": 31,
                "month": 7,
                "year": 2014
            },
            "location": "Denver Colorado",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C4E0BAQHofg3toK4P7A/company-logo_400_400/0/1519903210468?e=1661990400\u0026v=beta\u0026t=CAnMz0EFbjC6V02zjRTxGMBzz_DNSOb2jOAAJA7j2yw",
            "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": null,
            "ends_at": {
                "day": 31,
                "month": 5,
                "year": 2014
            },
            "location": "Miami, Florida",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQFV1hvbuwyU-A/company-logo_400_400/0/1519867781218?e=1661990400\u0026v=beta\u0026t=i0NiPqLjL_CjufUK2JVS-quR-BY9AcUE5vmUaKJzYOI",
            "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": null,
            "ends_at": {
                "day": 31,
                "month": 1,
                "year": 2012
            },
            "location": "Durango Colorado",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQHI-DLifzJs9Q/company-logo_400_400/0/1519868629336?e=1661990400\u0026v=beta\u0026t=G03JfwFjKqfZa8A0_nHHlQIpQQfjzupeXb-14Pjj3aM",
            "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": [],
    "headline": "Financial Freedom through Real Estate - LinkedIn Top Voice",
    "industry": null,
    "inferred_salary": {
        "max": null,
        "min": null
    },
    "interests": [],
    "languages": [
        "English",
        "Japanese",
        "Spanish"
    ],
    "last_name": "Marty",
    "occupation": "Co-Founder at Freedom Fund Real Estate",
    "people_also_viewed": [
        {
            "link": "https://www.linkedin.com/in/belenwagaw",
            "location": null,
            "name": "Belen Wagaw",
            "summary": "Founding an agency to help corporate and startup execs grow their personal brands on LinkedIn | Coaching ambitious 9-5ers in tech to make corporate work for them | Chief Storyteller | Re-framing Imposter Syndrome \ud83d\udca1"
        },
        {
            "link": "https://www.linkedin.com/in/hollylee",
            "location": null,
            "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/warikoo",
            "location": null,
            "name": "Ankur Warikoo",
            "summary": "Founder nearbuy.com, Mentor, Angel Investor, Public Speaker"
        },
        {
            "link": "https://www.linkedin.com/in/renoperry",
            "location": null,
            "name": "Reno Perry",
            "summary": "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/chloe-shih",
            "location": null,
            "name": "Chloe Shih",
            "summary": "Product @ Discord \u2022 Content Creator \u2022 Previously Meta, TikTok, Google"
        },
        {
            "link": "https://www.linkedin.com/in/salvatore-caroniti",
            "location": null,
            "name": "Salvatore Caroniti RN, BSN",
            "summary": "Helping others accelerate financial freedom through real estate"
        },
        {
            "link": "https://www.linkedin.com/in/jonathan-wonsulting",
            "location": null,
            "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": null,
            "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/clementmihailescu",
            "location": null,
            "name": "Clement Mihailescu",
            "summary": "Co-Founder \u0026 CEO, AlgoExpert | Ex-Google \u0026 Ex-Facebook Software Engineer | LinkedIn Top Voice"
        },
        {
            "link": "https://www.linkedin.com/in/timsalau",
            "location": null,
            "name": "Tim Dr. FoW S.",
            "summary": "Enterprise Team Captain @ Guide"
        }
    ],
    "personal_emails": [],
    "personal_numbers": [],
    "profile_pic_url": "https://media-exp1.licdn.com/dms/image/C5603AQHaJSx0CBAUIA/profile-displayphoto-shrink_400_400/0/1558325759208?e=1659571200\u0026v=beta\u0026t=JQVFaM3Y-WfuSOkHwh6pAYQ6kwkbqUIWNkxAIP3pVoo",
    "public_identifier": "johnrmarty",
    "recommendations": [
        "Rebecca Canfield\n\n\n\nJohn 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 \u201cpay it forward\u201d 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\nJohn 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!",
        "John White\n\n\n\nJohn is a positive force for change.  Specifically ones personal change to be better, do better and give more.  His LinkedIn sessions, job growth, personal branding on Clubhouse are incredibly helpful and empowering.  He communicates the importance of branding elements in easy to understand sessions.  Mahalo for improving us all.",
        "Tony Jarvis\n\n\n\nJohn is laser focused on unlocking the potential in others and bringing out the very best they have to offer. Having built a loyal community around his core values, it\u0027s easy to see why he\u0027s highly respected.\n\nI\u0027ve personally seen scores of his followers directly benefit as a result of his deep insights around the technology industry. It doesn\u0027t matter whether you\u0027re a student, early career professional or have years of experience - his perspectives are equally valuable to all.",
        "Paul Shrewsbury\n\n\n\nJohn is one of the most talented people I\u0027ve come across.  He has the ability to focus and still see the big picture.  He is very creative and still manages to see problems analytically.  He really knows how to communicate, inspire, lead and also roll up his sleeves and work hard next to his peers.  A truly great person.",
        "Rufus J. Brown\n\n\n\nLaser-like focus and dedication are the qualities that come to mind when I think about John Marty. I have had the pleasure of working closely with John this past year as a fellow student enrolled in CU Denver\u2019s Executive MBA program. I\u2019ve always been impressed by John\u2019s ability to quickly grasp analytical concepts. No matter how hard an upcoming test or project, he always keeps his cool and offers a helping hand when someone is struggling.  John is a natural leader that earns my highest recommendation.",
        "Jerry J. Marty, MD, MBA\n\n\n\nThe three attributes above best describe John R. Marty, but he is also a business-client focused individual who is conscientious, hard-working and thorough in analysis and the expected business deliverable(s).",
        "Evan Manning\n\n\n\nJohn and I worked together in groups for several senior level marketing and business classes. John was a pleasure to work with and he always contributed more than his share to the group. \r\n\r\nAfter graduating John has moved on to build a very successful business. I have also worked with John as his credit card processor  while he owned Axxis Audio. John is a pleasure to know as a friend and a business partner."
    ],
    "similarly_named_profiles": [],
    "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_400_400/0/1625244393084?e=1661990400\u0026v=beta\u0026t=p-iuBVUMo2DCW-ue3D2ybkr0_wdiUPfwKPqAwrO3SNw",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2018
            },
            "title": "Mentor"
        }
    ]
}
Key Description Example
public_identifier The vanity identifier of the public LinkedIn profile. The vanity identifier comes after the /in/ part of the LinkedIn Profile URL in the following format: https://www.linkedin.com/in/<public_identifier> "johnrmarty"
profile_pic_url A temporary link to the user's profile picture that is valid for 30 minutes. The temporal nature of the link is by design to prevent having Proxycurl be the mirror for the images. The developer is expected to handle these images by downloading the image and re-hosting the image. See this post for context.

Some profile pictures might be of the standard LinkedIn's profile picture placeholder. It is so because. See this post for context.
"https://media-exp1.licdn.com/dms/image/C5603AQHaJSx0CBAUIA/profile-displayphoto-shrink_400_400/0/1558325759208?e=1659571200\u0026v=beta\u0026t=JQVFaM3Y-WfuSOkHwh6pAYQ6kwkbqUIWNkxAIP3pVoo"
background_cover_image_url A temporary link to the user's background cover picture that is valid for 30 minutes. The temporal nature of the link is by design to prevent having Proxycurl be the mirror for the images. The developer is expected to handle these images by downloading the image and re-hosting the image. See this post for context. null
first_name First name of the user. "John"
last_name Last name of the user. "Marty"
full_name Full name of the user (first_name + last_name) "John Marty"
occupation The title and company name of the user's current employment. "Co-Founder at Freedom Fund Real Estate"
headline The tagline written by the user for his profile. "Financial Freedom through Real Estate - LinkedIn Top Voice"
summary A blurb (longer than the tagline) written by the user for his profile. "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 The user's country of residence depicted by a 2-letter country code (ISO 3166-1 alpha-2). "US"
country_full_name The user's country of residence, in English words. "United States of America"
city The city that the user is living at. "Seattle"
state The state that the user is living at. "Washington"
experiences The user's list of historic work experiences. See Experience object
education The user's list of education background. See Education object
languages A list of languages that the user claims to be familiar with, and has added to his/her profile.

Do note that we do not have the proficiency level as that data point is not available on a public LinkedIn profile.
["English", "Japanese", "Spanish"]
accomplishment_organisations List of noteworthy organizations that this user is part of. See AccomplishmentOrg object
accomplishment_publications List of noteworthy publications that this user has partook in. See Publication object
accomplishment_honors_awards List of noteworthy honours and awards that this user has won. See HonourAward object
accomplishment_patents List of noteworthy patents won by this user. See Patent object
accomplishment_courses List of noteworthy courses partook by this user. See Course object
accomplishment_projects List of noteworthy projects undertaken by this user. See Project object
accomplishment_test_scores List of noteworthy test scores accomplished by this user. See TestScore object
volunteer_work List of historic volunteer work experiences. See VolunteeringExperience object
certifications List of noteworthy certifications accomplished by this user. See Certification object
connections Total count of LinkedIn connections. null
people_also_viewed A list of other LinkedIn profiles closely related to this user. See PeopleAlsoViewed object
recommendations List of recommendations made by other users about this profile. ["Professional and dedicated approach towards clients and collegues."]
activities A list of LinkedIn status activities. See Activity object
similarly_named_profiles A list of other LinkedIn profiles with similar names. See SimilarProfile object
articles A list of content-based articles posted by this user. See Article object
groups A list of LinkedIn groups that this user is a part of. See PersonGroup object
skills A list of keyword-based skills that this user boasts of on his LinkedIn profile. ["branding", "cad tools", "art"]
inferred_salary A salary range inferred from the user's current job title and company. See InferredSalary object
gender Gender of the user. "male"
birth_date Birth date of the user. See Date object
industry Industry that the user works in. "government administration"
interests A list of interests that the user has. ["education", "health", "human rights"]
extra A bundle of extra data on this user. See PersonExtra object
personal_emails A list of personal emails associated with this user. ["[email protected]", "[email protected]", "[email protected]@outlook.com"]
personal_numbers A list of personal mobile phone numbers associated with this user. ["+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 null
location null
logo_url URL of the logo of the organisation. "https://media-exp1.licdn.com/dms/image/C560BAQEYxazZM_hXgQ/company-logo_400_400/0/1634934418976?e=1661990400\u0026v=beta\u0026t=OPaZ-Z2rkcMyincCywvRt8cg0sxTajgPBm9UksHjGQ4"

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 null
description null
logo_url "https://media-exp1.licdn.com/dms/image/C560BAQGbanOkHdRLiQ/company-logo_400_400/0/1600382740152?e=1661990400\u0026v=beta\u0026t=NE6-GRxbPCK6yoZZIHc0qn87UwdCGbBqHUglAWvnQNM"

Date

Key Description Example
day 1
month 1
year 2013

AccomplishmentOrg

Key Description Example
starts_at A Date object See Date object
ends_at A Date object See Date object
org_name "Microsoft"
title "Software Developer"
description null

Date

Key Description Example
day 1
month 1
year 2012

Publication

Key Description Example
name Name of the publication. "Nobel Peace Prize"
publisher The publishing organisation body. "Acme Corp"
published_on Date of publication. See Date object
description Description of the publication. "Lorem ipsum dolor sit amet, consectetur adipiscing elit"
url URL of the publication. "https://example.com"

Date

Key Description Example
day 1
month 1
year 1970

HonourAward

Key Description Example
title Title of the honour/award. "Nobel Peace Prize"
issuer The organisation body issuing this honour/award. "Acme Corp"
issued_on Date that this honour/awared was issued. See Date object
description Description of the honour/award. "Lorem ipsum dolor sit amet, consectetur adipiscing elit"

Date

Key Description Example
day 1
month 1
year 1970

Patent

Key Description Example
title Title of the patent. "The art of war"
issuer The organisation body that issued the patent. "Acme Corp"
issued_on Date of patent issuance. See Date object
description Description of the patent. "Lorem ipsum dolor sit amet, consectetur adipiscing elit"
application_number Numerical representation that identifies the patent. "123"
patent_number Application number of the patent. "123"
url null

Date

Key Description Example
day 1
month 1
year 1970

Course

Key Description Example
name Name of the course "The course about ABCs"
number The numerical representation of the course "123"

Project

Key Description Example
starts_at A Date object See Date object
ends_at A Date object See Date object
title Name of the project that has been or is currently being worked on. "gMessenger"
description Description of the project. "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 A web location related to the project. null

Date

Key Description Example
day 1
month 3
year 2015

TestScore

Key Description Example
name Title of the course for which test score was derived from. "CS1101S"
score Test score "A"
date_on Date of test was assesed. See Date object
description Description of the test score. "Nailed it without studying."

Date

Key Description Example
day 1
month 1
year 2010

VolunteeringExperience

Key Description Example
starts_at A Date object See Date object
ends_at A Date object See Date object
title Name of volunteer activity. "Mentor"
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/"
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_400_400/0/1625244393084?e=1661990400\u0026v=beta\u0026t=p-iuBVUMo2DCW-ue3D2ybkr0_wdiUPfwKPqAwrO3SNw"

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
name Name of the course or program. "SAFe Agile Framework Practitioner - ( Scrum, XP, and Lean Practices in the SAFe Enterprise)"
license_number null
display_source null
authority The organisation body issuing this certificate. "Scaled Agile, Inc."
url null

PeopleAlsoViewed

Key Description Example
link URL of the profile.

Useable with Person profile endpoint
"https://www.linkedin.com/in/belenwagaw"
name "Belen Wagaw"
summary `"Founding an agency to help corporate and startup execs grow their personal brands on LinkedIn
location null

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 This profile's Github account. "github-username"
facebook_profile_id This profile's Facebook account. "facebook-username"
twitter_profile_id This profile's twitter account. "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 The default behavior. 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 API will make a best effort to return a fresh profile no older than 29 days.Costs an extra 1 credit on top of the cost of the base endpoint.
if-present

Response

{
    "background_cover_image_url": "https://media-exp1.licdn.com/dms/image/C4D1BAQH9RnIm5udicQ/company-background_10000/0/1519796779731?e=1654585200\u0026v=beta\u0026t=OpKFclmBc0ERcn8EiRImFXJrsVmNXlXOD9JpJx5NJQA",
    "company_size": [
        5001,
        10000
    ],
    "company_size_on_linkedin": 15199,
    "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.\r\rAt NUS, we believe in education, research and service that change lives.",
    "follower_count": 470304,
    "founded_year": 1905,
    "hq": {
        "city": "Singapore",
        "country": "SG",
        "is_hq": true,
        "line_1": "21 Lower Kent Ridge Road, Singapore",
        "postal_code": "119077",
        "state": null
    },
    "industry": "Higher Education",
    "linkedin_internal_id": "5524",
    "locations": [
        {
            "city": "Singapore",
            "country": "SG",
            "is_hq": true,
            "line_1": "21 Lower Kent Ridge Road, Singapore",
            "postal_code": "119077",
            "state": null
        }
    ],
    "name": "National University of Singapore",
    "profile_pic_url": "https://media-exp1.licdn.com/dms/image/C4D0BAQGvBq9cz6AIIQ/company-logo_400_400/0/1519856127538?e=1661990400\u0026v=beta\u0026t=K6ND2NedE8iKNY9YKoQXhDCl773XebFKY0VbX-5sATA",
    "search_id": "5524",
    "similar_companies": [
        {
            "industry": "Education Management",
            "link": "https://www.linkedin.com/school/nus-business-school/",
            "location": null,
            "name": "NUS Business School"
        },
        {
            "industry": "Higher Education",
            "link": "https://www.linkedin.com/school/nusfass/",
            "location": null,
            "name": "NUS Faculty of Arts and Social Sciences"
        },
        {
            "industry": "Research",
            "link": "https://www.linkedin.com/company/solar-energy-research-institute-of-singapore-seris",
            "location": null,
            "name": "Solar Energy Research Institute of Singapore"
        },
        {
            "industry": "Higher Education",
            "link": "https://www.linkedin.com/school/duke-nus/",
            "location": null,
            "name": "Duke-NUS Medical School"
        },
        {
            "industry": "Professional Training \u0026 Coaching",
            "link": "https://www.linkedin.com/company/iss_nus",
            "location": null,
            "name": "Institute of Systems Science, National University of Singapore"
        },
        {
            "industry": "Higher Education",
            "link": "https://www.linkedin.com/company/nusfst",
            "location": null,
            "name": "NUS Department of Food Science and Technology"
        },
        {
            "industry": "Education Management",
            "link": "https://www.linkedin.com/company/centre-for-future-ready-graduates",
            "location": null,
            "name": "NUS Centre for Future-ready Graduates"
        }
    ],
    "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. "5524"
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.\r\rAt 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 15199
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 "https://media-exp1.licdn.com/dms/image/C4D0BAQGvBq9cz6AIIQ/company-logo_400_400/0/1519856127538?e=1661990400\u0026v=beta\u0026t=K6ND2NedE8iKNY9YKoQXhDCl773XebFKY0VbX-5sATA"
background_cover_image_url "https://media-exp1.licdn.com/dms/image/C4D1BAQH9RnIm5udicQ/company-background_10000/0/1519796779731?e=1654585200\u0026v=beta\u0026t=OpKFclmBc0ERcn8EiRImFXJrsVmNXlXOD9JpJx5NJQA"
search_id Useable with Job listing endpoint "5524"
similar_companies List of SimilarCompany See SimilarCompany object
updates List of CompanyUpdate See CompanyUpdate object
follower_count 470304

CompanyLocation

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

SimilarCompany

Key Description Example
name "NUS Business School"
link "https://www.linkedin.com/school/nus-business-school/"
industry "Education Management"
location null

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 API

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 Company extra when extra=include See CompanyDetails object
funding_data Company Funding data when funding_data=include 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 Date by which this event was announced 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 Date by which this event was announced 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 Date of founding 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 The date by which this public company went public 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 Date of announcement 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