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

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 scrape the profile and found that it is missing.

Timeouts and API response time

The endpoints in our LinkedIn crawler take an average of 2 seconds to complete.

You are encouraged to make concurrent requests to our API service to maximize 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 paramters provided. Refer to the documentation and message body for more info
401 Invalid API Key
403 You have run out of credit
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 Scrape 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?
LinkedIn (Company) Profile URL List of open job position Jobs Listing Endpoint
LinkedIn (Company) Profile URL Detailed job data Job Profile Endpoint

People API

What you have What you get Which API Endpoint to use?
LinkedIn (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

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

LinkedIn 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, Canada, Israel and Singapore. As such, this endpoint is best used to list employees working in companies based in the US, Canada, Israel 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 crawl.

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

LinkedIn Employee Listing Endpoint

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

Cost: 5 credits / employee returned 3 credits / employee returned. (Temporary discount until 30st September 2021). Minimum cost of this endpoint is 10 credits.

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 and Singapore. As such, this endpoint is best used to list employees working in companies based in the US, UK, Canada, Israel and Singapore only.

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

api_endpoint = 'https://nubela.co/proxycurl/api/linkedin/company/employees/'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
params = {
    '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 return past or current employees.

Valid values are current, past, and all:

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

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

ProfileUrl

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

LinkedIn 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=nubela.co&company_name=Nubela
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': 'nubela.co',
    'company_name': 'Nubela',
}
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 nubela.co
company_name Requires either company_domain or company_name Company Name Nubela

Response

{
    "url": "https://sg.linkedin.com/company/nubela"
}
Key Description Example
url "https://sg.linkedin.com/company/nubela"

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.

LinkedIn Company Profile Endpoint

GET /proxycurl/api/linkedin/company

Cost: 1 credit / successful request.

Get structured data of a LinkedIn Company Profile

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    https://nubela.co/proxycurl/api/linkedin/company?categories=include&funding_data=include&extra=include&exit_data=include&acquisitions=include&url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fmicrosoft%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 = {
    'categories': 'include',
    'funding_data': 'include',
    'extra': 'include',
    'exit_data': 'include',
    'acquisitions': 'include',
    'url': 'https://www.linkedin.com/company/microsoft/',
    'use_cache': 'if-present',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
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/microsoft/
use_cache no if-present Fetches profile from cache regardless of age of profile. If not available in cache, perform a live scrape.

if-recent The default behavior. Return profile from cache if it is less than or equal to 29 days. Otherwise, perform a live scrape. If live scraping fails, we will return a profile from cache regardless of age of profile.
if-present

Response

{
    "acquisitions": {
        "acquired": [
            {
                "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": 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": 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%2F20211105%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20211105T050317Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=91693cc75a0452443bc70c3a1a3ff544e0ed28e6d3b0ed4ec0c57cbbc77e5f90",
    "categories": [
        "consumer-electronics",
        "electronics",
        "hardware",
        "mobile-devices",
        "retail",
        "software"
    ],
    "company_size": [
        10001,
        null
    ],
    "company_size_on_linkedin": 292676,
    "company_type": "PUBLIC_COMPANY",
    "description": "We\u2019re a diverse collective of thinkers and doers, continually reimagining what\u2019s possible to help us all do what we love in new ways. And the same innovation that goes into our products also applies to our practices \u2014 strengthening our commitment to leave the world better than we found it. This is where your work can make a difference in people\u2019s lives. Including your own.Apple is an equal opportunity employer that is committed to inclusion and diversity. Visit apple.com/careers to learn more.",
    "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"
        }
    ],
    "extra": {
        "company_type": "For Profit",
        "contact_email": null,
        "crunchbase_rank": 30,
        "facebook_id": "apple",
        "founding_date": {
            "day": 1,
            "month": 4,
            "year": 1976
        },
        "ipo_date": null,
        "ipo_status": "Public",
        "number_of_acquisitions": 123,
        "number_of_exits": 10,
        "number_of_funding_rounds": 6,
        "number_of_investments": 20,
        "number_of_investors": 6,
        "number_of_lead_investments": 14,
        "number_of_lead_investors": 3,
        "operating_status": "Active",
        "phone_number": "(408)996-1010",
        "stock_symbol": "NASDAQ:AAPL",
        "total_fund_raised": 300000000,
        "total_funding_amount": 6200000000,
        "twitter_id": "apple"
    },
    "follower_count": 14989453,
    "founded_year": 1976,
    "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/27576",
                    "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": "Consumer Electronics",
    "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": "https://s3.us-west-000.backblazeb2.com/proxycurl/company/apple/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=0004d7f56a0400b0000000001%2F20211105%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20211105T050317Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=c9f5a4513eb29492d839ee7188cf90aa7328b496f66b32ca96baa40ee9198e19",
    "search_id": "162479",
    "similar_companies": [
        {
            "industry": "Internet",
            "link": "https://www.linkedin.com/company/google",
            "location": "Mountain View, CA",
            "name": "Google"
        },
        {
            "industry": "Internet",
            "link": "https://www.linkedin.com/company/amazon",
            "location": "Seattle, WA",
            "name": "Amazon"
        },
        {
            "industry": "Computer Software",
            "link": "https://www.linkedin.com/company/microsoft",
            "location": "Redmond, Washington",
            "name": "Microsoft"
        },
        {
            "industry": "Automotive",
            "link": "https://www.linkedin.com/company/tesla-motors",
            "location": "Palo Alto, CA",
            "name": "Tesla"
        },
        {
            "industry": "Internet",
            "link": "https://www.linkedin.com/company/facebook",
            "location": "Menlo Park, CA",
            "name": "Facebook"
        },
        {
            "industry": "Entertainment",
            "link": "https://www.linkedin.com/company/netflix",
            "location": "Los Gatos, CA",
            "name": "Netflix"
        },
        {
            "industry": "Information Technology and Services",
            "link": "https://www.linkedin.com/company/ibm",
            "location": "Armonk, New York, NY",
            "name": "IBM"
        },
        {
            "industry": "Consumer Electronics",
            "link": "https://kr.linkedin.com/company/samsung-electronics",
            "location": "Suwon-Si, Gyeonggi-Do",
            "name": "Samsung Electronics"
        },
        {
            "industry": "Sporting Goods",
            "link": "https://www.linkedin.com/company/nike",
            "location": "Beaverton, OR",
            "name": "Nike"
        },
        {
            "industry": "Food \u0026 Beverages",
            "link": "https://ch.linkedin.com/company/nestle-s-a-",
            "location": null,
            "name": "Nestl\u00e9"
        }
    ],
    "specialities": [
        "Innovative Product Development",
        "World-Class Operations",
        "Retail",
        "Telephone Support"
    ],
    "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 "We\u2019re a diverse collective of thinkers and doers, continually reimagining what\u2019s possible to help us all do what we love in new ways. And the same innovation that goes into our products also applies to our practices \u2014 strengthening our commitment to leave the world better than we found it. This is where your work can make a difference in people\u2019s lives. Including your own.Apple is an equal opportunity employer that is committed to inclusion and diversity. Visit apple.com/careers to learn more."
website "http://www.apple.com/careers"
industry "Consumer Electronics"
company_size Listed range of company head count [10001, null]
company_size_on_linkedin 292676
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 1976
specialities ["Innovative Product Development", "World-Class Operations", "Retail", "Telephone Support"]
locations List of CompanyLocation See CompanyLocation object
name "Apple"
tagline "Think Different - But Not Too Different"
universal_name_id "apple"
profile_pic_url "https://s3.us-west-000.backblazeb2.com/proxycurl/company/apple/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=0004d7f56a0400b0000000001%2F20211105%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20211105T050317Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=c9f5a4513eb29492d839ee7188cf90aa7328b496f66b32ca96baa40ee9198e19"
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%2F20211105%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20211105T050317Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=91693cc75a0452443bc70c3a1a3ff544e0ed28e6d3b0ed4ec0c57cbbc77e5f90"
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 14989453
acquisitions An Acquisition object See Acquisition object
exit_data List of Exit See Exit object
extra A CompanyDetails object See CompanyDetails object
funding_data List of Funding See Funding object
categories A list of categories` ["artificial-intelligence", "virtual-reality"]

CompanyLocation

Key Description Example
country "US"
city "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 "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 A Date object See Date object
price Price of acquisition 300000000

Date

Key Description Example
day 1
month 4
year 1976

Acquisitor

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

Date

Key Description Example
day 6
month 3
year 2020

Exit

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

CompanyDetails

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

Date

Key Description Example
day 1
month 1
year 2000

Funding

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

Date

Key Description Example
day 1
month 1
year 2001

Investor

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

Contact API

Reverse Work Email Lookup Endpoint

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

Cost: 3 credits / successful request.

Resolve LinkedIn Profile from a work email address

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    https://nubela.co/proxycurl/api/linkedin/profile/resolve/email?work_email=steven%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://sg.linkedin.com/in/steven-goh-6738131b"
}
Key Description Example
url "https://sg.linkedin.com/in/steven-goh-6738131b"

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: 10 credits / request 3 credits / request. (Temporary discount until 31st November 2021).

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.

For some profiles, email addresses are returned immediately when the endpoint is called. For such requests, we will respond with a 200 status code. Credits will be consumed immediately

Some profiles require more time to extract email address from. For such requests, we will respond with a 202 status code. No credits are consumed.

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

Alternatively, you can also poll (repeat the request) our API and we will return the result once it is successful.

Successful responses to requests are cached for up to 24 hours. We will also not charge you for the same request in a 24 hour window

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%2Fsteven-goh-6738131b&cache=no-cache&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/steven-goh-6738131b',
    'cache': 'no-cache',
    '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/steven-goh-6738131b
cache no The default cache behavior is no-cache, for which we will begin a fresh search
for every request. This maximises the success rate of finding a valid email address.
If you do NOT want to be charged for requests that do not return you any email address,
you should use cache-only so that we only return cached results and will not begin an
exhuastive search for a valid email address.
Possible values are: no-cache, cache-only
no-cache
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 not ready and requires more time to be processed. The API will send
results to you via callback if a callback URL is provided. Or you can poll the API for
results later.
200 The result is ready and returned in the response. Result might include a result of "no
email found".

Response

{
    "email": "[email protected]",
    "status": "email_found"
}
Key Description Example
email Email address of the profile. null` is returned if email is not found. "[email protected]"
status Returns the status of the result of email extraction.

Possible return values are email_found, scraping, email_not_found.

If status is scraping, the status code returned will be 202.
"email_found"

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?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 = {
    '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
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]"
    ]
}
Key Description Example
emails A list of personal emails ["[email protected]", "[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": true
}
Key Description Example
is_disposable_email Returns a boolean value of the disposable nature of the given email address true

Jobs API

LinkedIn Jobs Listing Endpoint

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

Cost: 1 credit / successful request.

List jobs posted by a company on LinkedIn

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

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

URL Parameters

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

Response

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

Job

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

LinkedIn Job Profile Endpoint

GET /proxycurl/api/linkedin/job

Cost: 1 credit / successful request.

Get structured data of a LinkedIn Job Profile

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    https://nubela.co/proxycurl/api/linkedin/job?url=https%3A%2F%2Fwww.linkedin.com%2Fjobs%2Fview%2F2794284647%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/2794284647/',
}
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 crawl.

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

Response

{
    "apply_url": "https://sg.linkedin.com/jobs/view/externalApply/2767825354?url=https%3A%2F%2Fjobs%2Eaon%2Ecom%2Fjobs%2F48948%3Flang%3Den-us%26previousLocale%3Den-US\u0026urlHash=7f1q\u0026trk=public_jobs_apply-link-offsite",
    "company": {
        "logo": "https://media-exp1.licdn.com/dms/image/C4D0BAQE3m3K7hD4Hzg/company-logo_100_100/0/1632417916300?e=1643846400\u0026v=beta\u0026t=F69rOHYNRciDW3euq1GHotEgcbF-IIhta60Fi-2qsjg",
        "name": "Aon",
        "url": "https://uk.linkedin.com/company/aon"
    },
    "employment_type": "Full-time",
    "industry": [
        "Financial Services"
    ],
    "job_description": "Aon is currently recruiting a Director - Wealth Management to join our team in Singapore. About AonHeadquartered in London, Aon Plc is a leading global professional services firm providing a broad range of risk, retirement and health solutions. Our 50,000 colleagues in 120 countries empower results for clients by using proprietary data and analytics to deliver insights that reduce volatility and improve performance. At Aon, you\u2019ll be part of a team which will support and inspire you and provide the opportunities and resources to develop your skills. It\u2019s an environment which encourages you to achieve your best - together we\u2019ll empower results.  ResponsibilitiesAn Integrator across Aon\u0027s capabilities across Performance \u0026 Rewards Solutions, Client Insights and Assessment Solutions the incumbent will focus on:Relationship Management with sophisticated clients in the wealth management space covering but not limited to Private Banks, Family Offices, Fintechs , External Asset Managers etc. Developing and maintaining relationships with c-suites like COO, CFO and CHRO would be keyRepresenting Aon\u0027s human capital solutions in front of clients while working collaboratively with teams across solutions and geographiesResponsible for project management and post delivery review to ensure high degree of client satisfactionManaging a team of consultants working across specialised areas spanning data, research and advisoryAs a senior member of the team in the SG office, responsible for team engagement Requirements  Possesses good knowledge of the Wealth Management / Private banking industryExcellent influencing skills and a high degree of empathy to facilitate better decision makingPrior team management experience in a fast paced and diverse environmentAbility to deal with ambiguity and energize teams in a high-performance environment How to ApplyYour opportunity to empower results could start right here. Make your mark and apply online today with a brief covering letter and your resume, sharing relevant achievements for this position. We Offer YouA competitive total rewards package, continuing education \u0026 training, and tremendous potential with a growing worldwide organization. Our Colleague ExperienceEvery day, our colleagues make a difference, work with the best, own their potential, and value one another. Together, we share this one purpose: to empower economic and human possibility around the world. This unifying goal is at the heart of our identity, and it lives in everything we do. To learn more about our colleague experience, visit Aon Colleague Experience. Aon is an equal opportunities employer. We are committed to creating a winning and inclusive culture where everyone feels valued and has opportunities for growth and development.",
    "job_functions": [
        "Consulting and Human Resources"
    ],
    "linkedin_internal_id": "2767825354",
    "location": {
        "city": "Singapore",
        "country": "SG",
        "latitude": 1.2894365,
        "longitude": 103.84998,
        "postal_code": null,
        "region": null,
        "street": null
    },
    "seniority_level": "Director",
    "title": "Director - Wealth Management",
    "total_applicants": "25"
}
Key Description Example
linkedin_internal_id "2767825354"
job_description "Aon is currently recruiting a Director - Wealth Management to join our team in Singapore. About AonHeadquartered in London, Aon Plc is a leading global professional services firm providing a broad range of risk, retirement and health solutions. Our 50,000 colleagues in 120 countries empower results for clients by using proprietary data and analytics to deliver insights that reduce volatility and improve performance. At Aon, you\u2019ll be part of a team which will support and inspire you and provide the opportunities and resources to develop your skills. It\u2019s an environment which encourages you to achieve your best - together we\u2019ll empower results. ResponsibilitiesAn Integrator across Aon\u0027s capabilities across Performance \u0026 Rewards Solutions, Client Insights and Assessment Solutions the incumbent will focus on:Relationship Management with sophisticated clients in the wealth management space covering but not limited to Private Banks, Family Offices, Fintechs , External Asset Managers etc. Developing and maintaining relationships with c-suites like COO, CFO and CHRO would be keyRepresenting Aon\u0027s human capital solutions in front of clients while working collaboratively with teams across solutions and geographiesResponsible for project management and post delivery review to ensure high degree of client satisfactionManaging a team of consultants working across specialised areas spanning data, research and advisoryAs a senior member of the team in the SG office, responsible for team engagement Requirements Possesses good knowledge of the Wealth Management / Private banking industryExcellent influencing skills and a high degree of empathy to facilitate better decision makingPrior team management experience in a fast paced and diverse environmentAbility to deal with ambiguity and energize teams in a high-performance environment How to ApplyYour opportunity to empower results could start right here. Make your mark and apply online today with a brief covering letter and your resume, sharing relevant achievements for this position. We Offer YouA competitive total rewards package, continuing education \u0026 training, and tremendous potential with a growing worldwide organization. Our Colleague ExperienceEvery day, our colleagues make a difference, work with the best, own their potential, and value one another. Together, we share this one purpose: to empower economic and human possibility around the world. This unifying goal is at the heart of our identity, and it lives in everything we do. To learn more about our colleague experience, visit Aon Colleague Experience. Aon is an equal opportunities employer. We are committed to creating a winning and inclusive culture where everyone feels valued and has opportunities for growth and development."
apply_url "https://sg.linkedin.com/jobs/view/externalApply/2767825354?url=https%3A%2F%2Fjobs%2Eaon%2Ecom%2Fjobs%2F48948%3Flang%3Den-us%26previousLocale%3Den-US\u0026urlHash=7f1q\u0026trk=public_jobs_apply-link-offsite"
title "Director - Wealth Management"
location A JobLocation object See JobLocation object
company {"logo": "https://media-exp1.licdn.com/dms/image/C4D0BAQE3m3K7hD4Hzg/company-logo_100_100/0/1632417916300?e=1643846400\u0026v=beta\u0026t=F69rOHYNRciDW3euq1GHotEgcbF-IIhta60Fi-2qsjg", "name": "Aon", "url": "https://uk.linkedin.com/company/aon"}
seniority_level "Director"
industry ["Financial Services"]
employment_type "Full-time"
job_functions ["Consulting and Human Resources"]
total_applicants "25"

JobLocation

Key Description Example
country "SG"
region null
city "Singapore"
postal_code null
latitude 1.2894365
longitude 103.84998
street null

People API

LinkedIn 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=nubela.co&location=Singapore&title=CEO&last_name=Goh&first_name=Steven
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': 'nubela.co',
    'location': 'Singapore',
    'title': 'CEO',
    'last_name': 'Goh',
    'first_name': 'Steven',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
company_domain yes Company name or domain nubela.co
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 CEO
last_name no Last name of the user Goh
first_name yes First name of the user Steven

Response

{
    "url": "https://sg.linkedin.com/in/steven-goh-6738131b"
}
Key Description Example
url "https://sg.linkedin.com/in/steven-goh-6738131b"

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: 1 credit / 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"

LinkedIn Person Profile Endpoint

GET /proxycurl/api/v2/linkedin

Cost: 1 credit / successful request.

Get structured data of a LinkedIn 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%2Fjoho-balboa%2F&use_cache=if-present
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/joho-balboa/',
    '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 Profile to crawl.

URL should be in the format of https://www.linkedin.com/in/<public-identifier>
https://www.linkedin.com/in/joho-balboa/
use_cache no if-present Fetches profile from cache regardless of age of profile. If not available in cache, perform a live scrape.

if-recent The default behavior. Return profile from cache if it is less than or equal to 29 days. Otherwise, perform a live scrape. If live scraping fails, we will return a profile from cache regardless of age of profile.
if-present

Response

{
    "accomplishment_courses": [
        {
            "name": "Sample course name",
            "number": "Sample course number"
        },
        {
            "name": "Incomplete Course",
            "number": "-"
        }
    ],
    "accomplishment_honors_awards": [
        {
            "description": "This is the desc for my honors",
            "issued_on": {
                "day": 1,
                "month": 2,
                "year": 2017
            },
            "issuer": "Sample Issuer",
            "title": "Sample honors"
        },
        {
            "description": null,
            "issued_on": null,
            "issuer": "-",
            "title": "Incomplete Awards"
        }
    ],
    "accomplishment_organisations": [
        {
            "description": null,
            "ends_at": null,
            "org_name": "Sample organization 2",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2018
            },
            "title": "-"
        },
        {
            "description": "This is my dec for sample orgz",
            "ends_at": {
                "day": 29,
                "month": 2,
                "year": 2020
            },
            "org_name": "Sample organization",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2018
            },
            "title": "Sample position held"
        },
        {
            "description": null,
            "ends_at": null,
            "org_name": "Incomplete Organization",
            "starts_at": null,
            "title": "-"
        }
    ],
    "accomplishment_patents": [
        {
            "application_number": "sample-patent-number",
            "description": "This is the desc",
            "issued_on": {
                "day": 8,
                "month": 1,
                "year": 2018
            },
            "issuer": "Indonesia",
            "patent_number": "sample-patent-number",
            "title": "Sample patent title",
            "url": "https://nubela.co/blog"
        },
        {
            "application_number": null,
            "description": null,
            "issued_on": null,
            "issuer": null,
            "patent_number": null,
            "title": "Incomplete Patent",
            "url": null
        }
    ],
    "accomplishment_projects": [
        {
            "description": "This is the desc",
            "ends_at": {
                "day": 31,
                "month": 1,
                "year": 2020
            },
            "starts_at": {
                "day": 1,
                "month": 3,
                "year": 2017
            },
            "title": "Sample project",
            "url": "https://www.google.co.id/"
        },
        {
            "description": null,
            "ends_at": null,
            "starts_at": null,
            "title": "Incomplete Project",
            "url": null
        }
    ],
    "accomplishment_publications": [
        {
            "description": "This is the description",
            "name": "Sample publication",
            "published_on": {
                "day": 3,
                "month": 1,
                "year": 2018
            },
            "publisher": "Sample publisher",
            "url": "https://www.google.co.id/"
        },
        {
            "description": null,
            "name": "Incomplete Publication",
            "published_on": null,
            "publisher": null,
            "url": null
        }
    ],
    "accomplishment_test_scores": [
        {
            "date_on": {
                "day": 1,
                "month": 1,
                "year": 2017
            },
            "description": "This is my desc for test score",
            "name": "Sample test",
            "score": "Sample score"
        },
        {
            "date_on": null,
            "description": null,
            "name": "Incomplete Test Score",
            "score": "A"
        }
    ],
    "activities": [
        {
            "activity_status": "Posted by Joho Balboa",
            "link": "https://www.linkedin.com/signup/cold-join",
            "title": "Golang is very useful for writing light-weight microservices. We currently use it for generating APIs that interact with our front-end applications\u2026"
        },
        {
            "activity_status": "Posted by Joho Balboa",
            "link": "https://www.linkedin.com/signup/cold-join",
            "title": "New Activity bro"
        }
    ],
    "articles": [
        {
            "author": "By Joho Balboa",
            "image_url": "https://media-exp1.licdn.com/dms/image/C4E12AQGLeKknc6P2cQ/article-cover_image-shrink_180_320/0/1636704383382?e=1642636800\u0026v=beta\u0026t=AJdzk7EZqrLVpuFOK_WqdTJvQ6c6Nxt7ckl3bf2yRIw",
            "link": "https://www.linkedin.com/pulse/why-use-flutter-joho-balboa",
            "published_date": {
                "day": 12,
                "month": 1,
                "year": 2021
            },
            "title": "Why Use Flutter?"
        }
    ],
    "background_cover_image_url": "http://localhost:4566/proxycurl-web-dev/person/joho-balboa/cover?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20211115%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20211115T020440Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=08c5ba3a882c172bf9ff21ced7fbf5fe92397a7d24e6acbc025027d17508b876",
    "certifications": [
        {
            "authority": "Cisco",
            "display_source": "www.google.co.id",
            "ends_at": null,
            "license_number": "ID",
            "name": "Cisco Certified Network Professional (CCNP)",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2020
            },
            "url": "https://www.google.co.id/"
        },
        {
            "authority": "Cisco",
            "display_source": "www.google.co.id",
            "ends_at": {
                "day": 28,
                "month": 2,
                "year": 2025
            },
            "license_number": "5644354",
            "name": "Cisco Certified Network Professional (CCNP)",
            "starts_at": {
                "day": 1,
                "month": 3,
                "year": 2020
            },
            "url": "https://www.google.co.id/"
        }
    ],
    "city": "Manchester",
    "connections": 2,
    "country": "UK",
    "country_full_name": "United Kingdom",
    "education": [
        {
            "degree_name": null,
            "description": null,
            "ends_at": null,
            "field_of_study": null,
            "logo_url": null,
            "school": "New sch",
            "starts_at": null
        },
        {
            "degree_name": "Bachelor\u0027s degree",
            "description": "This is my description",
            "ends_at": {
                "day": 31,
                "month": 12,
                "year": 2014
            },
            "field_of_study": "International Business",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQFBK74krMig1Q/company-logo_100_100/0/1519855919160?e=1645056000\u0026v=beta\u0026t=_E1W2l1TkcyY4CAxvpkqkC0pW7fK9WMTqRZXs7InEwI",
            "school": "Boston University",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2010
            }
        }
    ],
    "experiences": [
        {
            "company": "My Own Company",
            "company_linkedin_profile_url": null,
            "description": "This is my description for My Own Company",
            "ends_at": null,
            "location": null,
            "logo_url": null,
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2020
            },
            "title": "Developer"
        },
        {
            "company": "Microsoft",
            "company_linkedin_profile_url": "https://uk.linkedin.com/company/microsoft",
            "description": "This is my job description for Microsoft in Manchester England",
            "ends_at": {
                "day": 31,
                "month": 1,
                "year": 2020
            },
            "location": "Manchester, England, United Kingdom",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQE88xCsONDULQ/company-logo_100_100/0/1618231291419?e=1645056000\u0026v=beta\u0026t=clB4bpUSQPS79S2ZAny_lQ8Y6uocdiWGFW9N1ZJomTg",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2015
            },
            "title": "Software Engineer"
        }
    ],
    "first_name": "Joho",
    "full_name": "Joho Balboa",
    "groups": [
        {
            "name": "Test Group Name",
            "profile_pic_url": "https://media-exp1.licdn.com/dms/image/C5607AQF62kMaGFQmkQ/group-logo_image-shrink_92x92/0/1635412830265?e=1637031600\u0026v=beta\u0026t=_8VM1P8EfSGwOU9-ubaQKeT8y6u087sU2EuJVuOtBh8",
            "url": "https://www.linkedin.com/groups/14008882"
        }
    ],
    "headline": "Developer at My Own Company",
    "languages": [
        "Indonesian",
        "English"
    ],
    "last_name": "Balboa",
    "occupation": "Developer at My Own Company",
    "people_also_viewed": [
        {
            "link": "https://www.linkedin.com/in/sergiogilluque",
            "location": "New York City Metropolitan Area",
            "name": "Sergio Gil Luque",
            "summary": "Senior Software Engineer at Bloomberg LP"
        },
        {
            "link": "https://in.linkedin.com/in/mo-rustam-9b2754149",
            "location": "Bhiwandi",
            "name": "Mo Rustam",
            "summary": "Android Engineer at Proven Solution"
        },
        {
            "link": "https://fr.linkedin.com/in/morgane-jouanjan-802413197",
            "location": "Greater Paris Metropolitan Region",
            "name": "Morgane JOUANJAN",
            "summary": "Cheffe de produit"
        },
        {
            "link": "https://rs.linkedin.com/in/zoran-peko-10382713a",
            "location": "Serbia",
            "name": "Zoran Peko",
            "summary": "Business owner"
        },
        {
            "link": "https://fr.linkedin.com/in/david-de-la-ronde-8a919530",
            "location": "Paris",
            "name": "David De La Ronde",
            "summary": "Information Technology Recruiter at Compaq Computer Corporation"
        }
    ],
    "profile_pic_url": "http://localhost:4566/proxycurl-web-dev/person/joho-balboa/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20211115%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20211115T020440Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=a9c0953d114fe341fe6f50e64892af53033fe25b5e4afa1d1e69915d716dbde7",
    "public_identifier": "joho-balboa",
    "recommendations": [],
    "similarly_named_profiles": [],
    "state": "England",
    "summary": "This is my LinkedIn summary profile",
    "volunteer_work": [
        {
            "cause": "Children",
            "company": "American Red Cross",
            "company_linkedin_profile_url": "https://uk.linkedin.com/company/american-red-cross",
            "description": "This is the description",
            "ends_at": {
                "day": 31,
                "month": 8,
                "year": 2019
            },
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQFsU7FEs1NDLA/company-logo_100_100/0/1521250747760?e=1645056000\u0026v=beta\u0026t=A5Hn9R3y4wDtlfdpk8eSObPwcGg4jko_5iUwDnTEnkY",
            "starts_at": {
                "day": 1,
                "month": 3,
                "year": 2018
            },
            "title": "Mentor"
        }
    ]
}
Key Description Example
public_identifier "joho-balboa"
profile_pic_url "http://localhost:4566/proxycurl-web-dev/person/joho-balboa/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20211115%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20211115T020440Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=a9c0953d114fe341fe6f50e64892af53033fe25b5e4afa1d1e69915d716dbde7"
background_cover_image_url "http://localhost:4566/proxycurl-web-dev/person/joho-balboa/cover?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20211115%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20211115T020440Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=08c5ba3a882c172bf9ff21ced7fbf5fe92397a7d24e6acbc025027d17508b876"
first_name "Joho"
last_name "Balboa"
full_name "Joho Balboa"
occupation "Developer at My Own Company"
headline "Developer at My Own Company"
summary "This is my LinkedIn summary profile"
country "UK"
country_full_name "United Kingdom"
city "Manchester"
state "Singapore"
experiences List of Experience See Experience object
education List of Education See Education object
languages ["Indonesian", "English"]
accomplishment_organisations List of AccomplishmentOrg See AccomplishmentOrg object
accomplishment_publications List of Publication See Publication object
accomplishment_honors_awards List of HonourAward See HonourAward object
accomplishment_patents List of Patent See Patent object
accomplishment_courses List of Course See Course object
accomplishment_projects List of Project See Project object
accomplishment_test_scores List of TestScore See TestScore object
volunteer_work List of VolunteeringExperience See VolunteeringExperience object
certifications List of Certification See Certification object
connections 2
people_also_viewed List of PeopleAlsoViewed See PeopleAlsoViewed object
recommendations ["Professional and dedicated approach towards clients and collegues."]
activities List of Activity See Activity object
similarly_named_profiles List of SimilarProfile See SimilarProfile object
articles List of Article See Article object
groups List of PersonGroup See PersonGroup object

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. "My Own Company"
company_linkedin_profile_url The company's profile URL.

If present, could be used with Company Profile Endpoint for more info.
null
title "Developer"
description "This is my description for My Own Company"
location null
logo_url URL of the logo of the organisation. null

Date

Key Description Example
day 1
month 1
year 2020

Education

Key Description Example
starts_at A Date object See Date object
ends_at A Date object See Date object
field_of_study null
degree_name null
school "New sch"
description null
logo_url null

AccomplishmentOrg

Key Description Example
starts_at A Date object See Date object
ends_at A Date object See Date object
org_name "Sample organization 2"
title "-"
description null

Date

Key Description Example
day 1
month 1
year 2018

Publication

Key Description Example
name "Sample publication"
publisher "Sample publisher"
published_on A Date object See Date object
description "This is the description"
url "https://www.google.co.id/"

Date

Key Description Example
day 3
month 1
year 2018

HonourAward

Key Description Example
title "Sample honors"
issuer "Sample Issuer"
issued_on A Date object See Date object
description "This is the desc for my honors"

Date

Key Description Example
day 1
month 2
year 2017

Patent

Key Description Example
title "Sample patent title"
issuer "Indonesia"
issued_on A Date object See Date object
description "This is the desc"
application_number "sample-patent-number"
patent_number "sample-patent-number"
url "https://nubela.co/blog"

Date

Key Description Example
day 8
month 1
year 2018

Course

Key Description Example
name "Sample course name"
number "Sample course number"

Project

Key Description Example
starts_at A Date object See Date object
ends_at A Date object See Date object
title "Sample project"
description "This is the desc"
url "https://www.google.co.id/"

Date

Key Description Example
day 1
month 3
year 2017

TestScore

Key Description Example
description "This is my desc for test score"
score "Sample score"
name "Sample test"
date_on A Date object See Date object

Date

Key Description Example
day 1
month 1
year 2017

VolunteeringExperience

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

If present, could be used with Company Profile Endpoint for more info.
"https://uk.linkedin.com/company/american-red-cross"
title "Mentor"
description "This is the description"
logo_url URL of the logo of the organisation. "https://media-exp1.licdn.com/dms/image/C560BAQFsU7FEs1NDLA/company-logo_100_100/0/1521250747760?e=1645056000\u0026v=beta\u0026t=A5Hn9R3y4wDtlfdpk8eSObPwcGg4jko_5iUwDnTEnkY"

Date

Key Description Example
day 1
month 3
year 2018

Certification

Key Description Example
starts_at A Date object See Date object
ends_at A Date object See Date object
url "https://www.google.co.id/"
name "Cisco Certified Network Professional (CCNP)"
license_number "ID"
display_source "www.google.co.id"
authority "Cisco"

Date

Key Description Example
day 1
month 1
year 2020

PeopleAlsoViewed

Key Description Example
link URL of the profile.

Useable with Person profile endpoint
"https://www.linkedin.com/in/sergiogilluque"
name "Sergio Gil Luque"
summary "Senior Software Engineer at Bloomberg LP"
location "New York City Metropolitan Area"

Activity

Key Description Example
title "Golang is very useful for writing light-weight microservices. We currently use it for generating APIs that interact with our front-end applications\u2026"
link "https://www.linkedin.com/signup/cold-join"
activity_status "Posted by Joho Balboa"

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/C5607AQF62kMaGFQmkQ/group-logo_image-shrink_92x92/0/1635412830265?e=1637031600\u0026v=beta\u0026t=_8VM1P8EfSGwOU9-ubaQKeT8y6u087sU2EuJVuOtBh8"
name Name of LinkedIn group for which this user is in "Test Group Name"
url URL to the LinkedIn Group "https://www.linkedin.com/groups/14008882"

School API

LinkedIn School Profile Endpoint

GET /proxycurl/api/linkedin/school

Cost: 1 credit / successful request.

Get structured data of a LinkedIn School Profile

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

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

URL Parameters

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

URL should be in the format of https://www.linkedin.com/school/<public_identifier>
https://www.linkedin.com/school/national-university-of-singapore
use_cache no if-present Fetches profile from cache regardless of age of profile. If not available in cache, perform a live scrape.

if-recent The default behavior. Return profile from cache if it is less than or equal to 29 days. Otherwise, perform a live scrape. If live scraping fails, we will return a profile from cache regardless of age of profile.
if-present

Response

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

EDUCATIONAL: Educational Institution

GOVERNMENT_AGENCY: Government Agency

NON_PROFIT : Nonprofit

PARTNERSHIP : Partnership

PRIVATELY_HELD: Privately Held

PUBLIC_COMPANY: Public Company

SELF_EMPLOYED: Self-Employed

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

CompanyLocation

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

SimilarCompany

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

CompanyUpdate

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

Date

Key Description Example
day 30
month 9
year 2021

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