NAV
shell python

Proxycurl Overview

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

With Proxycurl API, you can

Open API 3.0

Download Proxycurl's OpenAPI 3.0 specifications.

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 \
    -G \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/v2/linkedin' \
    --data-urlencode 'url=https://www.linkedin.com/in/williamhgates'

import requests

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

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

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.

Accounts on trial (that is before any top ups have been made) are limited to 2 requests every minute. You get the normal rate limit upon making at least one credit top-up.

Rate limit for Free APIs

To sustainably provide free APIs, rate limit for free APIs depends on your subscription plan:

Credits

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

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

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

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

Timeouts and API response time

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

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

We recommend a timeout of 60 seconds.

Errors

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

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

You will never be charged for errors that represent failure. However, in our case, 404s represent successful queries that discovered a lack of data. Therefore, while we do return a status code of 404 for compatibility reasons, we do not view a lack of data as a true error, and we do charge.

Explain it to me like I'm 5

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
LinkedIn (School) Profile URL List of students Student Listing Endpoint

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
LinkedIn (Company) Profile URL Profile picture of a company Company Profile Picture Endpoint
Company name or company domain LinkedIn (Company) Profile URL Company Lookup Endpoint
LinkedIn (Company) Profile URL List of employees Employee Search 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
LinkedIn (Person) Profile URL Profile picture of a person Person Profile Picture Endpoint

Search API

What you have What you get Which API Endpoint to use?
Some parameters of companies List of companies Company Search Endpoint
Person data LinkedIn (Person) Profile URL Person Search Endpoint
LinkedIn (Company) Profile URL List of open job position Job Search Endpoint

Jobs API

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

Contact API

What you have What you get after lookup Which API Endpoint to use?
Linkedin (Person) Profile URL Work Email Address Work Email Lookup Endpoint
Twitter, Facebook, or LinkedIn (Person) Profile URL List of Personal Emails Personal Email Lookup Endpoint
Email Address Disposable Email Check Disposable email Endpoint
Email Address Twitter, Facebook, and LinkedIn (Person) Profile URL Reverse Email Lookup Endpoint
Phone Number Twitter, Facebook, and LinkedIn Profile URL Reverse Contact Number Lookup 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

Test Proxycurl API with Postman

Postman is a tool that lets you test out API services easily. We have built a Postman Collection that will let you easily test out Proxycurl API without writing code. This is how you can start testing out

Requirements

Testing out Proxycurl API with Postman

  1. Visit Proxycurl's Postman Collection, and Fork it. Give it a Fork label and Workspace, and click "Fork Collection"
  2. Go to https://web.postman.co/home and visit the Workspace for which you forked Proxycurl's Postman collection into.
  3. Click on "Proxycurl" collection under the workspace.
  4. Under the "Auth" tab, enter the Proxycurl API Key under "Token".
  5. You are done. You can now explore any Proxycurl API Endpoints by clicking into the API endpoint.
  6. To make API requests, modify parameter values and click "Send". You will see then a response.

Enrichment within Google Sheets

Sapiengraph ↗ is a Google Sheets Add-on developed and maintained by our team. It offers the same enrichment capabilities as Proxycurl but packaged as custom formulas within Google Sheets.

The functionalities of Sapiengraph within Google Sheets include:

Prerequisites

How to Get Started with Sapiengraph

  1. Visit Sapiengraph ↗ to start the onboarding process.

Libraries

Python SDK

We built Proxycurl with concurrency in mind. This is why we set out to develop our Python SDK around the various concurrency models that Python offers. proxycurl-py is our officially supported Python library published on PyPi.

proxycurl-py supports asyncio, gevent and twisted concurrency models.

proxycurl-py is tested on Python 3.7, 3.8 and 3.9.

proxycurl-py is open-sourced and has its own Github repository. So feel free to make pull requests or fork it.

Get started with proxycurl-py today by adding it to your Python 3 project with the following commands:

# install proxycurl-py with asyncio
$ pip install 'proxycurl-py[asyncio]'

# install proxycurl-py with gevent
$ pip install 'proxycurl-py[gevent]'

# install proxycurl-py with twisted
$ pip install 'proxycurl-py[twisted]'

Using proxycurl-py

Here is how you can enrich a LinkedIn Profile URL with it's profile data:

from proxycurl.asyncio import Proxycurl
import asyncio

proxycurl = Proxycurl()
person = asyncio.run(proxycurl.linkedin.person.get(
    url='https://www.linkedin.com/in/williamhgates/'
))
print('Person Result:', person)

Javascript/NodeJS SDK

You can find our Javascript/NodeJS library on Github here.

You can add install the library by running:

$ npm install proxycurl-js-linkedin-profile-scraper

School API

School Profile Endpoint

GET /proxycurl/api/linkedin/school

Cost: 1 credit / successful request.

Get structured data of a LinkedIn School Profile

curl \
    -G \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/linkedin/school' \
    --data-urlencode 'url=https://www.linkedin.com/school/national-university-of-singapore' \
    --data-urlencode 'use_cache=if-present'

import requests

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

Run in Postman

URL Parameters

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

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

if-recent API will make a best effort to return a fresh profile no older than 29 days.Costs an extra 1 credit on top of the cost of the base endpoint.
 if-present

Response

{
    "affiliated_companies": [],
    "background_cover_image_url": "https://s3.us-west-000.backblazeb2.com/proxycurl/company/national-university-of-singapore/cover?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=0004d7f56a0400b0000000001%2F20230119%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20230119T071304Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=551f456b6156e4610bc3e7be43e2f9b0e4b071db5f41f56cc0e408fc1b5a1140",
    "company_size": [
        5001,
        10000
    ],
    "company_size_on_linkedin": 16084,
    "company_type": "EDUCATIONAL_INSTITUTION",
    "description": "At NUS, we are shaping the future through our people and our pursuit of new frontiers in knowledge. In a single century, we have become a university of global influence and an Asian thought leader. Our location at the crossroads of Asia informs our mission and gives us a tremendous vantage point to help create opportunities and address the pressing issues facing Singapore, Asia and the world.\r\rAt NUS, we believe in education, research and service that change lives.",
    "follower_count": 539321,
    "founded_year": 1905,
    "hq": {
        "city": "Singapore",
        "country": "SG",
        "is_hq": true,
        "line_1": "21 Lower Kent Ridge Road, Singapore",
        "postal_code": "119077",
        "state": null
    },
    "industry": "Higher Education",
    "linkedin_internal_id": "5524",
    "locations": [
        {
            "city": "Singapore",
            "country": "SG",
            "is_hq": true,
            "line_1": "21 Lower Kent Ridge Road, Singapore",
            "postal_code": "119077",
            "state": null
        }
    ],
    "name": "National University of Singapore",
    "profile_pic_url": "https://s3.us-west-000.backblazeb2.com/proxycurl/company/national-university-of-singapore/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=0004d7f56a0400b0000000001%2F20230119%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20230119T071304Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=a66e032f168972bef4ea3821705194ea1c144415a1655bdb328f961ed30e2a24",
    "search_id": "5524",
    "similar_companies": [
        {
            "industry": "Higher Education",
            "link": "https://www.linkedin.com/school/nus-business-school/",
            "location": null,
            "name": "NUS Business School"
        },
        {
            "industry": "Higher Education",
            "link": "https://www.linkedin.com/school/nusfass/",
            "location": null,
            "name": "NUS Faculty of Arts and Social Sciences"
        },
        {
            "industry": "Research",
            "link": "https://www.linkedin.com/company/solar-energy-research-institute-of-singapore-seris",
            "location": null,
            "name": "Solar Energy Research Institute of Singapore"
        },
        {
            "industry": "Higher Education",
            "link": "https://www.linkedin.com/school/duke-nus/",
            "location": null,
            "name": "Duke-NUS Medical School"
        },
        {
            "industry": "Professional Training \u0026 Coaching",
            "link": "https://www.linkedin.com/company/iss_nus",
            "location": null,
            "name": "NUS-ISS"
        },
        {
            "industry": "Higher Education",
            "link": "https://www.linkedin.com/company/nusfst",
            "location": null,
            "name": "NUS Department of Food Science and Technology"
        },
        {
            "industry": "Education Management",
            "link": "https://www.linkedin.com/company/centre-for-future-ready-graduates",
            "location": null,
            "name": "NUS Centre for Future-ready Graduates"
        }
    ],
    "specialities": [
        "education",
        "research",
        "broad-based curriculum",
        "cross-faculty enrichment"
    ],
    "tagline": null,
    "universal_name_id": "national-university-of-singapore",
    "updates": [],
    "website": "http://nus.edu.sg"
}
Key Description Example
linkedin_internal_id
LinkedIn's Internal and immutable ID of this Company profile.
 "5524"
description
A textual description of the company.
 "At NUS, we are shaping the future through our people and our pursuit of new frontiers in knowledge. In a single century, we have become a university of global influence and an Asian thought leader. Our location at the crossroads of Asia informs our mission and gives us a tremendous vantage point to help create opportunities and address the pressing issues facing Singapore, Asia and the world.\r\rAt NUS, we believe in education, research and service that change lives."
website
The URL of the company's website.
 "http://nus.edu.sg"
industry
The industry attribute, found in a LinkedIn Company profile, describes the industry in which the company operates. The value of this attribute is an enumerator. This CSV file provides an exhaustive list of possible values for this attribute.
 "Higher Education"
company_size
Sequenceed range of company head count
 [5001, 10000]
company_size_on_linkedin
The size of the company as indicated on LinkedIn.
 16084
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
The year the company was founded.
 1905
specialities
A list of specialities.
 ["education", "research", "broad-based curriculum", "cross-faculty enrichment"]
locations
List of CompanyLocation
 See CompanyLocation object
name
The name of the company.
 "National University of Singapore"
tagline
A short, catchy phrase that represents the company's mission or brand.
 "Think Different - But Not Too Different"
universal_name_id
A unique numerical identifier for the company used in the LinkedIn platform.
 "national-university-of-singapore"
profile_pic_url
The URL of the company's profile picture.
 "https://s3.us-west-000.backblazeb2.com/proxycurl/company/national-university-of-singapore/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=0004d7f56a0400b0000000001%2F20230119%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20230119T071304Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=a66e032f168972bef4ea3821705194ea1c144415a1655bdb328f961ed30e2a24"
background_cover_image_url
The URL of the company's background cover image.
 "https://s3.us-west-000.backblazeb2.com/proxycurl/company/national-university-of-singapore/cover?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=0004d7f56a0400b0000000001%2F20230119%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20230119T071304Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=551f456b6156e4610bc3e7be43e2f9b0e4b071db5f41f56cc0e408fc1b5a1140"
search_id
Useable with Job listing endpoint
 "5524"
similar_companies
List of SimilarCompany
 See SimilarCompany object
affiliated_companies
List of AffiliatedCompany
 See AffiliatedCompany object
updates
List of CompanyUpdate
 See CompanyUpdate object
follower_count
The number of followers the company has on LinkedIn.
 539321

CompanyLocation

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

SimilarCompany

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

AffiliatedCompany

Key Description Example
name
"LinkedIn"
link
"https://www.linkedin.com/company/linkedin"
industry
"Internet"
location
"Sunnyvale, California"

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
2023

Response Headers

Header Key Description Example
X-Proxycurl-Credit-Cost Total cost of credits for this API call 1

Student Listing Endpoint

GET /proxycurl/api/linkedin/school/students/

Cost: 3 credits / student returned. (Extra charges might be incurred if premium optional parameters are used. Please read the description of the parameters that you intend to use)

Get a list of students of a school or university.

curl \
    -G \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/linkedin/school/students/' \
    --data-urlencode 'linkedin_school_url=https://www.linkedin.com/school/stanford-university' \
    --data-urlencode 'country=us' \
    --data-urlencode 'enrich_profiles=enrich' \
    --data-urlencode 'search_keyword=computer*|cs' \
    --data-urlencode 'page_size=10' \
    --data-urlencode 'student_status=current' \
    --data-urlencode 'sort_by=recently-matriculated' \
    --data-urlencode 'resolve_numeric_id=false'

import requests

api_key = 'YOUR_API_KEY'
headers = {'Authorization': 'Bearer ' + api_key}
api_endpoint = 'https://nubela.co/proxycurl/api/linkedin/school/students/'
params = {
    'linkedin_school_url': 'https://www.linkedin.com/school/stanford-university',
    'country': 'us',
    'enrich_profiles': 'enrich',
    'search_keyword': 'computer*|cs',
    'page_size': '10',
    'student_status': 'current',
    'sort_by': 'recently-matriculated',
    'resolve_numeric_id': 'false',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=headers)

Run in Postman

URL Parameters

Parameter Required Description Example
linkedin_school_url yes
URL of the LinkedIn School Profile to target.

URL should be in the format of https://www.linkedin.com/school/<public_identifier>
 https://www.linkedin.com/school/stanford-university
country no
Limit the result set to the country locality of the profile. For example, set the parameter of country=us if you only want profiles from the US.

This parameter accepts a case-insensitive Alpha-2 ISO3166 country code.

Costs an extra 3 credit per result returned.
 us
enrich_profiles no
Get the full profile of students instead of only their profile urls.

Each request respond with a streaming response of profiles.

The valid values are:

* skip (default): lists student's profile url
* enrich: lists full profile of students

Calling this API endpoint with this parameter would add 1 credit per student returned.
 enrich
search_keyword no
Filter students by their major by matching the student's major against a regular expression.

The default value of this parameter is null.

The accepted value for this parameter is a case-insensitive regular expression.

(The base cost of calling this API endpoint with this parameter would be 10 credits.
Each student matched and returned would cost 6 credits per student returned.)
 computer*|cs
page_size no
Tune the maximum results returned per API call.

The default value of this parameter is 200000.

Accepted values for this parameter is an integer ranging from 1 to 200000.

When enrich_profiles=enrich, this parameter accepts value ranging from 1 to 10 and the default value is 10.
 10
student_status no
Parameter to tell the API to return past or current students.

Valid values are current, past, and all:

* current (default) : lists current students
* past : lists past students
* all : lists current & past students
 current
sort_by no
Sort students by matriculation or graduation dates.

Valid values are:
* recently-matriculated - Sort students by their matriculation date. Students who had had most recently started school is on the top of the list.
* recently-graduated - Sort students by their graduation date. The most recently graduated student is on the top of this list.
* none - The default value. Do not sort.

If this parameter is supplied with a value other than none, will add 50 credits to the base cost of the API endpoint regardless number of results returned. It will also add an additional cost of 10 credits per student returned.
 recently-matriculated
resolve_numeric_id no
Enable support for School Profile URLs with numerical IDs that you most frequently fetch from Sales Navigator.
We achieve this by resolving numerical IDs into vanity IDs with cached company profiles from LinkDB.
For example, we will turn https://www.linkedin.com/school/1234567890 to https://www.linkedin.com/school/acme-corp -- for which the API endpoint only supports the latter.

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

Response

{
    "next_page": null,
    "students": [
        {
            "profile": null,
            "profile_url": "https://www.linkedin.com/in/minghowlogic"
        },
        {
            "profile": null,
            "profile_url": "https://www.linkedin.com/in/zhengpingzhou"
        }
    ]
}
Key Description Example
students
A list of student profiles (if enriched) and their associated profile URL.
 See Student object
next_page
The API URI that will lead to the next page of results.
 null

Student

Key Description Example
profile_url
"https://www.linkedin.com/in/minghowlogic"
profile
null

Response Headers

Header Key Description Example
X-Proxycurl-Credit-Cost Total cost of credits for this API call 3

Company API

Company Profile Endpoint

GET /proxycurl/api/linkedin/company

Cost: 1 credit / successful request. (Extra charges might be incurred if premium optional parameters are used. Please read the description of the parameters that you intend to use)

Get structured data of a Company Profile

curl \
    -G \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/linkedin/company' \
    --data-urlencode 'url=https://www.linkedin.com/company/google/' \
    --data-urlencode 'resolve_numeric_id=true' \
    --data-urlencode 'categories=include' \
    --data-urlencode 'funding_data=include' \
    --data-urlencode 'extra=include' \
    --data-urlencode 'exit_data=include' \
    --data-urlencode 'acquisitions=include' \
    --data-urlencode 'use_cache=if-present'

import requests

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

Run in Postman

URL Parameters

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

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

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

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

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

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

Default value is "exclude".
The other acceptable value is "include", which will include these acquisition data (if available) for 1 extra credit.
 include
use_cache no
if-present The default behavior. Fetches profile from cache regardless of age of profile. If profile is not available in cache, API will attempt to source profile externally.

if-recent API will make a best effort to return a fresh profile no older than 29 days.Costs an extra 1 credit on top of the cost of the base endpoint.
 if-present

Response

{
    "affiliated_companies": [
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/company/youtube",
            "location": "San Bruno, CA",
            "name": "YouTube"
        },
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/showcase/google-cloud",
            "location": "Mountain View, California",
            "name": "Google Cloud"
        },
        {
            "industry": "Advertising Services",
            "link": "https://www.linkedin.com/showcase/think-with-google",
            "location": "Mountain View, California",
            "name": "Think with Google"
        },
        {
            "industry": "Advertising Services",
            "link": "https://www.linkedin.com/showcase/google-ads-",
            "location": "Mountain View, California",
            "name": "Google Ads"
        },
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/showcase/googledevelopers",
            "location": "Mountain View, CA",
            "name": "Google Developers"
        },
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/showcase/google-analytics",
            "location": "Mountain View, California",
            "name": "Google Analytics"
        },
        {
            "industry": "IT Services and IT Consulting",
            "link": "https://www.linkedin.com/showcase/googleworkspace",
            "location": "Mountain View, California",
            "name": "Google Workspace"
        },
        {
            "industry": "Advertising Services",
            "link": "https://www.linkedin.com/showcase/googlemarketingplatform",
            "location": "Mountain View, California",
            "name": "Google Marketing Platform"
        },
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/showcase/google-developer-groups",
            "location": "Mountain View, CA",
            "name": "Google Developer Groups (GDG)"
        },
        {
            "industry": "Advertising Services",
            "link": "https://www.linkedin.com/showcase/google-ad-manager",
            "location": "Mountain View, California",
            "name": "Google Ad Manager"
        },
        {
            "industry": "E-Learning Providers",
            "link": "https://www.linkedin.com/showcase/grow-with-google",
            "location": "Mountain View, California",
            "name": "Grow with Google"
        },
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/showcase/google-for-startups",
            "location": "San Francisco, California",
            "name": "Google for Startups"
        },
        {
            "industry": "Research Services",
            "link": "https://www.linkedin.com/company/x",
            "location": "Mountain View, CA",
            "name": "X, the moonshot factory"
        },
        {
            "industry": "Technology, Information and Internet",
            "link": "https://www.linkedin.com/showcase/google-small-business",
            "location": "Mountain View, California",
            "name": "Google Small Business"
        },
        {
            "industry": "Technology, Information and Internet",
            "link": "https://www.linkedin.com/showcase/google-cloud-partners",
            "location": "Mountain View, California",
            "name": "Google Cloud Partners"
        },
        {
            "industry": "Human Resources Services",
            "link": "https://www.linkedin.com/showcase/rework-with-google",
            "location": null,
            "name": "re:Work with Google"
        },
        {
            "industry": "Advertising Services",
            "link": "https://www.linkedin.com/showcase/google-partners",
            "location": null,
            "name": "Google Partners"
        },
        {
            "industry": "IT Services and IT Consulting",
            "link": "https://www.linkedin.com/showcase/chrome-enterprise",
            "location": null,
            "name": "Chrome Enterprise"
        },
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/showcase/androiddev",
            "location": "Mountain View, California",
            "name": "Android Developers"
        },
        {
            "industry": "IT Services and IT Consulting",
            "link": "https://www.linkedin.com/showcase/googleplaybiz",
            "location": "Mountain View, CA",
            "name": "Google Play business community"
        },
        {
            "industry": "Online Audio and Video Media",
            "link": "https://www.linkedin.com/showcase/google-news-initiative",
            "location": "Mountain View, CA",
            "name": "Google News Initiative"
        },
        {
            "industry": "Advertising Services",
            "link": "https://www.linkedin.com/showcase/googleadmob",
            "location": null,
            "name": "Google AdMob"
        },
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/showcase/google-health",
            "location": null,
            "name": "Google Health"
        },
        {
            "industry": "Technology, Information and Internet",
            "link": "https://www.linkedin.com/showcase/google-pay",
            "location": "Mountain View, California",
            "name": "Google Pay"
        },
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/showcase/google-user-research.",
            "location": null,
            "name": "Google User Experience Research"
        },
        {
            "industry": "Venture Capital and Private Equity Principals",
            "link": "https://ca.linkedin.com/company/capitalg",
            "location": "San Francisco, CA",
            "name": "CapitalG"
        },
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/showcase/android_by_google",
            "location": null,
            "name": "Android"
        },
        {
            "industry": "IT Services and IT Consulting",
            "link": "https://www.linkedin.com/showcase/androidenterprise",
            "location": "Mountain View, CA",
            "name": "Android Enterprise"
        },
        {
            "industry": "Software Development",
            "link": "https://ng.linkedin.com/showcase/gwgafrica",
            "location": "Lagos, Lagos",
            "name": "Grow with Google Africa"
        },
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/showcase/flutterdevofficial",
            "location": "Mountain View, California",
            "name": "Flutter Dev"
        },
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/showcase/firebase",
            "location": "Mountain View, CA",
            "name": "Firebase"
        },
        {
            "industry": "Advertising Services",
            "link": "https://www.linkedin.com/company/adometry",
            "location": "Mountain View, CA",
            "name": "Adometry (acquired by Google)"
        },
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/showcase/google-nest",
            "location": "Mountain View, California",
            "name": "Google Nest Pro \u0026 Enterprise Partners"
        },
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/showcase/tensorflowdev",
            "location": null,
            "name": "TensorFlow"
        },
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/showcase/google-developers-north-america",
            "location": "Mountain View, CA",
            "name": "Google Developers North America"
        },
        {
            "industry": "Technology, Information and Internet",
            "link": "https://www.linkedin.com/showcase/google-chrome",
            "location": "Mountain View, CA",
            "name": "Google Chrome"
        },
        {
            "industry": "Advertising Services",
            "link": "https://www.linkedin.com/showcase/rare-with-google",
            "location": null,
            "name": "Rare with Google"
        },
        {
            "industry": null,
            "link": "https://www.linkedin.com/showcase/flutterdev-hold",
            "location": null,
            "name": "Flutter"
        },
        {
            "industry": null,
            "link": "https://www.linkedin.com/showcase/firebase-hold",
            "location": null,
            "name": "Firebase"
        }
    ],
    "background_cover_image_url": "https://s3.us-west-000.backblazeb2.com/proxycurl/company/google/cover?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=0004d7f56a0400b0000000001%2F20230119%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20230119T060024Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=abb7a4b87583cffda8db24d58d906c644998fae8cbb99e98c69a35720fcd0050",
    "company_size": [
        10001,
        null
    ],
    "company_size_on_linkedin": 319856,
    "company_type": "PUBLIC_COMPANY",
    "description": "A problem isn\u0027t truly solved until it\u0027s solved for all. Googlers build products that help create opportunities for everyone, whether down the street or across the globe. Bring your insight, imagination and a healthy disregard for the impossible. Bring everything that makes you unique. Together, we can build for everyone.\n\nCheck out our career opportunities at careers.google.com.",
    "follower_count": 27472792,
    "founded_year": null,
    "hq": {
        "city": "Mountain View",
        "country": "US",
        "is_hq": true,
        "line_1": "1600 Amphitheatre Parkway",
        "postal_code": "94043",
        "state": "CA"
    },
    "industry": "Software Development",
    "linkedin_internal_id": "1441",
    "locations": [
        {
            "city": "Mountain View",
            "country": "US",
            "is_hq": true,
            "line_1": "1600 Amphitheatre Parkway",
            "postal_code": "94043",
            "state": "CA"
        },
        {
            "city": "New York",
            "country": "US",
            "is_hq": false,
            "line_1": "111 8th Ave",
            "postal_code": "10011",
            "state": "NY"
        },
        {
            "city": "Amsterdam",
            "country": "NL",
            "is_hq": false,
            "line_1": "Claude Debussylaan 34",
            "postal_code": "1082 MD",
            "state": "North Holland"
        },
        {
            "city": "Sao Paulo",
            "country": "BR",
            "is_hq": false,
            "line_1": "Avenida Brigadeiro Faria Lima, 3477",
            "postal_code": "04538-133",
            "state": "SP"
        },
        {
            "city": "Kitchener",
            "country": "CA",
            "is_hq": false,
            "line_1": "51 Breithaupt St",
            "postal_code": "N2H 5G5",
            "state": "ON"
        },
        {
            "city": "Dublin",
            "country": "IE",
            "is_hq": false,
            "line_1": "Barrow Street",
            "postal_code": null,
            "state": "County Dublin"
        },
        {
            "city": "Bengaluru",
            "country": "IN",
            "is_hq": false,
            "line_1": "Old Madras Road",
            "postal_code": "560016",
            "state": "Karnataka"
        },
        {
            "city": "Boulder",
            "country": "US",
            "is_hq": false,
            "line_1": "2590 Pearl St",
            "postal_code": "80302",
            "state": "CO"
        },
        {
            "city": "Seattle",
            "country": "US",
            "is_hq": false,
            "line_1": "601 N 34th St",
            "postal_code": "98103",
            "state": "WA"
        },
        {
            "city": "Sydney",
            "country": "AU",
            "is_hq": false,
            "line_1": "48 Pirrama Rd",
            "postal_code": "2009",
            "state": "NSW"
        },
        {
            "city": "Irvine",
            "country": "US",
            "is_hq": false,
            "line_1": "19510 Jamboree Rd",
            "postal_code": "92612",
            "state": "CA"
        },
        {
            "city": "Chicago",
            "country": "US",
            "is_hq": false,
            "line_1": "320 N Morgan St",
            "postal_code": "60607",
            "state": "IL"
        },
        {
            "city": "Mumbai",
            "country": "IN",
            "is_hq": false,
            "line_1": "3 Bandra Kurla Complex Road",
            "postal_code": "400051",
            "state": "Maharashtra"
        },
        {
            "city": "Taguig City",
            "country": "PH",
            "is_hq": false,
            "line_1": "5th Ave",
            "postal_code": null,
            "state": "National Capital Region"
        },
        {
            "city": "Singapore",
            "country": "SG",
            "is_hq": false,
            "line_1": "3 Pasir Panjang Rd",
            "postal_code": "118484",
            "state": "Singapore"
        },
        {
            "city": "Hyderabad",
            "country": "IN",
            "is_hq": false,
            "line_1": "13",
            "postal_code": "500084",
            "state": "TS"
        },
        {
            "city": "Melbourne",
            "country": "AU",
            "is_hq": false,
            "line_1": "90 Collins St",
            "postal_code": "3000",
            "state": "VIC"
        },
        {
            "city": "San Bruno",
            "country": "US",
            "is_hq": false,
            "line_1": "901 Cherry Ave",
            "postal_code": "94066",
            "state": "CA"
        },
        {
            "city": "Madrid",
            "country": "ES",
            "is_hq": false,
            "line_1": "Plaza Pablo Ruiz Picasso",
            "postal_code": "28046",
            "state": "Community of Madrid"
        },
        {
            "city": "Washington",
            "country": "US",
            "is_hq": false,
            "line_1": "25 Massachusetts Ave NW",
            "postal_code": "20001",
            "state": "DC"
        },
        {
            "city": "Gurugram",
            "country": "IN",
            "is_hq": false,
            "line_1": "15",
            "postal_code": "122001",
            "state": "HR"
        },
        {
            "city": "Bogota",
            "country": "CO",
            "is_hq": false,
            "line_1": "Carrera 11A 94-45",
            "postal_code": "110221",
            "state": "Bogota, D.C."
        },
        {
            "city": "Wan Chai",
            "country": "HK",
            "is_hq": false,
            "line_1": "2 Matheson St",
            "postal_code": null,
            "state": "Hong Kong"
        },
        {
            "city": "Reston",
            "country": "US",
            "is_hq": false,
            "line_1": "1875 Explorer St",
            "postal_code": "20190",
            "state": "VA"
        },
        {
            "city": "Toronto",
            "country": "CA",
            "is_hq": false,
            "line_1": "111 Richmond St W",
            "postal_code": "M5H 2G4",
            "state": "ON"
        },
        {
            "city": "San Francisco",
            "country": "US",
            "is_hq": false,
            "line_1": "345 Spear St",
            "postal_code": "94105",
            "state": "CA"
        },
        {
            "city": "Cambridge",
            "country": "US",
            "is_hq": false,
            "line_1": "355 Main St",
            "postal_code": "02142",
            "state": "MA"
        },
        {
            "city": "Milan",
            "country": "IT",
            "is_hq": false,
            "line_1": "Via Federico Confalonieri, 4",
            "postal_code": "20124",
            "state": "Lomb."
        },
        {
            "city": "London",
            "country": "GB",
            "is_hq": false,
            "line_1": "St Giles High Street",
            "postal_code": "WC2H 8AG",
            "state": "England"
        },
        {
            "city": "Austin",
            "country": "US",
            "is_hq": false,
            "line_1": "9606 N Mopac Expy",
            "postal_code": "78759",
            "state": "TX"
        },
        {
            "city": "Los Angeles",
            "country": "US",
            "is_hq": false,
            "line_1": "340 Main St",
            "postal_code": "90291",
            "state": "CA"
        },
        {
            "city": "Madrid",
            "country": "ES",
            "is_hq": false,
            "line_1": "Plaza Pablo Ruiz Picasso",
            "postal_code": "28020",
            "state": "Community of Madrid"
        },
        {
            "city": "Ann Arbor",
            "country": "US",
            "is_hq": false,
            "line_1": "2300 Traverwood Dr",
            "postal_code": "48105",
            "state": "MI"
        },
        {
            "city": "Las Condes",
            "country": "CL",
            "is_hq": false,
            "line_1": "Avenida Costanera Sur",
            "postal_code": "7550000",
            "state": "Santiago Metropolitan"
        },
        {
            "city": "Atlanta",
            "country": "US",
            "is_hq": false,
            "line_1": "10 10th St NE",
            "postal_code": "30309",
            "state": "GA"
        },
        {
            "city": "Warsaw",
            "country": "PL",
            "is_hq": false,
            "line_1": "ulica Emilii Plater 53",
            "postal_code": "00-125",
            "state": "MA"
        },
        {
            "city": "Bengaluru",
            "country": "IN",
            "is_hq": false,
            "line_1": "3 Swamy Vivekananda Road",
            "postal_code": "560016",
            "state": "Karnataka"
        },
        {
            "city": "Kirkland",
            "country": "US",
            "is_hq": false,
            "line_1": "777 6th St S",
            "postal_code": "98033",
            "state": "WA"
        },
        {
            "city": "Munich",
            "country": "DE",
            "is_hq": false,
            "line_1": "Erika-Mann-Strasse 33",
            "postal_code": "80636",
            "state": "BY"
        },
        {
            "city": "Miguel Hidalgo",
            "country": "MX",
            "is_hq": false,
            "line_1": "Montes Urales",
            "postal_code": "11000",
            "state": "CDMX"
        },
        {
            "city": "Buenos Aires City",
            "country": "AR",
            "is_hq": false,
            "line_1": "Avenida Alicia Moreau de Justo 350",
            "postal_code": "1107",
            "state": "Buenos Aires Autonomous City"
        },
        {
            "city": "Paris",
            "country": "FR",
            "is_hq": false,
            "line_1": "8 Rue de Londres",
            "postal_code": "75009",
            "state": "IdF"
        },
        {
            "city": "Tel Aviv-Yafo",
            "country": "IL",
            "is_hq": false,
            "line_1": "Yigal Allon 98",
            "postal_code": "67891",
            "state": "Tel Aviv"
        },
        {
            "city": "Berlin",
            "country": "DE",
            "is_hq": false,
            "line_1": "Unter den Linden 14",
            "postal_code": "10117",
            "state": "BE"
        },
        {
            "city": "Hamburg",
            "country": "DE",
            "is_hq": false,
            "line_1": "ABC-Strasse 19",
            "postal_code": "20354",
            "state": "HH"
        },
        {
            "city": "Frisco",
            "country": "US",
            "is_hq": false,
            "line_1": "6175 Main St",
            "postal_code": "75034",
            "state": "TX"
        },
        {
            "city": "Zurich",
            "country": "CH",
            "is_hq": false,
            "line_1": "Brandschenkestrasse 110",
            "postal_code": "8002",
            "state": "ZH"
        },
        {
            "city": "Stockholm",
            "country": "SE",
            "is_hq": false,
            "line_1": "Kungsbron 2",
            "postal_code": "111 22",
            "state": "Stockholm County"
        }
    ],
    "name": "Google",
    "profile_pic_url": "https://s3.us-west-000.backblazeb2.com/proxycurl/company/google/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=0004d7f56a0400b0000000001%2F20230119%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20230119T060024Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=0d3500b39da8db1d2d8f5727a9ac39a7c4a88b4632ed68209dee12f06bc79aca",
    "search_id": "1441",
    "similar_companies": [
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/company/amazon",
            "location": "Seattle, WA",
            "name": "Amazon"
        },
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/company/microsoft",
            "location": "Redmond, Washington",
            "name": "Microsoft"
        },
        {
            "industry": "Computers and Electronics Manufacturing",
            "link": "https://www.linkedin.com/company/apple",
            "location": "Cupertino, California",
            "name": "Apple"
        },
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/company/meta",
            "location": "Menlo Park, CA",
            "name": "Meta"
        },
        {
            "industry": "Entertainment Providers",
            "link": "https://www.linkedin.com/company/netflix",
            "location": "Los Gatos, CA",
            "name": "Netflix"
        },
        {
            "industry": "IT Services and IT Consulting",
            "link": "https://www.linkedin.com/company/ibm",
            "location": "Armonk, New York, NY",
            "name": "IBM"
        },
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/company/linkedin",
            "location": "Sunnyvale, CA",
            "name": "LinkedIn"
        },
        {
            "industry": "Business Consulting and Services",
            "link": "https://www.linkedin.com/company/deloitte",
            "location": null,
            "name": "Deloitte"
        },
        {
            "industry": "IT Services and IT Consulting",
            "link": "https://in.linkedin.com/company/tata-consultancy-services",
            "location": "Mumbai, Maharashtra",
            "name": "Tata Consultancy Services"
        },
        {
            "industry": "Manufacturing",
            "link": "https://uk.linkedin.com/company/unilever",
            "location": "Blackfriars, London",
            "name": "Unilever"
        }
    ],
    "specialities": [
        "search",
        "ads",
        "mobile",
        "android",
        "online video",
        "apps",
        "machine learning",
        "virtual reality",
        "cloud",
        "hardware",
        "artificial intelligence",
        "youtube",
        "software"
    ],
    "tagline": null,
    "universal_name_id": "google",
    "updates": [
        {
            "article_link": null,
            "image": "https://media.licdn.com/dms/image/C5605AQFthnjiTD6Mvg/videocover-high/0/1660754102856?e=2147483647\u0026v=beta\u0026t=PPOsA9J3vCTXWhuZclqSBQl7DLSDLvy5hKWlkHI85YE",
            "posted_on": {
                "day": 13,
                "month": 9,
                "year": 2022
            },
            "text": "Want to kick start your #LifeAtGoogle but not sure where to begin? Explore our Build Your Future site, where you can learn about developmental programs, learn tips for future interviews, sign up for informational events, and even hear real stories from Googlers who\u2019ve been where you are now. Get started \u2192 https://bit.ly/3SKPzQB",
            "total_likes": 4267
        },
        {
            "article_link": null,
            "image": "https://media.licdn.com/dms/image/C4D22AQGcvTlKRR3qvQ/feedshare-shrink_2048_1536/0/1672854668558?e=1676505600\u0026v=beta\u0026t=whRRx9ULPEuyw_FgUg4Z3N3O9iksyJW7ewCGZA6ujdg",
            "posted_on": null,
            "text": "Ariana, welcome to Google. Here\u2019s to a year full of growth, learning, and experiences at #LifeAtGoogle! \ud83c\udf89",
            "total_likes": 397
        },
        {
            "article_link": null,
            "image": "https://media.licdn.com/dms/image/C4D22AQGcvTlKRR3qvQ/feedshare-shrink_2048_1536/0/1672854668558?e=1676505600\u0026v=beta\u0026t=whRRx9ULPEuyw_FgUg4Z3N3O9iksyJW7ewCGZA6ujdg",
            "posted_on": {
                "day": 6,
                "month": 1,
                "year": 2023
            },
            "text": null,
            "total_likes": 0
        },
        {
            "article_link": null,
            "image": "https://media.licdn.com/dms/image/C5622AQHlEhyso9-BAA/feedshare-shrink_800/0/1672235570251?e=1676505600\u0026v=beta\u0026t=PaHpVodYauVt_Th4eZRJAz_S5LuD_e6MJJZkqEiENBQ",
            "posted_on": {
                "day": 10,
                "month": 1,
                "year": 2023
            },
            "text": "With a new year comes new beginnings. Welcome to Google, Mega, we\u2019re glad you and your #Mewgler are here! #LifeAtGoogle",
            "total_likes": 1252
        },
        {
            "article_link": null,
            "image": "https://media.licdn.com/dms/image/C5622AQHlEhyso9-BAA/feedshare-shrink_800/0/1672235570251?e=1676505600\u0026v=beta\u0026t=PaHpVodYauVt_Th4eZRJAz_S5LuD_e6MJJZkqEiENBQ",
            "posted_on": {
                "day": 30,
                "month": 12,
                "year": 2022
            },
            "text": null,
            "total_likes": 0
        },
        {
            "article_link": null,
            "image": "https://media.licdn.com/dms/image/C5605AQHir6yRaHkgHg/feedshare-thumbnail_720_1280/0/1672258205329?e=2147483647\u0026v=beta\u0026t=ZILK1L9klkFzLD0SKezztfPT5rSbdscMWVcTMgoUeWY",
            "posted_on": {
                "day": 30,
                "month": 12,
                "year": 2022
            },
            "text": "Turn on job alerts and explore all that the Google careers site has to offer \u2192 https://goo.gle/3HCR9kn #LifeAtGoogle",
            "total_likes": 2186
        },
        {
            "article_link": "https://blog.google/inside-google/life-at-google/jennys-path-to-become-a-director-of-customer-engineering/",
            "image": null,
            "posted_on": {
                "day": 23,
                "month": 12,
                "year": 2022
            },
            "text": "\"Leaders at Google ask themselves, \u0027How can we get Googlers from where they are today to where they aspire to be?\u0027\" In the last #MyPathtoGoogle of the year, meet our Director of Customer Engineering based in Hong Kong, Jenny Sun. Jenny shares her path to a leadership role after starting in tech as a software engineer and how her desire to learn has helped her customers, teams, and personal career grow.",
            "total_likes": 2038
        },
        {
            "article_link": "https://fairygodboss.com/articles/im-a-team-lead-at-google-heres-how-ergs-and-mentorship-advanced-my-career",
            "image": null,
            "posted_on": {
                "day": 23,
                "month": 12,
                "year": 2022
            },
            "text": "Meet Nancy Hwang, a Product Activation and Customer Experience team lead here at Google. Earlier this month, Nancy sat down with Fairygodboss to reflect on how mentorship and her involvement in an employee resource group have positively impacted her career journey at Google. \n\nRead about Nancy\u2019s story and her advice on how to advance your career \u2b07\ufe0f",
            "total_likes": 1490
        },
        {
            "article_link": null,
            "image": "https://media.licdn.com/dms/image/C4E22AQG2ZKINx_jsZw/feedshare-shrink_2048_1536/0/1670381081829?e=1676505600\u0026v=beta\u0026t=ywsC6hkhcztq3V61xVvf5go2D_rSr53Waoq3sdlczqY",
            "posted_on": {
                "day": 23,
                "month": 12,
                "year": 2022
            },
            "text": "365 days full of learnings, and more to come! We\u2019re glad you\u2019re part of #LifeAtGoogle, Eunice.",
            "total_likes": 18817
        },
        {
            "article_link": null,
            "image": "https://media.licdn.com/dms/image/C4E22AQG2ZKINx_jsZw/feedshare-shrink_2048_1536/0/1670381081829?e=1676505600\u0026v=beta\u0026t=ywsC6hkhcztq3V61xVvf5go2D_rSr53Waoq3sdlczqY",
            "posted_on": {
                "day": 13,
                "month": 12,
                "year": 2022
            },
            "text": null,
            "total_likes": 0
        },
        {
            "article_link": null,
            "image": null,
            "posted_on": {
                "day": 23,
                "month": 12,
                "year": 2022
            },
            "text": "2022 is almost over, which means it\u2019s time to reflect! Googlers, you shared lots of projects with the world this year. Which was your favorite to work on? Which coworkers made your #LifeAtGoogle brighter every day? Tag them in the comments with a shoutout!",
            "total_likes": 1234
        },
        {
            "article_link": null,
            "image": "https://media.licdn.com/dms/image/C5622AQFLUJbMj4V7Vw/feedshare-shrink_800/0/1670208017850?e=1676505600\u0026v=beta\u0026t=qFxz6eV4tBGTznrHcq_qJw31_TePt6JrrjOXXwMF6Iw",
            "posted_on": {
                "day": 16,
                "month": 12,
                "year": 2022
            },
            "text": "A bit of insight on the Noogler hat tradition from the team that keeps the tradition going! #LifeAtGoogle",
            "total_likes": 3078
        },
        {
            "article_link": null,
            "image": "https://media.licdn.com/dms/image/C5622AQFLUJbMj4V7Vw/feedshare-shrink_800/0/1670208017850?e=1676505600\u0026v=beta\u0026t=qFxz6eV4tBGTznrHcq_qJw31_TePt6JrrjOXXwMF6Iw",
            "posted_on": {
                "day": 13,
                "month": 12,
                "year": 2022
            },
            "text": null,
            "total_likes": 0
        },
        {
            "article_link": null,
            "image": "https://media.licdn.com/dms/image/C5622AQHGS9rpL1dwCA/feedshare-shrink_2048_1536/0/1671117185457?e=1676505600\u0026v=beta\u0026t=7oFrPTZU5gB0uS1mzaVqt13ftFApKTeQah7Ace4iL7U",
            "posted_on": {
                "day": 16,
                "month": 12,
                "year": 2022
            },
            "text": "Chris Kiagiri, Technical Account manager, joined Google 15 years ago, as Kenya\u2019s employee number 2. \n\nLast month at our Google Sandbox Nairobi event, he shared with our participants his career journey and Google\u2019s 15-years of Engineering in Africa.\n\n\u201cI often tell students that Google hadn\u2019t even been founded when I graduated from high school, so they shouldn\u0027t limit their dreams to the opportunities that currently exist.\u201c \n\nThank you to our participants, we hope you left with first-hand experience of what #LifeatGoogle is all about \u2014 and thank you to Chris and all other Googlers who made this experience possible! \n\nWant to learn more? Check out our upcoming and on-demand events here \u003e https://goo.gle/3VDHOg8",
            "total_likes": 1821
        }
    ],
    "website": "https://goo.gle/3m1IN7m"
}
Key Description Example
linkedin_internal_id
LinkedIn's Internal and immutable ID of this Company profile.
 "1441"
description
A textual description of the company.
 "A problem isn\u0027t truly solved until it\u0027s solved for all. Googlers build products that help create opportunities for everyone, whether down the street or across the globe. Bring your insight, imagination and a healthy disregard for the impossible. Bring everything that makes you unique. Together, we can build for everyone.\n\nCheck out our career opportunities at careers.google.com."
website
The URL of the company's website.
 "https://goo.gle/3m1IN7m"
industry
The industry attribute, found in a LinkedIn Company profile, describes the industry in which the company operates. The value of this attribute is an enumerator. This CSV file provides an exhaustive list of possible values for this attribute.
 "Software Development"
company_size
Sequenceed range of company head count
 [10001, null]
company_size_on_linkedin
The size of the company as indicated on LinkedIn.
 319856
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
The year the company was founded.
 null
specialities
A list of specialities.
 ["search", "ads", "mobile", "android", "online video", "apps", "machine learning", "virtual reality", "cloud", "hardware", "artificial intelligence", "youtube", "software"]
locations
List of CompanyLocation
 See CompanyLocation object
name
The name of the company.
 "Google"
tagline
A short, catchy phrase that represents the company's mission or brand.
 "Think Different - But Not Too Different"
universal_name_id
A unique numerical identifier for the company used in the LinkedIn platform.
 "google"
profile_pic_url
The URL of the company's profile picture.
 "https://s3.us-west-000.backblazeb2.com/proxycurl/company/google/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=0004d7f56a0400b0000000001%2F20230119%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20230119T060024Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=0d3500b39da8db1d2d8f5727a9ac39a7c4a88b4632ed68209dee12f06bc79aca"
background_cover_image_url
The URL of the company's background cover image.
 "https://s3.us-west-000.backblazeb2.com/proxycurl/company/google/cover?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=0004d7f56a0400b0000000001%2F20230119%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20230119T060024Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=abb7a4b87583cffda8db24d58d906c644998fae8cbb99e98c69a35720fcd0050"
search_id
Useable with Job listing endpoint
 "1441"
similar_companies
List of SimilarCompany
 See SimilarCompany object
affiliated_companies
List of AffiliatedCompany
 See AffiliatedCompany object
updates
List of CompanyUpdate
 See CompanyUpdate object
follower_count
The number of followers the company has on LinkedIn.
 27472792
acquisitions
A Acquisition object
 See Acquisition object
exit_data
List of Exit
 See Exit object
extra
Company extra when extra=include
 See CompanyDetails object
funding_data
Company Funding data when funding_data=include
 See Funding object
categories
The categories attribute is fetched from the company's Crunchbase profile. Values for this attribute are free-form text, and there is no exhaustive list of categories. Consider the categories attribute as "hints" regarding the products or services offered by the company.
 ["artificial-intelligence", "virtual-reality"]

CompanyLocation

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

SimilarCompany

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

AffiliatedCompany

Key Description Example
name
"LinkedIn"
link
"https://www.linkedin.com/company/linkedin"
industry
"Internet"
location
"Sunnyvale, California"

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
2023

Acquisition

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

AcquiredCompany

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

Acquisitor

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

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

Funding

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

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"

Response Headers

Header Key Description Example
X-Proxycurl-Credit-Cost Total cost of credits for this API call 1

Employee Listing Endpoint

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

Cost: 3 credits / employee returned. (Extra charges might be incurred if premium optional parameters are used. Please read the description of the parameters that you intend to use)

Get a list of employees of a Company.

This API endpoint is powered by LinkDB, our comprehensive dataset of people and company profiles.

curl \
    -G \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/linkedin/company/employees/' \
    --data-urlencode 'url=https://www.linkedin.com/company/microsoft' \
    --data-urlencode 'country=us' \
    --data-urlencode 'enrich_profiles=enrich' \
    --data-urlencode 'role_search=(co)?-?founder' \
    --data-urlencode 'page_size=10' \
    --data-urlencode 'employment_status=current' \
    --data-urlencode 'sort_by=recently-joined' \
    --data-urlencode 'resolve_numeric_id=false'

import requests

api_key = 'YOUR_API_KEY'
headers = {'Authorization': 'Bearer ' + api_key}
api_endpoint = 'https://nubela.co/proxycurl/api/linkedin/company/employees/'
params = {
    'url': 'https://www.linkedin.com/company/microsoft',
    'country': 'us',
    'enrich_profiles': 'enrich',
    'role_search': '(co)?-?founder',
    'page_size': '10',
    'employment_status': 'current',
    'sort_by': 'recently-joined',
    'resolve_numeric_id': 'false',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=headers)

Run in Postman

URL Parameters

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

URL should be in the format of https://www.linkedin.com/company/<public_identifier>
 https://www.linkedin.com/company/microsoft
country no
Limit the result set to the country locality of the profile. For example, set the parameter of country=us if you only want profiles from the US. Or you can set the parameter to country=us,sg if you want employees from both the US and Singapore.

This parameter accepts a comma-separated case-insensitive values of Alpha-2 ISO3166 country code.

Costs an extra 3 credit per result returned.
 us
enrich_profiles no
Get the full profile of employees instead of only their profile urls.

Each request respond with a streaming response of profiles.

The valid values are:

* skip (default): lists employee's profile url
* enrich: lists full profile of employees

Calling this API endpoint with this parameter would add 1 credit per employee returned.
 enrich
role_search no
Filter employees by their title by matching the employee's title against a regular expression.

The default value of this parameter is null.

The accepted value for this parameter is a case-insensitive regular expression.

(The base cost of calling this API endpoint with this parameter would be 10 credits.
Each employee matched and returned would cost 6 credits per employee returned.)
 (co)?-?founder
page_size no
Tune the maximum results returned per API call.

The default value of this parameter is 200000.

Accepted values for this parameter is an integer ranging from 1 to 200000.

When enrich_profiles=enrich, this parameter accepts value ranging from 1 to 10 and the default value is 10.
 10
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
sort_by no
Sort employees by recency.

Valid values are:
* recently-joined - Sort employees by their join date. The most recent employee is on the top of the list.
* recently-left - Sort employees by their departure date. The most recent employee who had just left is on the top of this list.
* oldest - Returns the oldest employees first. The oldest employee who had joined this company historically is on the top of this list.
* none - The default value. Do not sort.

If this parameter is supplied with a value other than none, will add 50 credits to the base cost of the API endpoint regardless number of results returned. It will also add an additional cost of 10 credits per employee returned.
 recently-joined
resolve_numeric_id no
Enable support for Company Profile URLs with numerical IDs that you most frequently fetch from Sales Navigator.
We achieve this by resolving numerical IDs into vanity IDs with cached company profiles from LinkDB.
For example, we will turn https://www.linkedin.com/company/1234567890 to https://www.linkedin.com/company/acme-corp -- for which the API endpoint only supports the latter.

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

Response

{
    "employees": [
        {
            "profile": {
                "accomplishment_courses": [],
                "accomplishment_honors_awards": [],
                "accomplishment_organisations": [],
                "accomplishment_patents": [],
                "accomplishment_projects": [],
                "accomplishment_publications": [],
                "accomplishment_test_scores": [],
                "activities": [],
                "articles": [],
                "background_cover_image_url": null,
                "certifications": [],
                "city": "Seattle",
                "connections": null,
                "country": "US",
                "country_full_name": "United States of America",
                "education": [
                    {
                        "degree_name": null,
                        "description": null,
                        "ends_at": {
                            "day": 31,
                            "month": 12,
                            "year": 1975
                        },
                        "field_of_study": null,
                        "logo_url": "https://media-exp1.licdn.com/dms/image/C4E0BAQF5t62bcL0e9g/company-logo_400_400/0/1519855919126?e=1672876800\u0026v=beta\u0026t=9twXof1JlnNHfFprrDMi-C1Kp55HTT4ahINKHRflUHw",
                        "school": "Harvard University",
                        "school_linkedin_profile_url": null,
                        "starts_at": {
                            "day": 1,
                            "month": 1,
                            "year": 1973
                        }
                    },
                    {
                        "degree_name": null,
                        "description": null,
                        "ends_at": null,
                        "field_of_study": null,
                        "logo_url": "https://media-exp1.licdn.com/dms/image/C4D0BAQENlfOPKBEk3Q/company-logo_400_400/0/1519856497259?e=1672876800\u0026v=beta\u0026t=v7nJTPaJMfH7WOBjb22dyvNKxAgdPdVd8uLCUkMB1LQ",
                        "school": "Lakeside School",
                        "school_linkedin_profile_url": null,
                        "starts_at": null
                    }
                ],
                "experiences": [
                    {
                        "company": "Breakthrough Energy ",
                        "company_linkedin_profile_url": "https://www.linkedin.com/company/breakthrough-energy/",
                        "description": null,
                        "ends_at": null,
                        "location": null,
                        "logo_url": "https://media-exp1.licdn.com/dms/image/C4D0BAQGwD9vNu044FA/company-logo_400_400/0/1601560874941?e=1672876800\u0026v=beta\u0026t=VKb6OAHEwlnazKYKm4fc9go-y4zkUv2BT6tosOdQ54Y",
                        "starts_at": {
                            "day": 1,
                            "month": 1,
                            "year": 2015
                        },
                        "title": "Founder"
                    },
                    {
                        "company": "Bill \u0026 Melinda Gates Foundation",
                        "company_linkedin_profile_url": "https://www.linkedin.com/company/bill-\u0026-melinda-gates-foundation/",
                        "description": null,
                        "ends_at": null,
                        "location": null,
                        "logo_url": "https://media-exp1.licdn.com/dms/image/C4E0BAQE7Na_mKQhIJg/company-logo_400_400/0/1633731810932?e=1672876800\u0026v=beta\u0026t=Mz_ntwD4meCMcgo1L3JqDxBQRabFLIesd0Yz2ciAXNs",
                        "starts_at": {
                            "day": 1,
                            "month": 1,
                            "year": 2000
                        },
                        "title": "Co-chair"
                    },
                    {
                        "company": "Microsoft",
                        "company_linkedin_profile_url": "https://www.linkedin.com/company/microsoft/",
                        "description": null,
                        "ends_at": null,
                        "location": null,
                        "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQE88xCsONDULQ/company-logo_400_400/0/1618231291419?e=1672876800\u0026v=beta\u0026t=I1mJMWAR_W2R_0h-lyL9Ln1ewby1Gg7ExCbpzhMJr5g",
                        "starts_at": {
                            "day": 1,
                            "month": 1,
                            "year": 1975
                        },
                        "title": "Co-founder"
                    }
                ],
                "first_name": "Bill",
                "full_name": "Bill Gates",
                "groups": [],
                "headline": "Co-chair, Bill \u0026 Melinda Gates Foundation",
                "languages": [],
                "last_name": "Gates",
                "occupation": "Co-chair at Bill \u0026 Melinda Gates Foundation",
                "people_also_viewed": [],
                "profile_pic_url": "https://media.licdn.com/dms/image/C5616AQH9tkBTUhHfng/profile-displaybackgroundimage-shrink_200_800/0/1614530499015?e=2147483647\u0026v=beta\u0026t=VEoCyedtZulnAVYWT9BXfKHi5OFp8avElNjiz8kjSTU",
                "public_identifier": "williamhgates",
                "recommendations": [],
                "similarly_named_profiles": [],
                "state": "Washington",
                "summary": "Co-chair of the Bill \u0026 Melinda Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft. Voracious reader. Avid traveler. Active blogger.",
                "volunteer_work": []
            },
            "profile_url": "https://www.linkedin.com/in/williamhgates"
        }
    ],
    "next_page": null
}
Key Description Example
employees
List of Employee
 See Employee object
next_page
"https://nubela.co/proxycurl/api/linkedin/company/employees/?page_size=100\u0026employment_status=all\u0026resolve_numeric_id=true\u0026url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2F1035\u0026role_search=%5BFf%5D%5BOo%5D%5BUu%5D%5BNn%5D%5BDd%5D%5BEe%5D%5BRr%5D\u0026after=williamhgates"

Employee

Key Description Example
profile_url
LinkedIn Profile URL of the employee.
 "https://www.linkedin.com/in/williamhgates"
profile
Enriched profile data of the employee.
 {"accomplishment_courses": [{"name": "The course about ABCs", "number": "123"}], "accomplishment_honors_awards": [{"description": "\n Lorem ipsum dolor sit amet\n ", "issued_on": {"day": 1, "month": 1, "year": 1970}, "issuer": "Acme Corp", "title": "Nobel Peace Prize"}], "accomplishment_organisations": [{"description": null, "ends_at": {"day": 1, "month": 8, "year": 2016}, "org_name": "Microsoft", "starts_at": {"day": 1, "month": 1, "year": 2012}, "title": "Software Developer"}], "accomplishment_patents": [{"application_number": "123", "description": "\n Lorem ipsum dolor sit amet\n ", "issued_on": {"day": 1, "month": 1, "year": 1970}, "issuer": "Acme Corp", "patent_number": "123", "title": "The art of war", "url": null}], "accomplishment_projects": [{"description": "", "ends_at": {"day": 2, "month": 8, "year": 2023}, "starts_at": {"day": 1, "month": 8, "year": 2023}, "title": "Project Manhattan", "url": ""}], "accomplishment_publications": [{"description": "\n Lorem ipsum dolor sit amet\n ", "name": "Nobel Peace Prize", "published_on": {"day": 1, "month": 1, "year": 1970}, "publisher": "Acme Corp", "url": "https://example.com"}], "accomplishment_test_scores": [{"date_on": {"day": 1, "month": 1, "year": 2010}, "description": "Nailed it without studying.", "name": "CS1101S", "score": "A"}], "activities": [{"activity_status": "Active", "link": "", "title": "Volunteer"}], "articles": [{"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", "link": "https://www.linkedin.com/pulse/manufacturing-opportunity-bill-gates/", "published_date": {"day": 27, "month": 11, "year": 2019}, "title": "Manufacturing opportunity"}], "background_cover_image_url": "", "certifications": [{"authority": "Duolingo", "display_source": "", "ends_at": {"day": 1, "month": 1, "year": 2025}, "license_number": "", "name": "Kubernetes for Dummies", "starts_at": {"day": 1, "month": 1, "year": 2021}, "url": ""}], "city": "Seattle", "connections": 100, "country": "US", "country_full_name": "United States of America", "education": [{"activities_and_societies": "", "degree_name": "", "description": "", "ends_at": {"day": 31, "month": 12, "year": 1975}, "field_of_study": "", "grade": "", "logo_url": "https://media-exp1.licdn.com/dms/image/C4E0BAQF5t62bcL0e9g/company-logo_400_400/0/1519855919126?e=1672876800\u0026v=beta\u0026t=9twXof1JlnNHfFprrDMi-C1Kp55HTT4ahINKHRflUHw", "school": "Harvard University", "school_linkedin_profile_url": "", "starts_at": {"day": 1, "month": 1, "year": 1973}}], "experiences": [{"company": "Breakthrough Energy ", "company_linkedin_profile_url": "https://www.linkedin.com/company/breakthrough-energy/", "description": "", "ends_at": {"day": 2, "month": 8, "year": 2023}, "location": "", "logo_url": "https://media-exp1.licdn.com/dms/image/C4D0BAQGwD9vNu044FA/company-logo_400_400/0/1601560874941?e=1672876800\u0026v=beta\u0026t=VKb6OAHEwlnazKYKm4fc9go-y4zkUv2BT6tosOdQ54Y", "starts_at": {"day": 1, "month": 1, "year": 2000}, "title": "Founder"}], "first_name": "Bill", "follower_count": 100, "full_name": "Bill Gates", "groups": [{"name": "Hadoop Users", "profile_pic_url": "https://media-exp1.licdn.com/dms/image/C4D07AQG9IK9V0pk3mQ/group-logo_image-shrink_92x92/0/1631371531293?e=1642060800\u0026v=beta\u0026t=UK1tfIppWa-Nx7k9whmm5f9XdZoBdJhApf9N3ke3204", "url": "https://www.linkedin.com/groups/988957"}], "headline": "Co-chair, Bill \u0026 Melinda Gates Foundation", "languages": ["English"], "last_name": "Gates", "occupation": "Co-chair at Bill \u0026 Melinda Gates Foundation", "people_also_viewed": [{"link": "https://www.linkedin.com/in/johndoe", "location": "Singapore", "name": "John Doe", "summary": "Software Engineer at Google"}], "profile_pic_url": "https://s3.us-west-000.backblazeb2.com/proxycurl/", "public_identifier": "williamhgates", "recommendations": ["Professional and dedicated approach towards clients and collegues."], "similarly_named_profiles": [{"link": "https://www.linkedin.com/in/johndoe", "location": "Singapore", "name": "John Doe", "summary": "Software Engineer at Google"}], "skills": [], "state": "Washington", "summary": "Co-chair of the Bill \u0026 Melinda Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft. Voracious reader. Avid traveler. Active blogger.", "volunteer_work": [{"cause": "To help the world", "company": "Microsoft", "company_linkedin_profile_url": "https://www.linkedin.com/company/microsoft", "description": "", "ends_at": {"day": 1, "month": 8, "year": 2016}, "logo_url": "", "starts_at": {"day": 1, "month": 1, "year": 2012}, "title": "Surveyor"}]}

Response Headers

Header Key Description Example
X-Proxycurl-Credit-Cost Total cost of credits for this API call 3

Employee Count Endpoint

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

Cost: 1 credit / successful request. (Extra charges might be incurred if premium optional parameters are used. Please read the description of the parameters that you intend to use)

Get a number of total employees of a Company.

Get an employee count of this company from various sources.

curl \
    -G \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/linkedin/company/employees/count' \
    --data-urlencode 'url=https://www.linkedin.com/company/apple/' \
    --data-urlencode 'use_cache=if-present' \
    --data-urlencode 'linkedin_employee_count=include' \
    --data-urlencode 'employment_status=current'

import requests

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

Run in Postman

URL Parameters

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

URL should be in the format of https://www.linkedin.com/company/<public_identifier>
 https://www.linkedin.com/company/apple/
use_cache no
if-present: The default behavior. Fetches data from LinkDB cache regardless of age of profile.

if-recent: API will make a best effort to return a fresh data no older than 29 days. Costs an extra 1 credit on top of the cost of the base endpoint.
 if-present
linkedin_employee_count no
Option to include a scraped employee count value from the target company's LinkedIn profile.

Valid values are include and exclude:

* exclude (default) : To exclude the scraped employee count.
* include : To include the scraped employee count.

Costs an extra 1 credit on top of the base cost of the endpoint.
 include
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

Response

{
    "linkdb_employee_count": 3,
    "linkedin_employee_count": 529274
}
Key Description Example
linkedin_employee_count
The scraped value of employee count of this company from it's LinkedIn profile. This value does not respect employement_status parameter. It will always return the curent employee count of this company from LinkedIn.
 99
linkdb_employee_count
The total number of employees found in LinkDB for this company. This value is limited by pre-crawled LinkedIn profiles stored in LinkDB
 3

Response Headers

Header Key Description Example
X-Proxycurl-Credit-Cost Total cost of credits for this API call 1

Company Profile Picture Endpoint

GET /proxycurl/api/linkedin/company/profile-picture

Cost: 0 credit / successful request.

Get the profile picture of a company.

Profile pictures are served from cached company profiles found within LinkDB. If the profile does not exist within LinkDB, then the API will return a 404 status code.

curl \
    -G \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/linkedin/company/profile-picture' \
    --data-urlencode 'linkedin_company_profile_url=https://www.linkedin.com/company/apple/'

import requests

api_key = 'YOUR_API_KEY'
headers = {'Authorization': 'Bearer ' + api_key}
api_endpoint = 'https://nubela.co/proxycurl/api/linkedin/company/profile-picture'
params = {
    'linkedin_company_profile_url': 'https://www.linkedin.com/company/apple/',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=headers)

Run in Postman

URL Parameters

Parameter Required Description Example
linkedin_company_profile_url yes
LinkedIn Profile URL of the company that you are trying to get the profile picture of.
 https://www.linkedin.com/company/apple/

Response

{
    "tmp_profile_pic_url": "https://media.licdn.com/dms/image/C5616AQH9tkBTUhHfng/profile-displaybackgroundimage-shrink_200_800/0/1614530499015?e=2147483647\u0026v=beta\u0026t=VEoCyedtZulnAVYWT9BXfKHi5OFp8avElNjiz8kjSTU"
}
Key Description Example
tmp_profile_pic_url
Temporary URL to the profile picture (valid for just 30 minutes).
See this blog post for more information.
 "https://s3.us-west-000.backblazeb2.com/proxycurl/"

Response Headers

Header Key Description Example
X-Proxycurl-Credit-Cost Total cost of credits for this API call 0

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 \
    -G \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/linkedin/company/resolve' \
    --data-urlencode 'company_domain=accenture.com' \
    --data-urlencode 'company_name=Accenture' \
    --data-urlencode 'company_location=sg' \
    --data-urlencode 'enrich_profile=enrich'

import requests

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

Run in Postman

URL Parameters

Parameter Required Description Example
company_domain Requires either company_domain or company_name
Company website or Company domain
 accenture.com
company_name Requires either company_domain or company_name
Company Name
 Accenture
company_location no
The location / region of company.
ISO 3166-1 alpha-2 codes
 sg
enrich_profile no
Enrich the result with a cached profile of the lookup result.

The valid values are:

* skip (default): do not enrich the results with cached profile data
* enrich: enriches the result with cached profile data

Calling this API endpoint with this parameter would add 1 credit.

If you require fresh profile data,
please chain this API call with the Company Profile Endpoint with the use_cache=if-recent parameter.
 enrich

Response

{
    "profile": {
        "affiliated_companies": [
            {
                "industry": "Software Development",
                "link": "https://www.linkedin.com/company/youtube",
                "location": "San Bruno, CA",
                "name": "YouTube"
            },
            {
                "industry": "Software Development",
                "link": "https://www.linkedin.com/showcase/google-cloud",
                "location": "Mountain View, California",
                "name": "Google Cloud"
            },
            {
                "industry": "Advertising Services",
                "link": "https://www.linkedin.com/showcase/think-with-google",
                "location": "Mountain View, California",
                "name": "Think with Google"
            },
            {
                "industry": "Advertising Services",
                "link": "https://www.linkedin.com/showcase/google-ads-",
                "location": "Mountain View, California",
                "name": "Google Ads"
            },
            {
                "industry": "Software Development",
                "link": "https://www.linkedin.com/showcase/googledevelopers",
                "location": "Mountain View, CA",
                "name": "Google Developers"
            },
            {
                "industry": "Software Development",
                "link": "https://www.linkedin.com/showcase/google-analytics",
                "location": "Mountain View, California",
                "name": "Google Analytics"
            },
            {
                "industry": "IT Services and IT Consulting",
                "link": "https://www.linkedin.com/showcase/googleworkspace",
                "location": "Mountain View, California",
                "name": "Google Workspace"
            },
            {
                "industry": "Advertising Services",
                "link": "https://www.linkedin.com/showcase/googlemarketingplatform",
                "location": "Mountain View, California",
                "name": "Google Marketing Platform"
            },
            {
                "industry": "Software Development",
                "link": "https://www.linkedin.com/showcase/google-developer-groups",
                "location": "Mountain View, CA",
                "name": "Google Developer Groups (GDG)"
            },
            {
                "industry": "Advertising Services",
                "link": "https://www.linkedin.com/showcase/google-ad-manager",
                "location": "Mountain View, California",
                "name": "Google Ad Manager"
            },
            {
                "industry": "E-Learning Providers",
                "link": "https://www.linkedin.com/showcase/grow-with-google",
                "location": "Mountain View, California",
                "name": "Grow with Google"
            },
            {
                "industry": "Software Development",
                "link": "https://www.linkedin.com/showcase/google-for-startups",
                "location": "San Francisco, California",
                "name": "Google for Startups"
            },
            {
                "industry": "Research Services",
                "link": "https://www.linkedin.com/company/x",
                "location": "Mountain View, CA",
                "name": "X, the moonshot factory"
            },
            {
                "industry": "Technology, Information and Internet",
                "link": "https://www.linkedin.com/showcase/google-small-business",
                "location": "Mountain View, California",
                "name": "Google Small Business"
            },
            {
                "industry": "Technology, Information and Internet",
                "link": "https://www.linkedin.com/showcase/google-cloud-partners",
                "location": "Mountain View, California",
                "name": "Google Cloud Partners"
            },
            {
                "industry": "Human Resources Services",
                "link": "https://www.linkedin.com/showcase/rework-with-google",
                "location": null,
                "name": "re:Work with Google"
            },
            {
                "industry": "Advertising Services",
                "link": "https://www.linkedin.com/showcase/google-partners",
                "location": null,
                "name": "Google Partners"
            },
            {
                "industry": "IT Services and IT Consulting",
                "link": "https://www.linkedin.com/showcase/chrome-enterprise",
                "location": null,
                "name": "Chrome Enterprise"
            },
            {
                "industry": "Software Development",
                "link": "https://www.linkedin.com/showcase/androiddev",
                "location": "Mountain View, California",
                "name": "Android Developers"
            },
            {
                "industry": "IT Services and IT Consulting",
                "link": "https://www.linkedin.com/showcase/googleplaybiz",
                "location": "Mountain View, CA",
                "name": "Google Play business community"
            },
            {
                "industry": "Online Audio and Video Media",
                "link": "https://www.linkedin.com/showcase/google-news-initiative",
                "location": "Mountain View, CA",
                "name": "Google News Initiative"
            },
            {
                "industry": "Advertising Services",
                "link": "https://www.linkedin.com/showcase/googleadmob",
                "location": null,
                "name": "Google AdMob"
            },
            {
                "industry": "Software Development",
                "link": "https://www.linkedin.com/showcase/google-health",
                "location": null,
                "name": "Google Health"
            },
            {
                "industry": "Technology, Information and Internet",
                "link": "https://www.linkedin.com/showcase/google-pay",
                "location": "Mountain View, California",
                "name": "Google Pay"
            },
            {
                "industry": "Software Development",
                "link": "https://www.linkedin.com/showcase/google-user-research.",
                "location": null,
                "name": "Google User Experience Research"
            },
            {
                "industry": "Venture Capital and Private Equity Principals",
                "link": "https://ca.linkedin.com/company/capitalg",
                "location": "San Francisco, CA",
                "name": "CapitalG"
            },
            {
                "industry": "Software Development",
                "link": "https://www.linkedin.com/showcase/android_by_google",
                "location": null,
                "name": "Android"
            },
            {
                "industry": "IT Services and IT Consulting",
                "link": "https://www.linkedin.com/showcase/androidenterprise",
                "location": "Mountain View, CA",
                "name": "Android Enterprise"
            },
            {
                "industry": "Software Development",
                "link": "https://ng.linkedin.com/showcase/gwgafrica",
                "location": "Lagos, Lagos",
                "name": "Grow with Google Africa"
            },
            {
                "industry": "Software Development",
                "link": "https://www.linkedin.com/showcase/flutterdevofficial",
                "location": "Mountain View, California",
                "name": "Flutter Dev"
            },
            {
                "industry": "Software Development",
                "link": "https://www.linkedin.com/showcase/firebase",
                "location": "Mountain View, CA",
                "name": "Firebase"
            },
            {
                "industry": "Advertising Services",
                "link": "https://www.linkedin.com/company/adometry",
                "location": "Mountain View, CA",
                "name": "Adometry (acquired by Google)"
            },
            {
                "industry": "Software Development",
                "link": "https://www.linkedin.com/showcase/google-nest",
                "location": "Mountain View, California",
                "name": "Google Nest Pro \u0026 Enterprise Partners"
            },
            {
                "industry": "Software Development",
                "link": "https://www.linkedin.com/showcase/tensorflowdev",
                "location": null,
                "name": "TensorFlow"
            },
            {
                "industry": "Software Development",
                "link": "https://www.linkedin.com/showcase/google-developers-north-america",
                "location": "Mountain View, CA",
                "name": "Google Developers North America"
            },
            {
                "industry": "Technology, Information and Internet",
                "link": "https://www.linkedin.com/showcase/google-chrome",
                "location": "Mountain View, CA",
                "name": "Google Chrome"
            },
            {
                "industry": "Advertising Services",
                "link": "https://www.linkedin.com/showcase/rare-with-google",
                "location": null,
                "name": "Rare with Google"
            },
            {
                "industry": null,
                "link": "https://www.linkedin.com/showcase/flutterdev-hold",
                "location": null,
                "name": "Flutter"
            },
            {
                "industry": null,
                "link": "https://www.linkedin.com/showcase/firebase-hold",
                "location": null,
                "name": "Firebase"
            }
        ],
        "background_cover_image_url": "https://s3.us-west-000.backblazeb2.com/proxycurl/company/google/cover?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=0004d7f56a0400b0000000001%2F20230119%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20230119T060024Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=abb7a4b87583cffda8db24d58d906c644998fae8cbb99e98c69a35720fcd0050",
        "company_size": [
            10001,
            null
        ],
        "company_size_on_linkedin": 319856,
        "company_type": "PUBLIC_COMPANY",
        "description": "A problem isn\u0027t truly solved until it\u0027s solved for all. Googlers build products that help create opportunities for everyone, whether down the street or across the globe. Bring your insight, imagination and a healthy disregard for the impossible. Bring everything that makes you unique. Together, we can build for everyone.\n\nCheck out our career opportunities at careers.google.com.",
        "follower_count": 27472792,
        "founded_year": null,
        "hq": {
            "city": "Mountain View",
            "country": "US",
            "is_hq": true,
            "line_1": "1600 Amphitheatre Parkway",
            "postal_code": "94043",
            "state": "CA"
        },
        "industry": "Software Development",
        "linkedin_internal_id": "1441",
        "locations": [
            {
                "city": "Mountain View",
                "country": "US",
                "is_hq": true,
                "line_1": "1600 Amphitheatre Parkway",
                "postal_code": "94043",
                "state": "CA"
            },
            {
                "city": "New York",
                "country": "US",
                "is_hq": false,
                "line_1": "111 8th Ave",
                "postal_code": "10011",
                "state": "NY"
            },
            {
                "city": "Amsterdam",
                "country": "NL",
                "is_hq": false,
                "line_1": "Claude Debussylaan 34",
                "postal_code": "1082 MD",
                "state": "North Holland"
            },
            {
                "city": "Sao Paulo",
                "country": "BR",
                "is_hq": false,
                "line_1": "Avenida Brigadeiro Faria Lima, 3477",
                "postal_code": "04538-133",
                "state": "SP"
            },
            {
                "city": "Kitchener",
                "country": "CA",
                "is_hq": false,
                "line_1": "51 Breithaupt St",
                "postal_code": "N2H 5G5",
                "state": "ON"
            },
            {
                "city": "Dublin",
                "country": "IE",
                "is_hq": false,
                "line_1": "Barrow Street",
                "postal_code": null,
                "state": "County Dublin"
            },
            {
                "city": "Bengaluru",
                "country": "IN",
                "is_hq": false,
                "line_1": "Old Madras Road",
                "postal_code": "560016",
                "state": "Karnataka"
            },
            {
                "city": "Boulder",
                "country": "US",
                "is_hq": false,
                "line_1": "2590 Pearl St",
                "postal_code": "80302",
                "state": "CO"
            },
            {
                "city": "Seattle",
                "country": "US",
                "is_hq": false,
                "line_1": "601 N 34th St",
                "postal_code": "98103",
                "state": "WA"
            },
            {
                "city": "Sydney",
                "country": "AU",
                "is_hq": false,
                "line_1": "48 Pirrama Rd",
                "postal_code": "2009",
                "state": "NSW"
            },
            {
                "city": "Irvine",
                "country": "US",
                "is_hq": false,
                "line_1": "19510 Jamboree Rd",
                "postal_code": "92612",
                "state": "CA"
            },
            {
                "city": "Chicago",
                "country": "US",
                "is_hq": false,
                "line_1": "320 N Morgan St",
                "postal_code": "60607",
                "state": "IL"
            },
            {
                "city": "Mumbai",
                "country": "IN",
                "is_hq": false,
                "line_1": "3 Bandra Kurla Complex Road",
                "postal_code": "400051",
                "state": "Maharashtra"
            },
            {
                "city": "Taguig City",
                "country": "PH",
                "is_hq": false,
                "line_1": "5th Ave",
                "postal_code": null,
                "state": "National Capital Region"
            },
            {
                "city": "Singapore",
                "country": "SG",
                "is_hq": false,
                "line_1": "3 Pasir Panjang Rd",
                "postal_code": "118484",
                "state": "Singapore"
            },
            {
                "city": "Hyderabad",
                "country": "IN",
                "is_hq": false,
                "line_1": "13",
                "postal_code": "500084",
                "state": "TS"
            },
            {
                "city": "Melbourne",
                "country": "AU",
                "is_hq": false,
                "line_1": "90 Collins St",
                "postal_code": "3000",
                "state": "VIC"
            },
            {
                "city": "San Bruno",
                "country": "US",
                "is_hq": false,
                "line_1": "901 Cherry Ave",
                "postal_code": "94066",
                "state": "CA"
            },
            {
                "city": "Madrid",
                "country": "ES",
                "is_hq": false,
                "line_1": "Plaza Pablo Ruiz Picasso",
                "postal_code": "28046",
                "state": "Community of Madrid"
            },
            {
                "city": "Washington",
                "country": "US",
                "is_hq": false,
                "line_1": "25 Massachusetts Ave NW",
                "postal_code": "20001",
                "state": "DC"
            },
            {
                "city": "Gurugram",
                "country": "IN",
                "is_hq": false,
                "line_1": "15",
                "postal_code": "122001",
                "state": "HR"
            },
            {
                "city": "Bogota",
                "country": "CO",
                "is_hq": false,
                "line_1": "Carrera 11A 94-45",
                "postal_code": "110221",
                "state": "Bogota, D.C."
            },
            {
                "city": "Wan Chai",
                "country": "HK",
                "is_hq": false,
                "line_1": "2 Matheson St",
                "postal_code": null,
                "state": "Hong Kong"
            },
            {
                "city": "Reston",
                "country": "US",
                "is_hq": false,
                "line_1": "1875 Explorer St",
                "postal_code": "20190",
                "state": "VA"
            },
            {
                "city": "Toronto",
                "country": "CA",
                "is_hq": false,
                "line_1": "111 Richmond St W",
                "postal_code": "M5H 2G4",
                "state": "ON"
            },
            {
                "city": "San Francisco",
                "country": "US",
                "is_hq": false,
                "line_1": "345 Spear St",
                "postal_code": "94105",
                "state": "CA"
            },
            {
                "city": "Cambridge",
                "country": "US",
                "is_hq": false,
                "line_1": "355 Main St",
                "postal_code": "02142",
                "state": "MA"
            },
            {
                "city": "Milan",
                "country": "IT",
                "is_hq": false,
                "line_1": "Via Federico Confalonieri, 4",
                "postal_code": "20124",
                "state": "Lomb."
            },
            {
                "city": "London",
                "country": "GB",
                "is_hq": false,
                "line_1": "St Giles High Street",
                "postal_code": "WC2H 8AG",
                "state": "England"
            },
            {
                "city": "Austin",
                "country": "US",
                "is_hq": false,
                "line_1": "9606 N Mopac Expy",
                "postal_code": "78759",
                "state": "TX"
            },
            {
                "city": "Los Angeles",
                "country": "US",
                "is_hq": false,
                "line_1": "340 Main St",
                "postal_code": "90291",
                "state": "CA"
            },
            {
                "city": "Madrid",
                "country": "ES",
                "is_hq": false,
                "line_1": "Plaza Pablo Ruiz Picasso",
                "postal_code": "28020",
                "state": "Community of Madrid"
            },
            {
                "city": "Ann Arbor",
                "country": "US",
                "is_hq": false,
                "line_1": "2300 Traverwood Dr",
                "postal_code": "48105",
                "state": "MI"
            },
            {
                "city": "Las Condes",
                "country": "CL",
                "is_hq": false,
                "line_1": "Avenida Costanera Sur",
                "postal_code": "7550000",
                "state": "Santiago Metropolitan"
            },
            {
                "city": "Atlanta",
                "country": "US",
                "is_hq": false,
                "line_1": "10 10th St NE",
                "postal_code": "30309",
                "state": "GA"
            },
            {
                "city": "Warsaw",
                "country": "PL",
                "is_hq": false,
                "line_1": "ulica Emilii Plater 53",
                "postal_code": "00-125",
                "state": "MA"
            },
            {
                "city": "Bengaluru",
                "country": "IN",
                "is_hq": false,
                "line_1": "3 Swamy Vivekananda Road",
                "postal_code": "560016",
                "state": "Karnataka"
            },
            {
                "city": "Kirkland",
                "country": "US",
                "is_hq": false,
                "line_1": "777 6th St S",
                "postal_code": "98033",
                "state": "WA"
            },
            {
                "city": "Munich",
                "country": "DE",
                "is_hq": false,
                "line_1": "Erika-Mann-Strasse 33",
                "postal_code": "80636",
                "state": "BY"
            },
            {
                "city": "Miguel Hidalgo",
                "country": "MX",
                "is_hq": false,
                "line_1": "Montes Urales",
                "postal_code": "11000",
                "state": "CDMX"
            },
            {
                "city": "Buenos Aires City",
                "country": "AR",
                "is_hq": false,
                "line_1": "Avenida Alicia Moreau de Justo 350",
                "postal_code": "1107",
                "state": "Buenos Aires Autonomous City"
            },
            {
                "city": "Paris",
                "country": "FR",
                "is_hq": false,
                "line_1": "8 Rue de Londres",
                "postal_code": "75009",
                "state": "IdF"
            },
            {
                "city": "Tel Aviv-Yafo",
                "country": "IL",
                "is_hq": false,
                "line_1": "Yigal Allon 98",
                "postal_code": "67891",
                "state": "Tel Aviv"
            },
            {
                "city": "Berlin",
                "country": "DE",
                "is_hq": false,
                "line_1": "Unter den Linden 14",
                "postal_code": "10117",
                "state": "BE"
            },
            {
                "city": "Hamburg",
                "country": "DE",
                "is_hq": false,
                "line_1": "ABC-Strasse 19",
                "postal_code": "20354",
                "state": "HH"
            },
            {
                "city": "Frisco",
                "country": "US",
                "is_hq": false,
                "line_1": "6175 Main St",
                "postal_code": "75034",
                "state": "TX"
            },
            {
                "city": "Zurich",
                "country": "CH",
                "is_hq": false,
                "line_1": "Brandschenkestrasse 110",
                "postal_code": "8002",
                "state": "ZH"
            },
            {
                "city": "Stockholm",
                "country": "SE",
                "is_hq": false,
                "line_1": "Kungsbron 2",
                "postal_code": "111 22",
                "state": "Stockholm County"
            }
        ],
        "name": "Google",
        "profile_pic_url": "https://s3.us-west-000.backblazeb2.com/proxycurl/company/google/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=0004d7f56a0400b0000000001%2F20230119%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20230119T060024Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=0d3500b39da8db1d2d8f5727a9ac39a7c4a88b4632ed68209dee12f06bc79aca",
        "search_id": "1441",
        "similar_companies": [
            {
                "industry": "Software Development",
                "link": "https://www.linkedin.com/company/amazon",
                "location": "Seattle, WA",
                "name": "Amazon"
            },
            {
                "industry": "Software Development",
                "link": "https://www.linkedin.com/company/microsoft",
                "location": "Redmond, Washington",
                "name": "Microsoft"
            },
            {
                "industry": "Computers and Electronics Manufacturing",
                "link": "https://www.linkedin.com/company/apple",
                "location": "Cupertino, California",
                "name": "Apple"
            },
            {
                "industry": "Software Development",
                "link": "https://www.linkedin.com/company/meta",
                "location": "Menlo Park, CA",
                "name": "Meta"
            },
            {
                "industry": "Entertainment Providers",
                "link": "https://www.linkedin.com/company/netflix",
                "location": "Los Gatos, CA",
                "name": "Netflix"
            },
            {
                "industry": "IT Services and IT Consulting",
                "link": "https://www.linkedin.com/company/ibm",
                "location": "Armonk, New York, NY",
                "name": "IBM"
            },
            {
                "industry": "Software Development",
                "link": "https://www.linkedin.com/company/linkedin",
                "location": "Sunnyvale, CA",
                "name": "LinkedIn"
            },
            {
                "industry": "Business Consulting and Services",
                "link": "https://www.linkedin.com/company/deloitte",
                "location": null,
                "name": "Deloitte"
            },
            {
                "industry": "IT Services and IT Consulting",
                "link": "https://in.linkedin.com/company/tata-consultancy-services",
                "location": "Mumbai, Maharashtra",
                "name": "Tata Consultancy Services"
            },
            {
                "industry": "Manufacturing",
                "link": "https://uk.linkedin.com/company/unilever",
                "location": "Blackfriars, London",
                "name": "Unilever"
            }
        ],
        "specialities": [
            "search",
            "ads",
            "mobile",
            "android",
            "online video",
            "apps",
            "machine learning",
            "virtual reality",
            "cloud",
            "hardware",
            "artificial intelligence",
            "youtube",
            "software"
        ],
        "tagline": null,
        "universal_name_id": "google",
        "updates": [
            {
                "article_link": null,
                "image": "https://media.licdn.com/dms/image/C5605AQFthnjiTD6Mvg/videocover-high/0/1660754102856?e=2147483647\u0026v=beta\u0026t=PPOsA9J3vCTXWhuZclqSBQl7DLSDLvy5hKWlkHI85YE",
                "posted_on": {
                    "day": 13,
                    "month": 9,
                    "year": 2022
                },
                "text": "Want to kick start your #LifeAtGoogle but not sure where to begin? Explore our Build Your Future site, where you can learn about developmental programs, learn tips for future interviews, sign up for informational events, and even hear real stories from Googlers who\u2019ve been where you are now. Get started \u2192 https://bit.ly/3SKPzQB",
                "total_likes": 4267
            },
            {
                "article_link": null,
                "image": "https://media.licdn.com/dms/image/C4D22AQGcvTlKRR3qvQ/feedshare-shrink_2048_1536/0/1672854668558?e=1676505600\u0026v=beta\u0026t=whRRx9ULPEuyw_FgUg4Z3N3O9iksyJW7ewCGZA6ujdg",
                "posted_on": null,
                "text": "Ariana, welcome to Google. Here\u2019s to a year full of growth, learning, and experiences at #LifeAtGoogle! \ud83c\udf89",
                "total_likes": 397
            },
            {
                "article_link": null,
                "image": "https://media.licdn.com/dms/image/C4D22AQGcvTlKRR3qvQ/feedshare-shrink_2048_1536/0/1672854668558?e=1676505600\u0026v=beta\u0026t=whRRx9ULPEuyw_FgUg4Z3N3O9iksyJW7ewCGZA6ujdg",
                "posted_on": {
                    "day": 6,
                    "month": 1,
                    "year": 2023
                },
                "text": null,
                "total_likes": 0
            },
            {
                "article_link": null,
                "image": "https://media.licdn.com/dms/image/C5622AQHlEhyso9-BAA/feedshare-shrink_800/0/1672235570251?e=1676505600\u0026v=beta\u0026t=PaHpVodYauVt_Th4eZRJAz_S5LuD_e6MJJZkqEiENBQ",
                "posted_on": {
                    "day": 10,
                    "month": 1,
                    "year": 2023
                },
                "text": "With a new year comes new beginnings. Welcome to Google, Mega, we\u2019re glad you and your #Mewgler are here! #LifeAtGoogle",
                "total_likes": 1252
            },
            {
                "article_link": null,
                "image": "https://media.licdn.com/dms/image/C5622AQHlEhyso9-BAA/feedshare-shrink_800/0/1672235570251?e=1676505600\u0026v=beta\u0026t=PaHpVodYauVt_Th4eZRJAz_S5LuD_e6MJJZkqEiENBQ",
                "posted_on": {
                    "day": 30,
                    "month": 12,
                    "year": 2022
                },
                "text": null,
                "total_likes": 0
            },
            {
                "article_link": null,
                "image": "https://media.licdn.com/dms/image/C5605AQHir6yRaHkgHg/feedshare-thumbnail_720_1280/0/1672258205329?e=2147483647\u0026v=beta\u0026t=ZILK1L9klkFzLD0SKezztfPT5rSbdscMWVcTMgoUeWY",
                "posted_on": {
                    "day": 30,
                    "month": 12,
                    "year": 2022
                },
                "text": "Turn on job alerts and explore all that the Google careers site has to offer \u2192 https://goo.gle/3HCR9kn #LifeAtGoogle",
                "total_likes": 2186
            },
            {
                "article_link": "https://blog.google/inside-google/life-at-google/jennys-path-to-become-a-director-of-customer-engineering/",
                "image": null,
                "posted_on": {
                    "day": 23,
                    "month": 12,
                    "year": 2022
                },
                "text": "\"Leaders at Google ask themselves, \u0027How can we get Googlers from where they are today to where they aspire to be?\u0027\" In the last #MyPathtoGoogle of the year, meet our Director of Customer Engineering based in Hong Kong, Jenny Sun. Jenny shares her path to a leadership role after starting in tech as a software engineer and how her desire to learn has helped her customers, teams, and personal career grow.",
                "total_likes": 2038
            },
            {
                "article_link": "https://fairygodboss.com/articles/im-a-team-lead-at-google-heres-how-ergs-and-mentorship-advanced-my-career",
                "image": null,
                "posted_on": {
                    "day": 23,
                    "month": 12,
                    "year": 2022
                },
                "text": "Meet Nancy Hwang, a Product Activation and Customer Experience team lead here at Google. Earlier this month, Nancy sat down with Fairygodboss to reflect on how mentorship and her involvement in an employee resource group have positively impacted her career journey at Google. \n\nRead about Nancy\u2019s story and her advice on how to advance your career \u2b07\ufe0f",
                "total_likes": 1490
            },
            {
                "article_link": null,
                "image": "https://media.licdn.com/dms/image/C4E22AQG2ZKINx_jsZw/feedshare-shrink_2048_1536/0/1670381081829?e=1676505600\u0026v=beta\u0026t=ywsC6hkhcztq3V61xVvf5go2D_rSr53Waoq3sdlczqY",
                "posted_on": {
                    "day": 23,
                    "month": 12,
                    "year": 2022
                },
                "text": "365 days full of learnings, and more to come! We\u2019re glad you\u2019re part of #LifeAtGoogle, Eunice.",
                "total_likes": 18817
            },
            {
                "article_link": null,
                "image": "https://media.licdn.com/dms/image/C4E22AQG2ZKINx_jsZw/feedshare-shrink_2048_1536/0/1670381081829?e=1676505600\u0026v=beta\u0026t=ywsC6hkhcztq3V61xVvf5go2D_rSr53Waoq3sdlczqY",
                "posted_on": {
                    "day": 13,
                    "month": 12,
                    "year": 2022
                },
                "text": null,
                "total_likes": 0
            },
            {
                "article_link": null,
                "image": null,
                "posted_on": {
                    "day": 23,
                    "month": 12,
                    "year": 2022
                },
                "text": "2022 is almost over, which means it\u2019s time to reflect! Googlers, you shared lots of projects with the world this year. Which was your favorite to work on? Which coworkers made your #LifeAtGoogle brighter every day? Tag them in the comments with a shoutout!",
                "total_likes": 1234
            },
            {
                "article_link": null,
                "image": "https://media.licdn.com/dms/image/C5622AQFLUJbMj4V7Vw/feedshare-shrink_800/0/1670208017850?e=1676505600\u0026v=beta\u0026t=qFxz6eV4tBGTznrHcq_qJw31_TePt6JrrjOXXwMF6Iw",
                "posted_on": {
                    "day": 16,
                    "month": 12,
                    "year": 2022
                },
                "text": "A bit of insight on the Noogler hat tradition from the team that keeps the tradition going! #LifeAtGoogle",
                "total_likes": 3078
            },
            {
                "article_link": null,
                "image": "https://media.licdn.com/dms/image/C5622AQFLUJbMj4V7Vw/feedshare-shrink_800/0/1670208017850?e=1676505600\u0026v=beta\u0026t=qFxz6eV4tBGTznrHcq_qJw31_TePt6JrrjOXXwMF6Iw",
                "posted_on": {
                    "day": 13,
                    "month": 12,
                    "year": 2022
                },
                "text": null,
                "total_likes": 0
            },
            {
                "article_link": null,
                "image": "https://media.licdn.com/dms/image/C5622AQHGS9rpL1dwCA/feedshare-shrink_2048_1536/0/1671117185457?e=1676505600\u0026v=beta\u0026t=7oFrPTZU5gB0uS1mzaVqt13ftFApKTeQah7Ace4iL7U",
                "posted_on": {
                    "day": 16,
                    "month": 12,
                    "year": 2022
                },
                "text": "Chris Kiagiri, Technical Account manager, joined Google 15 years ago, as Kenya\u2019s employee number 2. \n\nLast month at our Google Sandbox Nairobi event, he shared with our participants his career journey and Google\u2019s 15-years of Engineering in Africa.\n\n\u201cI often tell students that Google hadn\u2019t even been founded when I graduated from high school, so they shouldn\u0027t limit their dreams to the opportunities that currently exist.\u201c \n\nThank you to our participants, we hope you left with first-hand experience of what #LifeatGoogle is all about \u2014 and thank you to Chris and all other Googlers who made this experience possible! \n\nWant to learn more? Check out our upcoming and on-demand events here \u003e https://goo.gle/3VDHOg8",
                "total_likes": 1821
            }
        ],
        "website": "https://goo.gle/3m1IN7m"
    },
    "url": "https://www.linkedin.com/company/accenture"
}
Key Description Example
url
The LinkedIn profile URL
 "https://www.linkedin.com/company/accenture"
profile
A LinkedinCompany object
 See LinkedinCompany object

LinkedinCompany

Key Description Example
linkedin_internal_id
LinkedIn's Internal and immutable ID of this Company profile.
 "1441"
description
A textual description of the company.
 "A problem isn\u0027t truly solved until it\u0027s solved for all. Googlers build products that help create opportunities for everyone, whether down the street or across the globe. Bring your insight, imagination and a healthy disregard for the impossible. Bring everything that makes you unique. Together, we can build for everyone.\n\nCheck out our career opportunities at careers.google.com."
website
The URL of the company's website.
 "https://goo.gle/3m1IN7m"
industry
The industry attribute, found in a LinkedIn Company profile, describes the industry in which the company operates. The value of this attribute is an enumerator. This CSV file provides an exhaustive list of possible values for this attribute.
 "Software Development"
company_size
Sequenceed range of company head count
 [10001, null]
company_size_on_linkedin
The size of the company as indicated on LinkedIn.
 319856
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
The year the company was founded.
 null
specialities
A list of specialities.
 ["search", "ads", "mobile", "android", "online video", "apps", "machine learning", "virtual reality", "cloud", "hardware", "artificial intelligence", "youtube", "software"]
locations
List of CompanyLocation
 See CompanyLocation object
name
The name of the company.
 "Google"
tagline
A short, catchy phrase that represents the company's mission or brand.
 "Think Different - But Not Too Different"
universal_name_id
A unique numerical identifier for the company used in the LinkedIn platform.
 "google"
profile_pic_url
The URL of the company's profile picture.
 "https://s3.us-west-000.backblazeb2.com/proxycurl/company/google/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=0004d7f56a0400b0000000001%2F20230119%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20230119T060024Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=0d3500b39da8db1d2d8f5727a9ac39a7c4a88b4632ed68209dee12f06bc79aca"
background_cover_image_url
The URL of the company's background cover image.
 "https://s3.us-west-000.backblazeb2.com/proxycurl/company/google/cover?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=0004d7f56a0400b0000000001%2F20230119%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20230119T060024Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=abb7a4b87583cffda8db24d58d906c644998fae8cbb99e98c69a35720fcd0050"
search_id
Useable with Job listing endpoint
 "1441"
similar_companies
List of SimilarCompany
 See SimilarCompany object
affiliated_companies
List of AffiliatedCompany
 See AffiliatedCompany object
updates
List of CompanyUpdate
 See CompanyUpdate object
follower_count
The number of followers the company has on LinkedIn.
 27472792
acquisitions
A Acquisition object
 See Acquisition object
exit_data
List of Exit
 See Exit object
extra
Company extra when extra=include
 See CompanyDetails object
funding_data
Company Funding data when funding_data=include
 See Funding object
categories
The categories attribute is fetched from the company's Crunchbase profile. Values for this attribute are free-form text, and there is no exhaustive list of categories. Consider the categories attribute as "hints" regarding the products or services offered by the company.
 ["artificial-intelligence", "virtual-reality"]

CompanyLocation

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

SimilarCompany

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

AffiliatedCompany

Key Description Example
name
"LinkedIn"
link
"https://www.linkedin.com/company/linkedin"
industry
"Internet"
location
"Sunnyvale, California"

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
2023

Acquisition

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

AcquiredCompany

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

Acquisitor

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

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

Funding

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

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"

Response Headers

Header Key Description Example
X-Proxycurl-Credit-Cost Total cost of credits for this API call 2

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.

Employee Search Endpoint

GET /proxycurl/api/linkedin/company/employee/search/

Cost: 10 credits / successful request. + 6 credits / employee returned (Extra charges might be incurred if premium optional parameters are used. Please read the description of the parameters that you intend to use)

Search employees of a target by their job title. This API endpoint is syntactic sugar for the role_search parameter under the Employee Listing Endpoint.

This API endpoint is powered by LinkDB, our comprehensive dataset of people and company profiles. Use Role Lookup API Endpoint if you need to query for profiles without LinkDB constraints. The drawbacks of the Role Lookup API Endpoint is that it is less precise and can return at most one result per query.

curl \
    -G \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/linkedin/company/employee/search/' \
    --data-urlencode 'linkedin_company_profile_url=https://www.linkedin.com/company/microsoft/' \
    --data-urlencode 'keyword_regex=ceo|cto' \
    --data-urlencode 'page_size=10' \
    --data-urlencode 'country=us' \
    --data-urlencode 'enrich_profiles=enrich' \
    --data-urlencode 'resolve_numeric_id=false'

import requests

api_key = 'YOUR_API_KEY'
headers = {'Authorization': 'Bearer ' + api_key}
api_endpoint = 'https://nubela.co/proxycurl/api/linkedin/company/employee/search/'
params = {
    'linkedin_company_profile_url': 'https://www.linkedin.com/company/microsoft/',
    'keyword_regex': 'ceo|cto',
    'page_size': '10',
    'country': 'us',
    'enrich_profiles': 'enrich',
    'resolve_numeric_id': 'false',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=headers)

Run in Postman

URL Parameters

Parameter Required Description Example
linkedin_company_profile_url yes
LinkedIn Profile URL of the target company.
 https://www.linkedin.com/company/microsoft/
keyword_regex yes
Job title keyword to search for in regular expression format.

The accepted value for this parameter is a case-insensitive regular expression.
 ceo|cto
page_size no
Tune the maximum results returned per API call.
The default value of this parameter is 200000.
Accepted values for this parameter is an integer ranging from 1 to 200000.
When enrich_profiles=enrich, this parameter accepts value ranging from 1 to 10 and the default value is 100.
 10
country no
Limit the result set to the country locality of the profile. For example, set the parameter of country=us if you only want profiles from the US.

This parameter accepts a case-insensitive Alpha-2 ISO3166 country code.

Costs an extra 3 credit per result returned.
 us
enrich_profiles no
Get the full profile of employees instead of only their profile urls.

Each request respond with a streaming response of profiles.

The valid values are:

* skip (default): lists employee's profile url
* enrich: lists full profile of employees

Calling this API endpoint with this parameter would add 1 credit per employee returned.
 enrich
resolve_numeric_id no
Enable support for Company Profile URLs with numerical IDs that you most frequently fetch from Sales Navigator.
We achieve this by resolving numerical IDs into vanity IDs with cached company profiles from LinkDB.
For example, we will turn https://www.linkedin.com/company/1234567890 to https://www.linkedin.com/company/acme-corp -- for which the API endpoint only supports the latter.

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

Response

{
    "employees": [
        {
            "profile": null,
            "profile_url": "https://www.linkedin.com/in/satyanadella"
        }
    ],
    "next_page": null
}
Key Description Example
employees
List of Employee
 See Employee object
next_page
"https://nubela.co/proxycurl/api/linkedin/company/employees/?page_size=100\u0026employment_status=all\u0026resolve_numeric_id=true\u0026url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2F1035\u0026role_search=%5BFf%5D%5BOo%5D%5BUu%5D%5BNn%5D%5BDd%5D%5BEe%5D%5BRr%5D\u0026after=williamhgates"

Employee

Key Description Example
profile_url
LinkedIn Profile URL of the employee.
 "https://www.linkedin.com/in/williamhgates"
profile
Enriched profile data of the employee.
 {"accomplishment_courses": [{"name": "The course about ABCs", "number": "123"}], "accomplishment_honors_awards": [{"description": "\n Lorem ipsum dolor sit amet\n ", "issued_on": {"day": 1, "month": 1, "year": 1970}, "issuer": "Acme Corp", "title": "Nobel Peace Prize"}], "accomplishment_organisations": [{"description": null, "ends_at": {"day": 1, "month": 8, "year": 2016}, "org_name": "Microsoft", "starts_at": {"day": 1, "month": 1, "year": 2012}, "title": "Software Developer"}], "accomplishment_patents": [{"application_number": "123", "description": "\n Lorem ipsum dolor sit amet\n ", "issued_on": {"day": 1, "month": 1, "year": 1970}, "issuer": "Acme Corp", "patent_number": "123", "title": "The art of war", "url": null}], "accomplishment_projects": [{"description": "", "ends_at": {"day": 2, "month": 8, "year": 2023}, "starts_at": {"day": 1, "month": 8, "year": 2023}, "title": "Project Manhattan", "url": ""}], "accomplishment_publications": [{"description": "\n Lorem ipsum dolor sit amet\n ", "name": "Nobel Peace Prize", "published_on": {"day": 1, "month": 1, "year": 1970}, "publisher": "Acme Corp", "url": "https://example.com"}], "accomplishment_test_scores": [{"date_on": {"day": 1, "month": 1, "year": 2010}, "description": "Nailed it without studying.", "name": "CS1101S", "score": "A"}], "activities": [{"activity_status": "Active", "link": "", "title": "Volunteer"}], "articles": [{"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", "link": "https://www.linkedin.com/pulse/manufacturing-opportunity-bill-gates/", "published_date": {"day": 27, "month": 11, "year": 2019}, "title": "Manufacturing opportunity"}], "background_cover_image_url": "", "certifications": [{"authority": "Duolingo", "display_source": "", "ends_at": {"day": 1, "month": 1, "year": 2025}, "license_number": "", "name": "Kubernetes for Dummies", "starts_at": {"day": 1, "month": 1, "year": 2021}, "url": ""}], "city": "Seattle", "connections": 100, "country": "US", "country_full_name": "United States of America", "education": [{"activities_and_societies": "", "degree_name": "", "description": "", "ends_at": {"day": 31, "month": 12, "year": 1975}, "field_of_study": "", "grade": "", "logo_url": "https://media-exp1.licdn.com/dms/image/C4E0BAQF5t62bcL0e9g/company-logo_400_400/0/1519855919126?e=1672876800\u0026v=beta\u0026t=9twXof1JlnNHfFprrDMi-C1Kp55HTT4ahINKHRflUHw", "school": "Harvard University", "school_linkedin_profile_url": "", "starts_at": {"day": 1, "month": 1, "year": 1973}}], "experiences": [{"company": "Breakthrough Energy ", "company_linkedin_profile_url": "https://www.linkedin.com/company/breakthrough-energy/", "description": "", "ends_at": {"day": 2, "month": 8, "year": 2023}, "location": "", "logo_url": "https://media-exp1.licdn.com/dms/image/C4D0BAQGwD9vNu044FA/company-logo_400_400/0/1601560874941?e=1672876800\u0026v=beta\u0026t=VKb6OAHEwlnazKYKm4fc9go-y4zkUv2BT6tosOdQ54Y", "starts_at": {"day": 1, "month": 1, "year": 2000}, "title": "Founder"}], "first_name": "Bill", "follower_count": 100, "full_name": "Bill Gates", "groups": [{"name": "Hadoop Users", "profile_pic_url": "https://media-exp1.licdn.com/dms/image/C4D07AQG9IK9V0pk3mQ/group-logo_image-shrink_92x92/0/1631371531293?e=1642060800\u0026v=beta\u0026t=UK1tfIppWa-Nx7k9whmm5f9XdZoBdJhApf9N3ke3204", "url": "https://www.linkedin.com/groups/988957"}], "headline": "Co-chair, Bill \u0026 Melinda Gates Foundation", "languages": ["English"], "last_name": "Gates", "occupation": "Co-chair at Bill \u0026 Melinda Gates Foundation", "people_also_viewed": [{"link": "https://www.linkedin.com/in/johndoe", "location": "Singapore", "name": "John Doe", "summary": "Software Engineer at Google"}], "profile_pic_url": "https://s3.us-west-000.backblazeb2.com/proxycurl/", "public_identifier": "williamhgates", "recommendations": ["Professional and dedicated approach towards clients and collegues."], "similarly_named_profiles": [{"link": "https://www.linkedin.com/in/johndoe", "location": "Singapore", "name": "John Doe", "summary": "Software Engineer at Google"}], "skills": [], "state": "Washington", "summary": "Co-chair of the Bill \u0026 Melinda Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft. Voracious reader. Avid traveler. Active blogger.", "volunteer_work": [{"cause": "To help the world", "company": "Microsoft", "company_linkedin_profile_url": "https://www.linkedin.com/company/microsoft", "description": "", "ends_at": {"day": 1, "month": 8, "year": 2016}, "logo_url": "", "starts_at": {"day": 1, "month": 1, "year": 2012}, "title": "Surveyor"}]}

Response Headers

Header Key Description Example
X-Proxycurl-Credit-Cost Total cost of credits for this API call 10

People API

Person Profile Endpoint

GET /proxycurl/api/v2/linkedin

Cost: 1 credit / successful request. (Extra charges might be incurred if premium optional parameters are used. Please read the description of the parameters that you intend to use)

Get structured data of a Personal Profile

curl \
    -G \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/v2/linkedin' \
    --data-urlencode 'twitter_profile_url=https://twitter.com/johnrmarty/' \
    --data-urlencode 'facebook_profile_url=https://facebook.com/johnrmarty/' \
    --data-urlencode 'linkedin_profile_url=https://linkedin.com/in/johnrmarty/' \
    --data-urlencode 'extra=include' \
    --data-urlencode 'github_profile_id=include' \
    --data-urlencode 'facebook_profile_id=include' \
    --data-urlencode 'twitter_profile_id=include' \
    --data-urlencode 'personal_contact_number=include' \
    --data-urlencode 'personal_email=include' \
    --data-urlencode 'inferred_salary=include' \
    --data-urlencode 'skills=include' \
    --data-urlencode 'use_cache=if-present' \
    --data-urlencode 'fallback_to_cache=on-error'

import requests

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

Run in Postman

URL Parameters

Parameter Required Description Example
twitter_profile_url yes (Include only one of: linkedin_profile_url, twitter_profile_url, or facebook_profile_url)
The Twitter Profile URL from which you wish to extract person profile

URL should be in the format of https://twitter.com/<public-identifier>
 https://twitter.com/johnrmarty/
facebook_profile_url yes (Include only one of: linkedin_profile_url, twitter_profile_url, or facebook_profile_url)
The Facebook Profile URL from which you wish to extract person profile

URL should be in the format of https://facebook.com/<public-identifier>
 https://facebook.com/johnrmarty/
linkedin_profile_url yes (Include only one of: linkedin_profile_url, twitter_profile_url, or facebook_profile_url)
The LinkedIn Profile URL from which you wish to extract person profile

URL should be in the format of https://linkedin.com/in/<public-identifier>
 https://linkedin.com/in/johnrmarty/
extra no
Enriches the Person Profile with extra details from external sources.
Extra details include gender, birth date, industry and interests.

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

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

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

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

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

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

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

This parameter accepts the following values:
- exclude (default value) - Does not provide skills data field.
- include - Append skills data to the person profile object.
Costs an extra 1 credit on top of the cost of the base endpoint (if data is available).
 include
use_cache no
if-present The default behavior.
Fetches profile from cache regardless of age of profile.
If profile is not available in cache, API will attempt to source profile externally.

if-recent API will make a best effort to return a fresh profile no older than 29 days."
Costs an extra 1 credit on top of the cost of the base endpoint.
 if-present
fallback_to_cache no
Tweaks the fallback behavior if an error arises from fetching a fresh profile.

This parameter accepts the following values:
* on-error (default value) - Fallback to reading the profile from cache if an error arises.
* never - Do not ever read profile from cache.
 on-error

Response

{
    "accomplishment_courses": [],
    "accomplishment_honors_awards": [],
    "accomplishment_organisations": [],
    "accomplishment_patents": [],
    "accomplishment_projects": [
        {
            "description": "gMessenger was built using Ruby on Rails, and the Bootstrap HTML, CSS, and JavaScript framework. It uses a Websocket-Rails integration to post a user\u0027s message content to the page in real time, with no page refresh required. gMessenger also includes custom authentication with three different permissions levels.",
            "ends_at": null,
            "starts_at": {
                "day": 1,
                "month": 3,
                "year": 2015
            },
            "title": "gMessenger",
            "url": "http://gmessenger.herokuapp.com/"
        },
        {
            "description": "A task and project management responsive web app utilizing Ruby on Rails - CSS and HTML",
            "ends_at": null,
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2015
            },
            "title": "Taskly",
            "url": "https://hidden-coast-7204.herokuapp.com/"
        },
        {
            "description": "Injection molded residential and commercial wall mounts for iPads and iPods. This stylish flush wall mounted solution is meant to be used in conjunction with any Home Automation System.",
            "ends_at": null,
            "starts_at": {
                "day": 1,
                "month": 5,
                "year": 2013
            },
            "title": "Simple Wall Mount",
            "url": "http://www.simplewallmount.com"
        },
        {
            "description": "Overwatch Safety Systems is developing an advanced warning and information distribution system to assist law enforcement and first responders with active shooter situations in public and private venues. The system utilizes modern sonic detection algorithms to sense and announce the position of active threats to people and property. This technology is also being designed as a hi-tech electronic deterrent for high profile or vulnerable venues.",
            "ends_at": null,
            "starts_at": null,
            "title": "Overwatch Safety Systems",
            "url": null
        }
    ],
    "accomplishment_publications": [],
    "accomplishment_test_scores": [],
    "activities": [
        {
            "activity_status": "Shared by John Marty",
            "link": "https://www.linkedin.com/posts/johnrmarty_financialfreedom-realestate-technology-activity-6940294635743301632-rsLo",
            "title": "Yesterday I toured a $1.2M property in California that has a large 13K sq ft lot with two homes on it. After 5 minutes of being on-site I\u2026"
        }
    ],
    "articles": [],
    "background_cover_image_url": "https://media.licdn.com/dms/image/C5616AQH9tkBTUhHfng/profile-displaybackgroundimage-shrink_200_800/0/1614530499015?e=2147483647\u0026v=beta\u0026t=VEoCyedtZulnAVYWT9BXfKHi5OFp8avElNjiz8kjSTU",
    "certifications": [
        {
            "authority": "Scaled Agile, Inc.",
            "display_source": null,
            "ends_at": null,
            "license_number": null,
            "name": "SAFe Agile Framework Practitioner - ( Scrum, XP, and Lean Practices in the SAFe Enterprise)",
            "starts_at": null,
            "url": null
        },
        {
            "authority": "Scrum Alliance",
            "display_source": null,
            "ends_at": null,
            "license_number": null,
            "name": "SCRUM Alliance Certified Product Owner",
            "starts_at": null,
            "url": null
        },
        {
            "authority": "Scaled Agile, Inc.",
            "display_source": null,
            "ends_at": null,
            "license_number": null,
            "name": "Scaled Agile Framework PM/PO",
            "starts_at": null,
            "url": null
        }
    ],
    "city": "Seattle",
    "connections": 500,
    "country": "US",
    "country_full_name": "United States of America",
    "education": [
        {
            "activities_and_societies": null,
            "degree_name": "Master of Business Administration (MBA)",
            "description": null,
            "ends_at": {
                "day": 31,
                "month": 12,
                "year": 2015
            },
            "field_of_study": "Finance + Economics",
            "grade": null,
            "logo_url": "https://media.licdn.com/dms/image/C560BAQGVi9eAHgWxFw/company-logo_100_100/0/1673448029676?e=2147483647\u0026v=beta\u0026t=NG6ttckXvnS2DX3abTfVACRY2E9Q1EcryNaJLRbE9OE",
            "school": "University of Colorado Denver",
            "school_linkedin_profile_url": "https://www.linkedin.com/school/university-of-colorado-denver/",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2013
            }
        },
        {
            "activities_and_societies": null,
            "degree_name": null,
            "description": "rails, ruby, rspec, capybara, bootstrap, css, html, api integration, Jquery, Javascript",
            "ends_at": {
                "day": 31,
                "month": 12,
                "year": 2015
            },
            "field_of_study": "School of Software Development",
            "grade": null,
            "logo_url": "https://media.licdn.com/dms/image/C560BAQFKNxOZ4X0g8Q/company-logo_100_100/0/1670610916338?e=2147483647\u0026v=beta\u0026t=t7ImfhmsuIJ7HJGHEbPJ2suxdslKhzp9v-5h9_G4sWE",
            "school": "Galvanize Inc",
            "school_linkedin_profile_url": "https://www.linkedin.com/school/galvanize-it/",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2015
            }
        },
        {
            "activities_and_societies": null,
            "degree_name": "BA",
            "description": null,
            "ends_at": {
                "day": 31,
                "month": 12,
                "year": 2005
            },
            "field_of_study": "Business",
            "grade": null,
            "logo_url": "https://media.licdn.com/dms/image/C4D0BAQGs5hZ3ROf-iw/company-logo_100_100/0/1519856111543?e=2147483647\u0026v=beta\u0026t=62k4mEoRdeQf4C6AF12Z05_t6i1VgNk50jr7RHkEsf8",
            "school": "Fort Lewis College",
            "school_linkedin_profile_url": "https://www.linkedin.com/school/fort-lewis-college/",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 1999
            }
        },
        {
            "activities_and_societies": null,
            "degree_name": "Japanese Language and Literature",
            "description": null,
            "ends_at": {
                "day": 31,
                "month": 12,
                "year": 2002
            },
            "field_of_study": null,
            "grade": null,
            "logo_url": null,
            "school": "Yamasa Institute Okazaki Japan",
            "school_linkedin_profile_url": null,
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2002
            }
        },
        {
            "activities_and_societies": null,
            "degree_name": null,
            "description": null,
            "ends_at": {
                "day": 31,
                "month": 12,
                "year": 2000
            },
            "field_of_study": "Spanish Language and Literature",
            "grade": null,
            "logo_url": null,
            "school": "Inter American University of Puerto Rico",
            "school_linkedin_profile_url": "https://www.linkedin.com/school/inter-american-university-of-puerto-rico/",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2000
            }
        },
        {
            "activities_and_societies": null,
            "degree_name": "High School",
            "description": null,
            "ends_at": {
                "day": 31,
                "month": 12,
                "year": 1999
            },
            "field_of_study": null,
            "grade": null,
            "logo_url": null,
            "school": "Western Reserve Academy",
            "school_linkedin_profile_url": null,
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 1996
            }
        }
    ],
    "experiences": [
        {
            "company": "Freedom Fund Real Estate",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/freedomfund",
            "description": "Our mission is to provide everyday people seeking financial freedom long before the age of 65 with the ability to invest in high yield, short-term real estate investments that were only accessible in the past for a select few wealthy individuals. Each of our single family rehab projects require a minimum investment contribution of only $10K, we have simple terms, no multi-year hold periods, and no fees. With our unique model investors can log into our easy to use website, select the projects that they want to invest in, and get realtime updates on the status of their investments.\n\nWebsite: https://www.freedomfundinvestments.com/home",
            "ends_at": null,
            "location": null,
            "logo_url": "https://media.licdn.com/dms/image/C560BAQEYxazZM_hXgQ/company-logo_100_100/0/1634934418976?e=2147483647\u0026v=beta\u0026t=wI0YdMmxIctkzvnKxRfuAbT8h5eok_DlUqEph68J37s",
            "starts_at": {
                "day": 1,
                "month": 8,
                "year": 2021
            },
            "title": "Co-Founder"
        },
        {
            "company": "Mindset Reset Podcast",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/mindset-reset-podcast",
            "description": "We dive into the mindsets of the world\u2019s foremost thought leaders and turn them into actionable insights so that others can discover greater happiness, success, and fulfillment.\n\nhttps://podcasts.apple.com/us/podcast/mindset-reset/id1553212607",
            "ends_at": null,
            "location": "Denver, Colorado, United States",
            "logo_url": "https://media.licdn.com/dms/image/C560BAQF9QJVQm3SOvA/company-logo_100_100/0/1614527476576?e=2147483647\u0026v=beta\u0026t=m3tx83nMN-E3XQFoJG0Wmch8U4qKnJ9i--5NSAfffC0",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2021
            },
            "title": "Founder"
        },
        {
            "company": "Product School",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/product-school",
            "description": "Product School is a global leader in Product Management training with a community of over one million product professionals. As a featured speaker, I help inspire the next generation of Product Managers to create innovative products and apply best practices in their work.",
            "ends_at": {
                "day": 31,
                "month": 12,
                "year": 2020
            },
            "location": "Seattle, Washington, United States",
            "logo_url": "https://media.licdn.com/dms/image/C4E0BAQEKULb2pMnazw/company-logo_100_100/0/1657091674586?e=2147483647\u0026v=beta\u0026t=vgcwRvTFf1v-AxyFXfFuEm07g8Nlzsha12E6-aBj6lk",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2020
            },
            "title": "Featured Speaker"
        },
        {
            "company": "Project 1B",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/project-1b",
            "description": "The mission of Project 1B is to help 1 Billion people around the world maximize their sense of meaning so that they can lead more fulfilling lives. We do this through exposing the truth about success and happiness through the Mindset Reset Podcast, corporate training, youth education programs, group coaching, and investments in tech startups aligned with our mission.\n\nThe word success is widely understood as the attainment of financial gain, but somewhere along the lines we began believing that money = happiness, self worth, and meaning even though money has nothing to do with these things. Because of this twisted equation, young adults often make career decisions that solely maximize earning potential. And Ironically, if they manage to achieve society\u2019s definition of success, It often leaves many with a sense of meaninglessness.\n\nIf you want to live a meaningful life chase the word meaning as opposed to the word success - this simple shift in mindset will lead to a more authentic set of questions about the direction you should take your life.",
            "ends_at": null,
            "location": "Denver, Colorado, United States",
            "logo_url": "https://media.licdn.com/dms/image/C560BAQFG_MrwBC_iZg/company-logo_100_100/0/1594610187483?e=2147483647\u0026v=beta\u0026t=7NNWG1ZclbNsUW0k0PuD-v5xTmfpIcthOmHCDyMwWMk",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2020
            },
            "title": "Founder"
        },
        {
            "company": "YouTube",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/youtube",
            "description": "Mission: to help others land their dream jobs at a top tech companies that aligns with their passions.",
            "ends_at": null,
            "location": "Greater Seattle Area",
            "logo_url": "https://media.licdn.com/dms/image/C4D0BAQEfoRsyU4yUzg/company-logo_100_100/0/1631053379295?e=2147483647\u0026v=beta\u0026t=CmnUj5LeO5Yi-nA9xLgEYBPU5eZdLrPBG2qXmPhhoe4",
            "starts_at": {
                "day": 1,
                "month": 2,
                "year": 2019
            },
            "title": "YouTube Content Creator - \"Tech Careers for Non-Engineers\""
        },
        {
            "company": "YouTube",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/youtube",
            "description": null,
            "ends_at": null,
            "location": "Seattle, Washington",
            "logo_url": "https://media.licdn.com/dms/image/C4D0BAQEfoRsyU4yUzg/company-logo_100_100/0/1631053379295?e=2147483647\u0026v=beta\u0026t=CmnUj5LeO5Yi-nA9xLgEYBPU5eZdLrPBG2qXmPhhoe4",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2017
            },
            "title": "Youtube Content Creator - \"John Marty\""
        },
        {
            "company": "Amazon",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/amazon",
            "description": "I had a mix of roles at Amazon from Sr. PM to Sr. Manager of Product\nTwo years were spent on Marketplace Product Quality and 2 years in New Business Innovation",
            "ends_at": {
                "day": 31,
                "month": 3,
                "year": 2021
            },
            "location": "Greater Seattle Area",
            "logo_url": "https://media.licdn.com/dms/image/C560BAQHTvZwCx4p2Qg/company-logo_100_100/0/1612205615891?e=2147483647\u0026v=beta\u0026t=PG9v_TmuSDxc9nAjnwxAFTWfFwhri5iJcJ4bcODhtPA",
            "starts_at": {
                "day": 1,
                "month": 3,
                "year": 2017
            },
            "title": "Sr. Manager of Product"
        },
        {
            "company": "American Express",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/american-express",
            "description": null,
            "ends_at": {
                "day": 31,
                "month": 3,
                "year": 2017
            },
            "location": "Phoenix, Arizona Area",
            "logo_url": "https://media.licdn.com/dms/image/C4D0BAQGRhsociEn4gQ/company-logo_100_100/0/1523269243842?e=2147483647\u0026v=beta\u0026t=SHRbiG3uqsCTfE1Gyd77tgJWtHAm4cYp-c6uILKTVNs",
            "starts_at": {
                "day": 1,
                "month": 7,
                "year": 2015
            },
            "title": "Senior Global Product Manager"
        },
        {
            "company": "Mile High Automation, Inc.",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/mile-high-automation-inc-",
            "description": "Mile High Automation is a Smart Home Technology (Internet of Things) software and hardware development company. Our mission is to flawlessly develop and deliver impeccable software, hardware and system design for the high-end consumer market nationally and internationally. \n\n\u2022  Performed a short term change management engagement to lead a 12 member cross functional team through a major strategy and vision transition\n\u2022  Developed an international supply chain that increased profit margin by 30% on core products\n\u2022  Conceptualized, implemented, and rolled out a CRM that led to a 15% higher month over month close rate; trained sales team on newly created key performance indicators to maximize growth\n\u2022  Developed, implemented and oversaw a training process that scaled to 180+ national subcontractors\n\u2022  Translated user stories into detailed product requirements documents that the software development team used to build new features and functionality \n\u2022  Developed benchmarks for customer service, sales, and traffic conversion to maximize profit",
            "ends_at": {
                "day": 31,
                "month": 7,
                "year": 2014
            },
            "location": "Denver Colorado",
            "logo_url": "https://media.licdn.com/dms/image/C4E0BAQHofg3toK4P7A/company-logo_100_100/0/1519903210468?e=2147483647\u0026v=beta\u0026t=vasirOnrmfFkQru9S8JBNtci00COt_s9x2AOexxqd-8",
            "starts_at": {
                "day": 1,
                "month": 3,
                "year": 2014
            },
            "title": "Sr. Product Manager"
        },
        {
            "company": "EOS Controls",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/eos-controls",
            "description": "A Smart Home Technology (Internet of Things) software and hardware development company specializing in the mid to high-end condominium market in the United States and South America. \nEOS Controls supports the advancement of affordable and easy to user smart home technology through a network of non-traditional sales channels of architects, designers, and contractors. \n\n\u2022  Coordinated engineering, design, and marketing strategy for the launch of 6 iOS apps\n\u2022  Led a 5 member product team of engineers; conducted daily stand-ups and weekly design review meetings\n\u2022  Managed and prioritized product backlog for development Sprints as well as tested products before release\n\u2022  Effectively placed products through non-traditional distribution channels by identifying and developing relationships with over 100 national and international builders, architects, and designers",
            "ends_at": {
                "day": 31,
                "month": 5,
                "year": 2014
            },
            "location": "Miami, Florida",
            "logo_url": "https://media.licdn.com/dms/image/C560BAQFV1hvbuwyU-A/company-logo_100_100/0/1519867781218?e=2147483647\u0026v=beta\u0026t=s5UGQj-N-5VatokXj3YN6IxOPmKpUZeetC5OZH-B-xU",
            "starts_at": {
                "day": 1,
                "month": 2,
                "year": 2012
            },
            "title": "Founder/ Chief Operating Officer"
        },
        {
            "company": "Axxis Audio",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/axxis-audio",
            "description": "Specializing in Smart Home Technology - Home Automation, Internet of Things\n\n\u2022  Raised $10,000 in investment to develop a home theater and home automation sales and installation business that grew to multi-million dollar sales (sold the company in 2011)\n\u2022  Developed mission-centric training, responsibility, and accountability framework \n\u2022  10 Direct Reports\n\u2022  Responsible for resource planning, scheduling, and project management \n\u2022  Filled the role of HR and developed a team building program for 10 direct reports, that included formal training, personal and professional peer support, mentoring and professional development; resulting in 20% higher retention rate and improved trust and communication\n\u2022  Deployed an ERP Solution in 2007 that unified 5 departments and provided a central reporting and accountability framework for a 23% employees productivity gain\n\u2022  Handled acquisition of 2nd largest competitor Cobalt Automation",
            "ends_at": {
                "day": 31,
                "month": 1,
                "year": 2012
            },
            "location": "Durango Colorado",
            "logo_url": "https://media.licdn.com/dms/image/C560BAQHI-DLifzJs9Q/company-logo_100_100/0/1519868629336?e=2147483647\u0026v=beta\u0026t=l1Sk5NQO2Mtpo7HpppRkMhogjVXCwx5yxIxhcwUpNuc",
            "starts_at": {
                "day": 1,
                "month": 11,
                "year": 2002
            },
            "title": "President/Founder"
        }
    ],
    "first_name": "John",
    "follower_count": null,
    "full_name": "John Marty",
    "groups": [],
    "headline": "Financial Freedom through Real Estate - LinkedIn Top Voice",
    "languages": [
        "English",
        "Spanish",
        "Japanese"
    ],
    "last_name": "Marty",
    "occupation": "Co-Founder at Freedom Fund Real Estate",
    "people_also_viewed": [],
    "profile_pic_url": "https://media.licdn.com/dms/image/C5603AQHaJSx0CBAUIA/profile-displayphoto-shrink_800_800/0/1558325759208?e=2147483647\u0026v=beta\u0026t=BluXpPg88xFnU2wMGLjuCUykSk_wKNdh8x3PI9wm6MI",
    "public_identifier": "johnrmarty",
    "recommendations": [
        "Rebecca Canfield\n\n      \n          \n          \n\n\n\n              \n                \n        \n              \n  \n\n      \n          John Marty is a genius at his craft. He is skilled in the art of making people feel empowered to seek out roles that they are qualified for, ask for salaries that they deserve, and creates a kind of pay it forward lifestyle. John helps you to get to places that you only thought were possible for other people. Anyone that is fortunate enough to learn from John should consider themselves extremely lucky. I know I do. ",
        "Zoe Sanoff\n\n      \n          \n          \n\n\n\n              \n                \n        \n              \n  \n\n      \n          John is so focused on helping guide you through an interview process not just for Amazon but on interviewing in general.  I\u0027ve generally done well at interviewing, my skills are top notch now.  John is so focused on on his clients and really goes above and beyond.  John is genuine, knowledgeable, well spoken and non-judgemental.  He is so encouraging, so positive and really easy to talk to.  Thank you John!"
    ],
    "similarly_named_profiles": [
        {
            "link": "https://www.linkedin.com/in/john-martinez-90384a229",
            "location": "San Antonio, TX",
            "name": "John Martinez",
            "summary": "Owner of Fight or Flight Medical Consultants, LLC  , Owner Marty\u2019s Hardwood Works"
        },
        {
            "link": "https://www.linkedin.com/in/senatormarty",
            "location": "St Paul, MN",
            "name": "John Marty",
            "summary": null
        },
        {
            "link": "https://www.linkedin.com/in/johnmarty",
            "location": "Orlando, FL",
            "name": "John Marty",
            "summary": "Lead Software Engineer, Commerce at Disney Parks  \u0026 Resorts Digital"
        },
        {
            "link": "https://www.linkedin.com/in/john-marty-ba56b478",
            "location": "Sarver, PA",
            "name": "John Marty",
            "summary": "Podiatrist at Ankle and Foot care inc"
        }
    ],
    "state": "Washington",
    "summary": "Most people go through life lost, disengaged, and unhappy at work and in their lives - I\u0027m on a mission to solve that.\n\nI spent 10 years as the founder of Axxis Audio, an electronics company that grew to multi-million dollar sales, which I sold in 2012. At that time, I funneled my earnings into the creation of an Internet of Things company, but numerous factors lead to its demise after 2 hard fought years. \n\nAt 31, I was penny-less, had a baby on the way, and had zero job prospects (despite applying to 150 companies). My desperate situation led me to take a job at Best Buy for $12 an hour while reinventing myself through the completion of an MBA at the University of Colorado, and a 6-month software development boot camp. \n\nAfter graduation, I landed at American Express as a Senior Product Manager and then got poached by Amazon in 2017 (because of my LinkedIn profile). My journey has led to a deep sense of perspective, humility, and purpose that I draw on to help others find clarity, meaning, and happiness in their careers and lives. \n\nCheck out my website for details on my Mindset Reset Podcast, Public Speaking, Consulting, or my free 40 page LinkedIn guide\n\nhttp://www.johnraphaelmarty.com/\n\nFAQ\u0027s\n\nQ: Can you speak at my Company, University, event or podcast?\nA: I\u0027d love to! I\u0027ve shared my message on the future of employment, breaking into big tech, and my personal story of reinventing myself and discovering my sense of purpose (and how you can too!).\n\n\u2611\ufe0f  YouTube Channel #1 (John Marty) : http://www.youtube.com/c/JohnMarty-uncommon\n\u2611\ufe0f  YouTube Channel #2 (Tech Careers for non-engineers: https://www.youtube.com/channel/UC900gMMPLwRGGXSTW1gdZHA\n\nFUN FACTS:\n\u2611\ufe0f I am an Avid cyclist and runner, and I just started learning to skateboard a half-pipe.\n\u2611\ufe0f Into the Enneagram? - I\u0027m a #3 (The Achiever)\n\nLETS CONNECT:\n\u2611\ufe0f Email: [email protected] (don\u0027t forget that \"R\"....The other guy gets my emails all the time)",
    "volunteer_work": []
}
Key Description Example
public_identifier
The vanity identifier of the public LinkedIn profile.
The vanity identifier comes after the /in/ part of the LinkedIn Profile URL
in the following format: https://www.linkedin.com/in/<public_identifier>
 "johnrmarty"
profile_pic_url
A temporary link to the user's profile picture that is valid for 30 minutes.
The temporal nature of the link is by design to prevent having Proxycurl be the mirror for the images.
The developer is expected to handle these images by downloading the image and re-hosting the image.
See this post for context.
Some profile pictures might be of the standard LinkedIn's profile picture placeholder. It is so because. See this post for context.
 "https://media.licdn.com/dms/image/C5603AQHaJSx0CBAUIA/profile-displayphoto-shrink_800_800/0/1558325759208?e=2147483647\u0026v=beta\u0026t=BluXpPg88xFnU2wMGLjuCUykSk_wKNdh8x3PI9wm6MI"
background_cover_image_url
A temporary link to the user's background cover picture
that is valid for 30 minutes.
The temporal nature of the link is by design to prevent
having Proxycurl be the mirror for the images.
The developer is expected to handle these images
by downloading the image and re-hosting the image.
See this post for context.
 "https://media.licdn.com/dms/image/C5616AQH9tkBTUhHfng/profile-displaybackgroundimage-shrink_200_800/0/1614530499015?e=2147483647\u0026v=beta\u0026t=VEoCyedtZulnAVYWT9BXfKHi5OFp8avElNjiz8kjSTU"
first_name
First name of the user.
 "John"
last_name
Last name of the user.
 "Marty"
full_name
Full name of the user (first_name + last_name)
 "John Marty"
follower_count
Follower count for this profile
 null
occupation
The title and company name of the user's current employment.
 "Co-Founder at Freedom Fund Real Estate"
headline
The tagline written by the user for his profile.
 "Financial Freedom through Real Estate - LinkedIn Top Voice"
summary
A blurb (longer than the tagline) written by the user for his profile.
 "Most people go through life lost, disengaged, and unhappy at work and in their lives - I\u0027m on a mission to solve that.\n\nI spent 10 years as the founder of Axxis Audio, an electronics company that grew to multi-million dollar sales, which I sold in 2012. At that time, I funneled my earnings into the creation of an Internet of Things company, but numerous factors lead to its demise after 2 hard fought years. \n\nAt 31, I was penny-less, had a baby on the way, and had zero job prospects (despite applying to 150 companies). My desperate situation led me to take a job at Best Buy for $12 an hour while reinventing myself through the completion of an MBA at the University of Colorado, and a 6-month software development boot camp. \n\nAfter graduation, I landed at American Express as a Senior Product Manager and then got poached by Amazon in 2017 (because of my LinkedIn profile). My journey has led to a deep sense of perspective, humility, and purpose that I draw on to help others find clarity, meaning, and happiness in their careers and lives. \n\nCheck out my website for details on my Mindset Reset Podcast, Public Speaking, Consulting, or my free 40 page LinkedIn guide\n\nhttp://www.johnraphaelmarty.com/\n\nFAQ\u0027s\n\nQ: Can you speak at my Company, University, event or podcast?\nA: I\u0027d love to! I\u0027ve shared my message on the future of employment, breaking into big tech, and my personal story of reinventing myself and discovering my sense of purpose (and how you can too!).\n\n\u2611\ufe0f YouTube Channel #1 (John Marty) : http://www.youtube.com/c/JohnMarty-uncommon\n\u2611\ufe0f YouTube Channel #2 (Tech Careers for non-engineers: https://www.youtube.com/channel/UC900gMMPLwRGGXSTW1gdZHA\n\nFUN FACTS:\n\u2611\ufe0f I am an Avid cyclist and runner, and I just started learning to skateboard a half-pipe.\n\u2611\ufe0f Into the Enneagram? - I\u0027m a #3 (The Achiever)\n\nLETS CONNECT:\n\u2611\ufe0f Email: [email protected] (don\u0027t forget that \"R\"....The other guy gets my emails all the time)"
country
The user's country of residence depicted by
a 2-letter country code (ISO 3166-1 alpha-2).
 "US"
country_full_name
The user's country of residence, in English words.
 "United States of America"
city
The city that the user is living at.
 "Seattle"
state
The state that the user is living at.
 "Washington"
experiences
The user's list of historic work experiences.
 See Experience object
education
The user's list of education background.
 See Education object
languages
A list of languages that the user claims to be familiar with,
and has added to his/her profile.
Do note that we do not have the proficiency level as
that data point is not available on a public LinkedIn profile.
 ["English", "Chinese", "Japanese"]
accomplishment_organisations
List of noteworthy organizations that this user is part of.
 See AccomplishmentOrg object
accomplishment_publications
List of noteworthy publications that this user has partook in.
 See Publication object
accomplishment_honors_awards
List of noteworthy honours and awards that this user has won.
 See HonourAward object
accomplishment_patents
List of noteworthy patents won by this user.
 See Patent object
accomplishment_courses
List of noteworthy courses partook by this user.
 See Course object
accomplishment_projects
List of noteworthy projects undertaken by this user.
 See Project object
accomplishment_test_scores
List of noteworthy test scores accomplished by this user.
 See TestScore object
volunteer_work
List of historic volunteer work experiences.
 See VolunteeringExperience object
certifications
List of noteworthy certifications accomplished by this user.
 See Certification object
connections
Total count of LinkedIn connections.
 500
people_also_viewed
A list of other LinkedIn profiles closely related to this user.
 See PeopleAlsoViewed object
recommendations
List of recommendations made by other users about this profile.
 ["Professional and dedicated approach towards clients and collegues."]
activities
A list of LinkedIn status activities.
 See Activity object
similarly_named_profiles
A list of other LinkedIn profiles with similar names.
 See SimilarProfile object
articles
A list of content-based articles posted by this user.
 See Article object
groups
A list of LinkedIn groups that this user is a part of.",
 See PersonGroup object
inferred_salary
A salary range inferred from the user's current job title and company.
 See InferredSalary object
gender
Gender of the user.
 "male"
birth_date
Birth date of the user.
 See Date object
industry
Industry that the user works in.
 "government administration"
extra
A bundle of extra data on this user.
 See PersonExtra object
interests
A list of interests that the user has.
 ["education", "health", "human rights"]
personal_emails
A list of personal emails associated with this user.
 ["[email protected]", "[email protected]", "cde@@outlook.com"]
personal_numbers
A list of personal mobile phone numbers associated with this user.
 ["+6512345678", "+6285123450953", "+6502300340"]

Experience

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

Date

Key Description Example
day
1
month
8
year
2023

Education

Key Description Example
starts_at
{"day": 1, "month": 1, "year": 2013}
ends_at
{"day": 31, "month": 12, "year": 2015}
field_of_study
"Finance + Economics"
degree_name
"Master of Business Administration (MBA)"
school
"University of Colorado Denver"
school_linkedin_profile_url
"https://www.linkedin.com/school/university-of-colorado-denver/"
description
null
logo_url
"https://media.licdn.com/dms/image/C560BAQGVi9eAHgWxFw/company-logo_100_100/0/1673448029676?e=2147483647\u0026v=beta\u0026t=NG6ttckXvnS2DX3abTfVACRY2E9Q1EcryNaJLRbE9OE"
grade
null
activities_and_societies
null

AccomplishmentOrg

Key Description Example
starts_at
{"day": 1, "month": 1, "year": 2012}
ends_at
{"day": 1, "month": 8, "year": 2016}
org_name
"Microsoft"
title
"Software Developer"
description
null

Publication

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

HonourAward

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

Patent

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

Course

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

Project

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

TestScore

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

VolunteeringExperience

Key Description Example
starts_at
{"day": 1, "month": 1, "year": 2012}
ends_at
{"day": 1, "month": 8, "year": 2016}
title
Name of volunteer activity.
 "Surveyor"
cause
"To help the world"
company
The company's display name.
 "Microsoft"
company_linkedin_profile_url
The company's profile URL.
If present, could be used with
Company Profile Endpoint for more info.
 "https://www.linkedin.com/company/microsoft"
description
null
logo_url
URL of the logo of the organisation.
 null

Certification

Key Description Example
starts_at
null
ends_at
null
name
Name of the course or program.
 "SAFe Agile Framework Practitioner - ( Scrum, XP, and Lean Practices in the SAFe Enterprise)"
license_number
null
display_source
null
authority
The organisation body issuing this certificate.
 "Scaled Agile, Inc."
url
null

PeopleAlsoViewed

Key Description Example
link
URL of the profile.
Useable with Person profile endpoint
 "https://www.linkedin.com/in/johndoe"
name
"John Doe"
summary
"Software Engineer at Google"
location
"Singapore"

Activity

Key Description Example
title
"Yesterday I toured a $1.2M property in California that has a large 13K sq ft lot with two homes on it. After 5 minutes of being on-site I\u2026"
link
"https://www.linkedin.com/posts/johnrmarty_financialfreedom-realestate-technology-activity-6940294635743301632-rsLo"
activity_status
"Shared by John Marty"

SimilarProfile

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

Article

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

PersonGroup

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

InferredSalary

Key Description Example
min
35000
max
45000

PersonExtra

Key Description Example
github_profile_id
This profile's Github account.
 "github-username"
facebook_profile_id
This profile's Facebook account.
 "facebook-username"
twitter_profile_id
This profile's twitter account.
 "twitter-username"

Response Headers

Header Key Description Example
X-Proxycurl-Credit-Cost Total cost of credits for this API call 1

Person Profile Picture Endpoint

GET /proxycurl/api/linkedin/person/profile-picture

Cost: 0 credit / successful request.

Get the profile picture of a person.

Profile pictures are served from cached people profiles found within LinkDB. If the profile does not exist within LinkDB, then the API will return a 404 status code.

curl \
    -G \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/linkedin/person/profile-picture' \
    --data-urlencode 'linkedin_person_profile_url=https://www.linkedin.com/in/williamhgates/'

import requests

api_key = 'YOUR_API_KEY'
headers = {'Authorization': 'Bearer ' + api_key}
api_endpoint = 'https://nubela.co/proxycurl/api/linkedin/person/profile-picture'
params = {
    'linkedin_person_profile_url': 'https://www.linkedin.com/in/williamhgates/',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=headers)

Run in Postman

URL Parameters

Parameter Required Description Example
linkedin_person_profile_url yes
LinkedIn Profile URL of the person that you are trying to get the profile picture of.
 https://www.linkedin.com/in/williamhgates/

Response

{
    "tmp_profile_pic_url": "https://media.licdn.com/dms/image/C5616AQH9tkBTUhHfng/profile-displaybackgroundimage-shrink_200_800/0/1614530499015?e=2147483647\u0026v=beta\u0026t=VEoCyedtZulnAVYWT9BXfKHi5OFp8avElNjiz8kjSTU"
}
Key Description Example
tmp_profile_pic_url
Temporary URL to the profile picture (valid for just 30 minutes).
See this blog post for more information.
 "https://s3.us-west-000.backblazeb2.com/proxycurl/"

Response Headers

Header Key Description Example
X-Proxycurl-Credit-Cost Total cost of credits for this API call 0

Person Lookup Endpoint

GET /proxycurl/api/linkedin/profile/resolve

Cost: 2 credits / successful request.

Look up a person with a name and company information.

curl \
    -G \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/linkedin/profile/resolve' \
    --data-urlencode 'company_domain=gatesfoundation.org' \
    --data-urlencode 'first_name=Bill' \
    --data-urlencode 'similarity_checks=include' \
    --data-urlencode 'enrich_profile=enrich' \
    --data-urlencode 'location=Seattle' \
    --data-urlencode 'title=Co-chair' \
    --data-urlencode 'last_name=Gates'

import requests

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

Run in Postman

URL Parameters

Parameter Required Description Example
company_domain yes
Company name or domain
 gatesfoundation.org
first_name yes
First name of the user
 Bill
similarity_checks no
Controls whether the API endpoint performs
similarity comparisons between the input parameters
and the results or simply returns the closest match.
For instance, if you are searching for a person named
"Ben Chad", and the closest result we have is "Chavvy
Plum", our similarity checks will discard the obviously
incorrect result and return null instead of a false
positive.

Include similarity checks to eliminate false positives.
However, be aware that this might yield fewer results
as false positives are discarded. Credits will still be
deducted even if we return null.

You can choose to skip similarity checks, in which
case no credits will be charged if we return null.

This parameter accepts the following values:
* include (default) - Perform similarity checks and
discard false positives. Credits will be deducted even
if we return null .
* skip - Bypass similarity checks. No credits will be
deducted if no results are returned.
 include
enrich_profile no
Enrich the result with a cached profile of the lookup result.

The valid values are:

* skip (default): do not enrich the results with cached profile data
* enrich: enriches the result with cached profile data

Calling this API endpoint with this parameter would add 1 credit.

If you require fresh profile data,
please chain this API call with the People Profile Endpoint with the use_cache=if-recent parameter.
 enrich
location no
The location of this user.

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

Response

{
    "profile": {
        "accomplishment_courses": [],
        "accomplishment_honors_awards": [],
        "accomplishment_organisations": [],
        "accomplishment_patents": [],
        "accomplishment_projects": [
            {
                "description": "gMessenger was built using Ruby on Rails, and the Bootstrap HTML, CSS, and JavaScript framework. It uses a Websocket-Rails integration to post a user\u0027s message content to the page in real time, with no page refresh required. gMessenger also includes custom authentication with three different permissions levels.",
                "ends_at": null,
                "starts_at": {
                    "day": 1,
                    "month": 3,
                    "year": 2015
                },
                "title": "gMessenger",
                "url": "http://gmessenger.herokuapp.com/"
            },
            {
                "description": "A task and project management responsive web app utilizing Ruby on Rails - CSS and HTML",
                "ends_at": null,
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 2015
                },
                "title": "Taskly",
                "url": "https://hidden-coast-7204.herokuapp.com/"
            },
            {
                "description": "Injection molded residential and commercial wall mounts for iPads and iPods. This stylish flush wall mounted solution is meant to be used in conjunction with any Home Automation System.",
                "ends_at": null,
                "starts_at": {
                    "day": 1,
                    "month": 5,
                    "year": 2013
                },
                "title": "Simple Wall Mount",
                "url": "http://www.simplewallmount.com"
            },
            {
                "description": "Overwatch Safety Systems is developing an advanced warning and information distribution system to assist law enforcement and first responders with active shooter situations in public and private venues. The system utilizes modern sonic detection algorithms to sense and announce the position of active threats to people and property. This technology is also being designed as a hi-tech electronic deterrent for high profile or vulnerable venues.",
                "ends_at": null,
                "starts_at": null,
                "title": "Overwatch Safety Systems",
                "url": null
            }
        ],
        "accomplishment_publications": [],
        "accomplishment_test_scores": [],
        "activities": [
            {
                "activity_status": "Shared by John Marty",
                "link": "https://www.linkedin.com/posts/johnrmarty_financialfreedom-realestate-technology-activity-6940294635743301632-rsLo",
                "title": "Yesterday I toured a $1.2M property in California that has a large 13K sq ft lot with two homes on it. After 5 minutes of being on-site I\u2026"
            }
        ],
        "articles": [],
        "background_cover_image_url": "https://media.licdn.com/dms/image/C5616AQH9tkBTUhHfng/profile-displaybackgroundimage-shrink_200_800/0/1614530499015?e=2147483647\u0026v=beta\u0026t=VEoCyedtZulnAVYWT9BXfKHi5OFp8avElNjiz8kjSTU",
        "certifications": [
            {
                "authority": "Scaled Agile, Inc.",
                "display_source": null,
                "ends_at": null,
                "license_number": null,
                "name": "SAFe Agile Framework Practitioner - ( Scrum, XP, and Lean Practices in the SAFe Enterprise)",
                "starts_at": null,
                "url": null
            },
            {
                "authority": "Scrum Alliance",
                "display_source": null,
                "ends_at": null,
                "license_number": null,
                "name": "SCRUM Alliance Certified Product Owner",
                "starts_at": null,
                "url": null
            },
            {
                "authority": "Scaled Agile, Inc.",
                "display_source": null,
                "ends_at": null,
                "license_number": null,
                "name": "Scaled Agile Framework PM/PO",
                "starts_at": null,
                "url": null
            }
        ],
        "city": "Seattle",
        "connections": 500,
        "country": "US",
        "country_full_name": "United States of America",
        "education": [
            {
                "activities_and_societies": null,
                "degree_name": "Master of Business Administration (MBA)",
                "description": null,
                "ends_at": {
                    "day": 31,
                    "month": 12,
                    "year": 2015
                },
                "field_of_study": "Finance + Economics",
                "grade": null,
                "logo_url": "https://media.licdn.com/dms/image/C560BAQGVi9eAHgWxFw/company-logo_100_100/0/1673448029676?e=2147483647\u0026v=beta\u0026t=NG6ttckXvnS2DX3abTfVACRY2E9Q1EcryNaJLRbE9OE",
                "school": "University of Colorado Denver",
                "school_linkedin_profile_url": "https://www.linkedin.com/school/university-of-colorado-denver/",
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 2013
                }
            },
            {
                "activities_and_societies": null,
                "degree_name": null,
                "description": "rails, ruby, rspec, capybara, bootstrap, css, html, api integration, Jquery, Javascript",
                "ends_at": {
                    "day": 31,
                    "month": 12,
                    "year": 2015
                },
                "field_of_study": "School of Software Development",
                "grade": null,
                "logo_url": "https://media.licdn.com/dms/image/C560BAQFKNxOZ4X0g8Q/company-logo_100_100/0/1670610916338?e=2147483647\u0026v=beta\u0026t=t7ImfhmsuIJ7HJGHEbPJ2suxdslKhzp9v-5h9_G4sWE",
                "school": "Galvanize Inc",
                "school_linkedin_profile_url": "https://www.linkedin.com/school/galvanize-it/",
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 2015
                }
            },
            {
                "activities_and_societies": null,
                "degree_name": "BA",
                "description": null,
                "ends_at": {
                    "day": 31,
                    "month": 12,
                    "year": 2005
                },
                "field_of_study": "Business",
                "grade": null,
                "logo_url": "https://media.licdn.com/dms/image/C4D0BAQGs5hZ3ROf-iw/company-logo_100_100/0/1519856111543?e=2147483647\u0026v=beta\u0026t=62k4mEoRdeQf4C6AF12Z05_t6i1VgNk50jr7RHkEsf8",
                "school": "Fort Lewis College",
                "school_linkedin_profile_url": "https://www.linkedin.com/school/fort-lewis-college/",
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 1999
                }
            },
            {
                "activities_and_societies": null,
                "degree_name": "Japanese Language and Literature",
                "description": null,
                "ends_at": {
                    "day": 31,
                    "month": 12,
                    "year": 2002
                },
                "field_of_study": null,
                "grade": null,
                "logo_url": null,
                "school": "Yamasa Institute Okazaki Japan",
                "school_linkedin_profile_url": null,
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 2002
                }
            },
            {
                "activities_and_societies": null,
                "degree_name": null,
                "description": null,
                "ends_at": {
                    "day": 31,
                    "month": 12,
                    "year": 2000
                },
                "field_of_study": "Spanish Language and Literature",
                "grade": null,
                "logo_url": null,
                "school": "Inter American University of Puerto Rico",
                "school_linkedin_profile_url": "https://www.linkedin.com/school/inter-american-university-of-puerto-rico/",
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 2000
                }
            },
            {
                "activities_and_societies": null,
                "degree_name": "High School",
                "description": null,
                "ends_at": {
                    "day": 31,
                    "month": 12,
                    "year": 1999
                },
                "field_of_study": null,
                "grade": null,
                "logo_url": null,
                "school": "Western Reserve Academy",
                "school_linkedin_profile_url": null,
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 1996
                }
            }
        ],
        "experiences": [
            {
                "company": "Freedom Fund Real Estate",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/freedomfund",
                "description": "Our mission is to provide everyday people seeking financial freedom long before the age of 65 with the ability to invest in high yield, short-term real estate investments that were only accessible in the past for a select few wealthy individuals. Each of our single family rehab projects require a minimum investment contribution of only $10K, we have simple terms, no multi-year hold periods, and no fees. With our unique model investors can log into our easy to use website, select the projects that they want to invest in, and get realtime updates on the status of their investments.\n\nWebsite: https://www.freedomfundinvestments.com/home",
                "ends_at": null,
                "location": null,
                "logo_url": "https://media.licdn.com/dms/image/C560BAQEYxazZM_hXgQ/company-logo_100_100/0/1634934418976?e=2147483647\u0026v=beta\u0026t=wI0YdMmxIctkzvnKxRfuAbT8h5eok_DlUqEph68J37s",
                "starts_at": {
                    "day": 1,
                    "month": 8,
                    "year": 2021
                },
                "title": "Co-Founder"
            },
            {
                "company": "Mindset Reset Podcast",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/mindset-reset-podcast",
                "description": "We dive into the mindsets of the world\u2019s foremost thought leaders and turn them into actionable insights so that others can discover greater happiness, success, and fulfillment.\n\nhttps://podcasts.apple.com/us/podcast/mindset-reset/id1553212607",
                "ends_at": null,
                "location": "Denver, Colorado, United States",
                "logo_url": "https://media.licdn.com/dms/image/C560BAQF9QJVQm3SOvA/company-logo_100_100/0/1614527476576?e=2147483647\u0026v=beta\u0026t=m3tx83nMN-E3XQFoJG0Wmch8U4qKnJ9i--5NSAfffC0",
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 2021
                },
                "title": "Founder"
            },
            {
                "company": "Product School",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/product-school",
                "description": "Product School is a global leader in Product Management training with a community of over one million product professionals. As a featured speaker, I help inspire the next generation of Product Managers to create innovative products and apply best practices in their work.",
                "ends_at": {
                    "day": 31,
                    "month": 12,
                    "year": 2020
                },
                "location": "Seattle, Washington, United States",
                "logo_url": "https://media.licdn.com/dms/image/C4E0BAQEKULb2pMnazw/company-logo_100_100/0/1657091674586?e=2147483647\u0026v=beta\u0026t=vgcwRvTFf1v-AxyFXfFuEm07g8Nlzsha12E6-aBj6lk",
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 2020
                },
                "title": "Featured Speaker"
            },
            {
                "company": "Project 1B",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/project-1b",
                "description": "The mission of Project 1B is to help 1 Billion people around the world maximize their sense of meaning so that they can lead more fulfilling lives. We do this through exposing the truth about success and happiness through the Mindset Reset Podcast, corporate training, youth education programs, group coaching, and investments in tech startups aligned with our mission.\n\nThe word success is widely understood as the attainment of financial gain, but somewhere along the lines we began believing that money = happiness, self worth, and meaning even though money has nothing to do with these things. Because of this twisted equation, young adults often make career decisions that solely maximize earning potential. And Ironically, if they manage to achieve society\u2019s definition of success, It often leaves many with a sense of meaninglessness.\n\nIf you want to live a meaningful life chase the word meaning as opposed to the word success - this simple shift in mindset will lead to a more authentic set of questions about the direction you should take your life.",
                "ends_at": null,
                "location": "Denver, Colorado, United States",
                "logo_url": "https://media.licdn.com/dms/image/C560BAQFG_MrwBC_iZg/company-logo_100_100/0/1594610187483?e=2147483647\u0026v=beta\u0026t=7NNWG1ZclbNsUW0k0PuD-v5xTmfpIcthOmHCDyMwWMk",
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 2020
                },
                "title": "Founder"
            },
            {
                "company": "YouTube",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/youtube",
                "description": "Mission: to help others land their dream jobs at a top tech companies that aligns with their passions.",
                "ends_at": null,
                "location": "Greater Seattle Area",
                "logo_url": "https://media.licdn.com/dms/image/C4D0BAQEfoRsyU4yUzg/company-logo_100_100/0/1631053379295?e=2147483647\u0026v=beta\u0026t=CmnUj5LeO5Yi-nA9xLgEYBPU5eZdLrPBG2qXmPhhoe4",
                "starts_at": {
                    "day": 1,
                    "month": 2,
                    "year": 2019
                },
                "title": "YouTube Content Creator - \"Tech Careers for Non-Engineers\""
            },
            {
                "company": "YouTube",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/youtube",
                "description": null,
                "ends_at": null,
                "location": "Seattle, Washington",
                "logo_url": "https://media.licdn.com/dms/image/C4D0BAQEfoRsyU4yUzg/company-logo_100_100/0/1631053379295?e=2147483647\u0026v=beta\u0026t=CmnUj5LeO5Yi-nA9xLgEYBPU5eZdLrPBG2qXmPhhoe4",
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 2017
                },
                "title": "Youtube Content Creator - \"John Marty\""
            },
            {
                "company": "Amazon",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/amazon",
                "description": "I had a mix of roles at Amazon from Sr. PM to Sr. Manager of Product\nTwo years were spent on Marketplace Product Quality and 2 years in New Business Innovation",
                "ends_at": {
                    "day": 31,
                    "month": 3,
                    "year": 2021
                },
                "location": "Greater Seattle Area",
                "logo_url": "https://media.licdn.com/dms/image/C560BAQHTvZwCx4p2Qg/company-logo_100_100/0/1612205615891?e=2147483647\u0026v=beta\u0026t=PG9v_TmuSDxc9nAjnwxAFTWfFwhri5iJcJ4bcODhtPA",
                "starts_at": {
                    "day": 1,
                    "month": 3,
                    "year": 2017
                },
                "title": "Sr. Manager of Product"
            },
            {
                "company": "American Express",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/american-express",
                "description": null,
                "ends_at": {
                    "day": 31,
                    "month": 3,
                    "year": 2017
                },
                "location": "Phoenix, Arizona Area",
                "logo_url": "https://media.licdn.com/dms/image/C4D0BAQGRhsociEn4gQ/company-logo_100_100/0/1523269243842?e=2147483647\u0026v=beta\u0026t=SHRbiG3uqsCTfE1Gyd77tgJWtHAm4cYp-c6uILKTVNs",
                "starts_at": {
                    "day": 1,
                    "month": 7,
                    "year": 2015
                },
                "title": "Senior Global Product Manager"
            },
            {
                "company": "Mile High Automation, Inc.",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/mile-high-automation-inc-",
                "description": "Mile High Automation is a Smart Home Technology (Internet of Things) software and hardware development company. Our mission is to flawlessly develop and deliver impeccable software, hardware and system design for the high-end consumer market nationally and internationally. \n\n\u2022  Performed a short term change management engagement to lead a 12 member cross functional team through a major strategy and vision transition\n\u2022  Developed an international supply chain that increased profit margin by 30% on core products\n\u2022  Conceptualized, implemented, and rolled out a CRM that led to a 15% higher month over month close rate; trained sales team on newly created key performance indicators to maximize growth\n\u2022  Developed, implemented and oversaw a training process that scaled to 180+ national subcontractors\n\u2022  Translated user stories into detailed product requirements documents that the software development team used to build new features and functionality \n\u2022  Developed benchmarks for customer service, sales, and traffic conversion to maximize profit",
                "ends_at": {
                    "day": 31,
                    "month": 7,
                    "year": 2014
                },
                "location": "Denver Colorado",
                "logo_url": "https://media.licdn.com/dms/image/C4E0BAQHofg3toK4P7A/company-logo_100_100/0/1519903210468?e=2147483647\u0026v=beta\u0026t=vasirOnrmfFkQru9S8JBNtci00COt_s9x2AOexxqd-8",
                "starts_at": {
                    "day": 1,
                    "month": 3,
                    "year": 2014
                },
                "title": "Sr. Product Manager"
            },
            {
                "company": "EOS Controls",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/eos-controls",
                "description": "A Smart Home Technology (Internet of Things) software and hardware development company specializing in the mid to high-end condominium market in the United States and South America. \nEOS Controls supports the advancement of affordable and easy to user smart home technology through a network of non-traditional sales channels of architects, designers, and contractors. \n\n\u2022  Coordinated engineering, design, and marketing strategy for the launch of 6 iOS apps\n\u2022  Led a 5 member product team of engineers; conducted daily stand-ups and weekly design review meetings\n\u2022  Managed and prioritized product backlog for development Sprints as well as tested products before release\n\u2022  Effectively placed products through non-traditional distribution channels by identifying and developing relationships with over 100 national and international builders, architects, and designers",
                "ends_at": {
                    "day": 31,
                    "month": 5,
                    "year": 2014
                },
                "location": "Miami, Florida",
                "logo_url": "https://media.licdn.com/dms/image/C560BAQFV1hvbuwyU-A/company-logo_100_100/0/1519867781218?e=2147483647\u0026v=beta\u0026t=s5UGQj-N-5VatokXj3YN6IxOPmKpUZeetC5OZH-B-xU",
                "starts_at": {
                    "day": 1,
                    "month": 2,
                    "year": 2012
                },
                "title": "Founder/ Chief Operating Officer"
            },
            {
                "company": "Axxis Audio",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/axxis-audio",
                "description": "Specializing in Smart Home Technology - Home Automation, Internet of Things\n\n\u2022  Raised $10,000 in investment to develop a home theater and home automation sales and installation business that grew to multi-million dollar sales (sold the company in 2011)\n\u2022  Developed mission-centric training, responsibility, and accountability framework \n\u2022  10 Direct Reports\n\u2022  Responsible for resource planning, scheduling, and project management \n\u2022  Filled the role of HR and developed a team building program for 10 direct reports, that included formal training, personal and professional peer support, mentoring and professional development; resulting in 20% higher retention rate and improved trust and communication\n\u2022  Deployed an ERP Solution in 2007 that unified 5 departments and provided a central reporting and accountability framework for a 23% employees productivity gain\n\u2022  Handled acquisition of 2nd largest competitor Cobalt Automation",
                "ends_at": {
                    "day": 31,
                    "month": 1,
                    "year": 2012
                },
                "location": "Durango Colorado",
                "logo_url": "https://media.licdn.com/dms/image/C560BAQHI-DLifzJs9Q/company-logo_100_100/0/1519868629336?e=2147483647\u0026v=beta\u0026t=l1Sk5NQO2Mtpo7HpppRkMhogjVXCwx5yxIxhcwUpNuc",
                "starts_at": {
                    "day": 1,
                    "month": 11,
                    "year": 2002
                },
                "title": "President/Founder"
            }
        ],
        "first_name": "John",
        "follower_count": null,
        "full_name": "John Marty",
        "groups": [],
        "headline": "Financial Freedom through Real Estate - LinkedIn Top Voice",
        "languages": [
            "English",
            "Spanish",
            "Japanese"
        ],
        "last_name": "Marty",
        "occupation": "Co-Founder at Freedom Fund Real Estate",
        "people_also_viewed": [],
        "profile_pic_url": "https://media.licdn.com/dms/image/C5603AQHaJSx0CBAUIA/profile-displayphoto-shrink_800_800/0/1558325759208?e=2147483647\u0026v=beta\u0026t=BluXpPg88xFnU2wMGLjuCUykSk_wKNdh8x3PI9wm6MI",
        "public_identifier": "johnrmarty",
        "recommendations": [
            "Rebecca Canfield\n\n      \n          \n          \n\n\n\n              \n                \n        \n              \n  \n\n      \n          John Marty is a genius at his craft. He is skilled in the art of making people feel empowered to seek out roles that they are qualified for, ask for salaries that they deserve, and creates a kind of pay it forward lifestyle. John helps you to get to places that you only thought were possible for other people. Anyone that is fortunate enough to learn from John should consider themselves extremely lucky. I know I do. ",
            "Zoe Sanoff\n\n      \n          \n          \n\n\n\n              \n                \n        \n              \n  \n\n      \n          John is so focused on helping guide you through an interview process not just for Amazon but on interviewing in general.  I\u0027ve generally done well at interviewing, my skills are top notch now.  John is so focused on on his clients and really goes above and beyond.  John is genuine, knowledgeable, well spoken and non-judgemental.  He is so encouraging, so positive and really easy to talk to.  Thank you John!"
        ],
        "similarly_named_profiles": [
            {
                "link": "https://www.linkedin.com/in/john-martinez-90384a229",
                "location": "San Antonio, TX",
                "name": "John Martinez",
                "summary": "Owner of Fight or Flight Medical Consultants, LLC  , Owner Marty\u2019s Hardwood Works"
            },
            {
                "link": "https://www.linkedin.com/in/senatormarty",
                "location": "St Paul, MN",
                "name": "John Marty",
                "summary": null
            },
            {
                "link": "https://www.linkedin.com/in/johnmarty",
                "location": "Orlando, FL",
                "name": "John Marty",
                "summary": "Lead Software Engineer, Commerce at Disney Parks  \u0026 Resorts Digital"
            },
            {
                "link": "https://www.linkedin.com/in/john-marty-ba56b478",
                "location": "Sarver, PA",
                "name": "John Marty",
                "summary": "Podiatrist at Ankle and Foot care inc"
            }
        ],
        "state": "Washington",
        "summary": "Most people go through life lost, disengaged, and unhappy at work and in their lives - I\u0027m on a mission to solve that.\n\nI spent 10 years as the founder of Axxis Audio, an electronics company that grew to multi-million dollar sales, which I sold in 2012. At that time, I funneled my earnings into the creation of an Internet of Things company, but numerous factors lead to its demise after 2 hard fought years. \n\nAt 31, I was penny-less, had a baby on the way, and had zero job prospects (despite applying to 150 companies). My desperate situation led me to take a job at Best Buy for $12 an hour while reinventing myself through the completion of an MBA at the University of Colorado, and a 6-month software development boot camp. \n\nAfter graduation, I landed at American Express as a Senior Product Manager and then got poached by Amazon in 2017 (because of my LinkedIn profile). My journey has led to a deep sense of perspective, humility, and purpose that I draw on to help others find clarity, meaning, and happiness in their careers and lives. \n\nCheck out my website for details on my Mindset Reset Podcast, Public Speaking, Consulting, or my free 40 page LinkedIn guide\n\nhttp://www.johnraphaelmarty.com/\n\nFAQ\u0027s\n\nQ: Can you speak at my Company, University, event or podcast?\nA: I\u0027d love to! I\u0027ve shared my message on the future of employment, breaking into big tech, and my personal story of reinventing myself and discovering my sense of purpose (and how you can too!).\n\n\u2611\ufe0f  YouTube Channel #1 (John Marty) : http://www.youtube.com/c/JohnMarty-uncommon\n\u2611\ufe0f  YouTube Channel #2 (Tech Careers for non-engineers: https://www.youtube.com/channel/UC900gMMPLwRGGXSTW1gdZHA\n\nFUN FACTS:\n\u2611\ufe0f I am an Avid cyclist and runner, and I just started learning to skateboard a half-pipe.\n\u2611\ufe0f Into the Enneagram? - I\u0027m a #3 (The Achiever)\n\nLETS CONNECT:\n\u2611\ufe0f Email: [email protected] (don\u0027t forget that \"R\"....The other guy gets my emails all the time)",
        "volunteer_work": []
    },
    "url": "https://www.linkedin.com/in/senatormarty"
}
Key Description Example
url
The LinkedIn profile URL
 "https://www.linkedin.com/in/senatormarty"
name_similarity_score
A measure of how similar the input name is to the name in the returned profile. Values can range from 0 to 1 , with 0 indicating no similarity and 1 implying high similarity. In cases where a current profile for comparison is not available in our dataset, the result may be null.
 0.5
company_similarity_score
A measure of how similar the input company name/domain is to the name/domain of past or present companies in the returned profile. The score ranges from 0 to 1 , with 0 signifying no similarity and 1 denoting high similarity. If a relevant profile is unavailable in our dataset for comparison, a null score may be returned.
 0.5
title_similarity_score
A measure of how similar the input title is to the returned profile's past or present titles. Scores vary from 0 to 1 , where 0 means no similarity and 1 indicates high similarity. If a relevant profile for comparison isn't available in our dataset, a null result may occur.
 0.5
location_similarity_score
A measure of how similar the input location is to the returned profile's current location. The range is from 0 to 1 , with 0 representing no similarity and 1 signifying high similarity. If there isn't a relevant profile in our dataset for comparison, the score might be null.
 0.5
profile
A PersonEndpointResponse object
 See PersonEndpointResponse object

PersonEndpointResponse

Key Description Example
public_identifier
The vanity identifier of the public LinkedIn profile.
The vanity identifier comes after the /in/ part of the LinkedIn Profile URL
in the following format: https://www.linkedin.com/in/<public_identifier>
 "johnrmarty"
profile_pic_url
A temporary link to the user's profile picture that is valid for 30 minutes.
The temporal nature of the link is by design to prevent having Proxycurl be the mirror for the images.
The developer is expected to handle these images by downloading the image and re-hosting the image.
See this post for context.
Some profile pictures might be of the standard LinkedIn's profile picture placeholder. It is so because. See this post for context.
 "https://media.licdn.com/dms/image/C5603AQHaJSx0CBAUIA/profile-displayphoto-shrink_800_800/0/1558325759208?e=2147483647\u0026v=beta\u0026t=BluXpPg88xFnU2wMGLjuCUykSk_wKNdh8x3PI9wm6MI"
background_cover_image_url
A temporary link to the user's background cover picture
that is valid for 30 minutes.
The temporal nature of the link is by design to prevent
having Proxycurl be the mirror for the images.
The developer is expected to handle these images
by downloading the image and re-hosting the image.
See this post for context.
 "https://media.licdn.com/dms/image/C5616AQH9tkBTUhHfng/profile-displaybackgroundimage-shrink_200_800/0/1614530499015?e=2147483647\u0026v=beta\u0026t=VEoCyedtZulnAVYWT9BXfKHi5OFp8avElNjiz8kjSTU"
first_name
First name of the user.
 "John"
last_name
Last name of the user.
 "Marty"
full_name
Full name of the user (first_name + last_name)
 "John Marty"
follower_count
Follower count for this profile
 null
occupation
The title and company name of the user's current employment.
 "Co-Founder at Freedom Fund Real Estate"
headline
The tagline written by the user for his profile.
 "Financial Freedom through Real Estate - LinkedIn Top Voice"
summary
A blurb (longer than the tagline) written by the user for his profile.
 "Most people go through life lost, disengaged, and unhappy at work and in their lives - I\u0027m on a mission to solve that.\n\nI spent 10 years as the founder of Axxis Audio, an electronics company that grew to multi-million dollar sales, which I sold in 2012. At that time, I funneled my earnings into the creation of an Internet of Things company, but numerous factors lead to its demise after 2 hard fought years. \n\nAt 31, I was penny-less, had a baby on the way, and had zero job prospects (despite applying to 150 companies). My desperate situation led me to take a job at Best Buy for $12 an hour while reinventing myself through the completion of an MBA at the University of Colorado, and a 6-month software development boot camp. \n\nAfter graduation, I landed at American Express as a Senior Product Manager and then got poached by Amazon in 2017 (because of my LinkedIn profile). My journey has led to a deep sense of perspective, humility, and purpose that I draw on to help others find clarity, meaning, and happiness in their careers and lives. \n\nCheck out my website for details on my Mindset Reset Podcast, Public Speaking, Consulting, or my free 40 page LinkedIn guide\n\nhttp://www.johnraphaelmarty.com/\n\nFAQ\u0027s\n\nQ: Can you speak at my Company, University, event or podcast?\nA: I\u0027d love to! I\u0027ve shared my message on the future of employment, breaking into big tech, and my personal story of reinventing myself and discovering my sense of purpose (and how you can too!).\n\n\u2611\ufe0f YouTube Channel #1 (John Marty) : http://www.youtube.com/c/JohnMarty-uncommon\n\u2611\ufe0f YouTube Channel #2 (Tech Careers for non-engineers: https://www.youtube.com/channel/UC900gMMPLwRGGXSTW1gdZHA\n\nFUN FACTS:\n\u2611\ufe0f I am an Avid cyclist and runner, and I just started learning to skateboard a half-pipe.\n\u2611\ufe0f Into the Enneagram? - I\u0027m a #3 (The Achiever)\n\nLETS CONNECT:\n\u2611\ufe0f Email: [email protected] (don\u0027t forget that \"R\"....The other guy gets my emails all the time)"
country
The user's country of residence depicted by
a 2-letter country code (ISO 3166-1 alpha-2).
 "US"
country_full_name
The user's country of residence, in English words.
 "United States of America"
city
The city that the user is living at.
 "Seattle"
state
The state that the user is living at.
 "Washington"
experiences
The user's list of historic work experiences.
 See Experience object
education
The user's list of education background.
 See Education object
languages
A list of languages that the user claims to be familiar with,
and has added to his/her profile.
Do note that we do not have the proficiency level as
that data point is not available on a public LinkedIn profile.
 ["English", "Chinese", "Japanese"]
accomplishment_organisations
List of noteworthy organizations that this user is part of.
 See AccomplishmentOrg object
accomplishment_publications
List of noteworthy publications that this user has partook in.
 See Publication object
accomplishment_honors_awards
List of noteworthy honours and awards that this user has won.
 See HonourAward object
accomplishment_patents
List of noteworthy patents won by this user.
 See Patent object
accomplishment_courses
List of noteworthy courses partook by this user.
 See Course object
accomplishment_projects
List of noteworthy projects undertaken by this user.
 See Project object
accomplishment_test_scores
List of noteworthy test scores accomplished by this user.
 See TestScore object
volunteer_work
List of historic volunteer work experiences.
 See VolunteeringExperience object
certifications
List of noteworthy certifications accomplished by this user.
 See Certification object
connections
Total count of LinkedIn connections.
 500
people_also_viewed
A list of other LinkedIn profiles closely related to this user.
 See PeopleAlsoViewed object
recommendations
List of recommendations made by other users about this profile.
 ["Professional and dedicated approach towards clients and collegues."]
activities
A list of LinkedIn status activities.
 See Activity object
similarly_named_profiles
A list of other LinkedIn profiles with similar names.
 See SimilarProfile object
articles
A list of content-based articles posted by this user.
 See Article object
groups
A list of LinkedIn groups that this user is a part of.",
 See PersonGroup object
inferred_salary
A salary range inferred from the user's current job title and company.
 See InferredSalary object
gender
Gender of the user.
 "male"
birth_date
Birth date of the user.
 See Date object
industry
Industry that the user works in.
 "government administration"
extra
A bundle of extra data on this user.
 See PersonExtra object
interests
A list of interests that the user has.
 ["education", "health", "human rights"]
personal_emails
A list of personal emails associated with this user.
 ["[email protected]", "[email protected]", "cde@@outlook.com"]
personal_numbers
A list of personal mobile phone numbers associated with this user.
 ["+6512345678", "+6285123450953", "+6502300340"]

Experience

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

Date

Key Description Example
day
1
month
8
year
2023

Education

Key Description Example
starts_at
{"day": 1, "month": 1, "year": 2013}
ends_at
{"day": 31, "month": 12, "year": 2015}
field_of_study
"Finance + Economics"
degree_name
"Master of Business Administration (MBA)"
school
"University of Colorado Denver"
school_linkedin_profile_url
"https://www.linkedin.com/school/university-of-colorado-denver/"
description
null
logo_url
"https://media.licdn.com/dms/image/C560BAQGVi9eAHgWxFw/company-logo_100_100/0/1673448029676?e=2147483647\u0026v=beta\u0026t=NG6ttckXvnS2DX3abTfVACRY2E9Q1EcryNaJLRbE9OE"
grade
null
activities_and_societies
null

AccomplishmentOrg

Key Description Example
starts_at
{"day": 1, "month": 1, "year": 2012}
ends_at
{"day": 1, "month": 8, "year": 2016}
org_name
"Microsoft"
title
"Software Developer"
description
null

Publication

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

HonourAward

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

Patent

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

Course

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

Project

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

TestScore

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

VolunteeringExperience

Key Description Example
starts_at
{"day": 1, "month": 1, "year": 2012}
ends_at
{"day": 1, "month": 8, "year": 2016}
title
Name of volunteer activity.
 "Surveyor"
cause
"To help the world"
company
The company's display name.
 "Microsoft"
company_linkedin_profile_url
The company's profile URL.
If present, could be used with
Company Profile Endpoint for more info.
 "https://www.linkedin.com/company/microsoft"
description
null
logo_url
URL of the logo of the organisation.
 null

Certification

Key Description Example
starts_at
null
ends_at
null
name
Name of the course or program.
 "SAFe Agile Framework Practitioner - ( Scrum, XP, and Lean Practices in the SAFe Enterprise)"
license_number
null
display_source
null
authority
The organisation body issuing this certificate.
 "Scaled Agile, Inc."
url
null

PeopleAlsoViewed

Key Description Example
link
URL of the profile.
Useable with Person profile endpoint
 "https://www.linkedin.com/in/johndoe"
name
"John Doe"
summary
"Software Engineer at Google"
location
"Singapore"

Activity

Key Description Example
title
"Yesterday I toured a $1.2M property in California that has a large 13K sq ft lot with two homes on it. After 5 minutes of being on-site I\u2026"
link
"https://www.linkedin.com/posts/johnrmarty_financialfreedom-realestate-technology-activity-6940294635743301632-rsLo"
activity_status
"Shared by John Marty"

SimilarProfile

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

Article

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

PersonGroup

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

InferredSalary

Key Description Example
min
35000
max
45000

PersonExtra

Key Description Example
github_profile_id
This profile's Github account.
 "github-username"
facebook_profile_id
This profile's Facebook account.
 "facebook-username"
twitter_profile_id
This profile's twitter account.
 "twitter-username"

Response Headers

Header Key Description Example
X-Proxycurl-Credit-Cost Total cost of credits for this API call 2

Remarks

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

Role Lookup Endpoint

GET /proxycurl/api/find/company/role/

Cost: 3 credits / successful request.

Finds the closest (person) profile with a given role in a Company. For example, you can use this endpoint to find the "CTO" of "Apple". This API endpoint returns only one result that is the closest match.

There is also the Employee Search Endpoint which is powered by LinkDB if you require:

curl \
    -G \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/find/company/role/' \
    --data-urlencode 'role=ceo' \
    --data-urlencode 'company_name=nubela' \
    --data-urlencode 'enrich_profile=enrich'

import requests

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

Run in Postman

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
enrich_profile no
Enrich the result with a cached profile of the lookup result.

The valid values are:

* skip (default): do not enrich the results with cached profile data
* enrich: enriches the result with cached profile data

Calling this API endpoint with this parameter would add 1 credit.

If you require fresh profile data,
please chain this API call with the Person Profile Endpoint with the use_cache=if-recent parameter.
 enrich

Response

{
    "linkedin_profile_url": "https://www.linkedin.com/in/senatormarty",
    "profile": {
        "accomplishment_courses": [],
        "accomplishment_honors_awards": [],
        "accomplishment_organisations": [],
        "accomplishment_patents": [],
        "accomplishment_projects": [
            {
                "description": "gMessenger was built using Ruby on Rails, and the Bootstrap HTML, CSS, and JavaScript framework. It uses a Websocket-Rails integration to post a user\u0027s message content to the page in real time, with no page refresh required. gMessenger also includes custom authentication with three different permissions levels.",
                "ends_at": null,
                "starts_at": {
                    "day": 1,
                    "month": 3,
                    "year": 2015
                },
                "title": "gMessenger",
                "url": "http://gmessenger.herokuapp.com/"
            },
            {
                "description": "A task and project management responsive web app utilizing Ruby on Rails - CSS and HTML",
                "ends_at": null,
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 2015
                },
                "title": "Taskly",
                "url": "https://hidden-coast-7204.herokuapp.com/"
            },
            {
                "description": "Injection molded residential and commercial wall mounts for iPads and iPods. This stylish flush wall mounted solution is meant to be used in conjunction with any Home Automation System.",
                "ends_at": null,
                "starts_at": {
                    "day": 1,
                    "month": 5,
                    "year": 2013
                },
                "title": "Simple Wall Mount",
                "url": "http://www.simplewallmount.com"
            },
            {
                "description": "Overwatch Safety Systems is developing an advanced warning and information distribution system to assist law enforcement and first responders with active shooter situations in public and private venues. The system utilizes modern sonic detection algorithms to sense and announce the position of active threats to people and property. This technology is also being designed as a hi-tech electronic deterrent for high profile or vulnerable venues.",
                "ends_at": null,
                "starts_at": null,
                "title": "Overwatch Safety Systems",
                "url": null
            }
        ],
        "accomplishment_publications": [],
        "accomplishment_test_scores": [],
        "activities": [
            {
                "activity_status": "Shared by John Marty",
                "link": "https://www.linkedin.com/posts/johnrmarty_financialfreedom-realestate-technology-activity-6940294635743301632-rsLo",
                "title": "Yesterday I toured a $1.2M property in California that has a large 13K sq ft lot with two homes on it. After 5 minutes of being on-site I\u2026"
            }
        ],
        "articles": [],
        "background_cover_image_url": "https://media.licdn.com/dms/image/C5616AQH9tkBTUhHfng/profile-displaybackgroundimage-shrink_200_800/0/1614530499015?e=2147483647\u0026v=beta\u0026t=VEoCyedtZulnAVYWT9BXfKHi5OFp8avElNjiz8kjSTU",
        "certifications": [
            {
                "authority": "Scaled Agile, Inc.",
                "display_source": null,
                "ends_at": null,
                "license_number": null,
                "name": "SAFe Agile Framework Practitioner - ( Scrum, XP, and Lean Practices in the SAFe Enterprise)",
                "starts_at": null,
                "url": null
            },
            {
                "authority": "Scrum Alliance",
                "display_source": null,
                "ends_at": null,
                "license_number": null,
                "name": "SCRUM Alliance Certified Product Owner",
                "starts_at": null,
                "url": null
            },
            {
                "authority": "Scaled Agile, Inc.",
                "display_source": null,
                "ends_at": null,
                "license_number": null,
                "name": "Scaled Agile Framework PM/PO",
                "starts_at": null,
                "url": null
            }
        ],
        "city": "Seattle",
        "connections": 500,
        "country": "US",
        "country_full_name": "United States of America",
        "education": [
            {
                "activities_and_societies": null,
                "degree_name": "Master of Business Administration (MBA)",
                "description": null,
                "ends_at": {
                    "day": 31,
                    "month": 12,
                    "year": 2015
                },
                "field_of_study": "Finance + Economics",
                "grade": null,
                "logo_url": "https://media.licdn.com/dms/image/C560BAQGVi9eAHgWxFw/company-logo_100_100/0/1673448029676?e=2147483647\u0026v=beta\u0026t=NG6ttckXvnS2DX3abTfVACRY2E9Q1EcryNaJLRbE9OE",
                "school": "University of Colorado Denver",
                "school_linkedin_profile_url": "https://www.linkedin.com/school/university-of-colorado-denver/",
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 2013
                }
            },
            {
                "activities_and_societies": null,
                "degree_name": null,
                "description": "rails, ruby, rspec, capybara, bootstrap, css, html, api integration, Jquery, Javascript",
                "ends_at": {
                    "day": 31,
                    "month": 12,
                    "year": 2015
                },
                "field_of_study": "School of Software Development",
                "grade": null,
                "logo_url": "https://media.licdn.com/dms/image/C560BAQFKNxOZ4X0g8Q/company-logo_100_100/0/1670610916338?e=2147483647\u0026v=beta\u0026t=t7ImfhmsuIJ7HJGHEbPJ2suxdslKhzp9v-5h9_G4sWE",
                "school": "Galvanize Inc",
                "school_linkedin_profile_url": "https://www.linkedin.com/school/galvanize-it/",
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 2015
                }
            },
            {
                "activities_and_societies": null,
                "degree_name": "BA",
                "description": null,
                "ends_at": {
                    "day": 31,
                    "month": 12,
                    "year": 2005
                },
                "field_of_study": "Business",
                "grade": null,
                "logo_url": "https://media.licdn.com/dms/image/C4D0BAQGs5hZ3ROf-iw/company-logo_100_100/0/1519856111543?e=2147483647\u0026v=beta\u0026t=62k4mEoRdeQf4C6AF12Z05_t6i1VgNk50jr7RHkEsf8",
                "school": "Fort Lewis College",
                "school_linkedin_profile_url": "https://www.linkedin.com/school/fort-lewis-college/",
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 1999
                }
            },
            {
                "activities_and_societies": null,
                "degree_name": "Japanese Language and Literature",
                "description": null,
                "ends_at": {
                    "day": 31,
                    "month": 12,
                    "year": 2002
                },
                "field_of_study": null,
                "grade": null,
                "logo_url": null,
                "school": "Yamasa Institute Okazaki Japan",
                "school_linkedin_profile_url": null,
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 2002
                }
            },
            {
                "activities_and_societies": null,
                "degree_name": null,
                "description": null,
                "ends_at": {
                    "day": 31,
                    "month": 12,
                    "year": 2000
                },
                "field_of_study": "Spanish Language and Literature",
                "grade": null,
                "logo_url": null,
                "school": "Inter American University of Puerto Rico",
                "school_linkedin_profile_url": "https://www.linkedin.com/school/inter-american-university-of-puerto-rico/",
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 2000
                }
            },
            {
                "activities_and_societies": null,
                "degree_name": "High School",
                "description": null,
                "ends_at": {
                    "day": 31,
                    "month": 12,
                    "year": 1999
                },
                "field_of_study": null,
                "grade": null,
                "logo_url": null,
                "school": "Western Reserve Academy",
                "school_linkedin_profile_url": null,
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 1996
                }
            }
        ],
        "experiences": [
            {
                "company": "Freedom Fund Real Estate",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/freedomfund",
                "description": "Our mission is to provide everyday people seeking financial freedom long before the age of 65 with the ability to invest in high yield, short-term real estate investments that were only accessible in the past for a select few wealthy individuals. Each of our single family rehab projects require a minimum investment contribution of only $10K, we have simple terms, no multi-year hold periods, and no fees. With our unique model investors can log into our easy to use website, select the projects that they want to invest in, and get realtime updates on the status of their investments.\n\nWebsite: https://www.freedomfundinvestments.com/home",
                "ends_at": null,
                "location": null,
                "logo_url": "https://media.licdn.com/dms/image/C560BAQEYxazZM_hXgQ/company-logo_100_100/0/1634934418976?e=2147483647\u0026v=beta\u0026t=wI0YdMmxIctkzvnKxRfuAbT8h5eok_DlUqEph68J37s",
                "starts_at": {
                    "day": 1,
                    "month": 8,
                    "year": 2021
                },
                "title": "Co-Founder"
            },
            {
                "company": "Mindset Reset Podcast",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/mindset-reset-podcast",
                "description": "We dive into the mindsets of the world\u2019s foremost thought leaders and turn them into actionable insights so that others can discover greater happiness, success, and fulfillment.\n\nhttps://podcasts.apple.com/us/podcast/mindset-reset/id1553212607",
                "ends_at": null,
                "location": "Denver, Colorado, United States",
                "logo_url": "https://media.licdn.com/dms/image/C560BAQF9QJVQm3SOvA/company-logo_100_100/0/1614527476576?e=2147483647\u0026v=beta\u0026t=m3tx83nMN-E3XQFoJG0Wmch8U4qKnJ9i--5NSAfffC0",
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 2021
                },
                "title": "Founder"
            },
            {
                "company": "Product School",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/product-school",
                "description": "Product School is a global leader in Product Management training with a community of over one million product professionals. As a featured speaker, I help inspire the next generation of Product Managers to create innovative products and apply best practices in their work.",
                "ends_at": {
                    "day": 31,
                    "month": 12,
                    "year": 2020
                },
                "location": "Seattle, Washington, United States",
                "logo_url": "https://media.licdn.com/dms/image/C4E0BAQEKULb2pMnazw/company-logo_100_100/0/1657091674586?e=2147483647\u0026v=beta\u0026t=vgcwRvTFf1v-AxyFXfFuEm07g8Nlzsha12E6-aBj6lk",
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 2020
                },
                "title": "Featured Speaker"
            },
            {
                "company": "Project 1B",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/project-1b",
                "description": "The mission of Project 1B is to help 1 Billion people around the world maximize their sense of meaning so that they can lead more fulfilling lives. We do this through exposing the truth about success and happiness through the Mindset Reset Podcast, corporate training, youth education programs, group coaching, and investments in tech startups aligned with our mission.\n\nThe word success is widely understood as the attainment of financial gain, but somewhere along the lines we began believing that money = happiness, self worth, and meaning even though money has nothing to do with these things. Because of this twisted equation, young adults often make career decisions that solely maximize earning potential. And Ironically, if they manage to achieve society\u2019s definition of success, It often leaves many with a sense of meaninglessness.\n\nIf you want to live a meaningful life chase the word meaning as opposed to the word success - this simple shift in mindset will lead to a more authentic set of questions about the direction you should take your life.",
                "ends_at": null,
                "location": "Denver, Colorado, United States",
                "logo_url": "https://media.licdn.com/dms/image/C560BAQFG_MrwBC_iZg/company-logo_100_100/0/1594610187483?e=2147483647\u0026v=beta\u0026t=7NNWG1ZclbNsUW0k0PuD-v5xTmfpIcthOmHCDyMwWMk",
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 2020
                },
                "title": "Founder"
            },
            {
                "company": "YouTube",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/youtube",
                "description": "Mission: to help others land their dream jobs at a top tech companies that aligns with their passions.",
                "ends_at": null,
                "location": "Greater Seattle Area",
                "logo_url": "https://media.licdn.com/dms/image/C4D0BAQEfoRsyU4yUzg/company-logo_100_100/0/1631053379295?e=2147483647\u0026v=beta\u0026t=CmnUj5LeO5Yi-nA9xLgEYBPU5eZdLrPBG2qXmPhhoe4",
                "starts_at": {
                    "day": 1,
                    "month": 2,
                    "year": 2019
                },
                "title": "YouTube Content Creator - \"Tech Careers for Non-Engineers\""
            },
            {
                "company": "YouTube",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/youtube",
                "description": null,
                "ends_at": null,
                "location": "Seattle, Washington",
                "logo_url": "https://media.licdn.com/dms/image/C4D0BAQEfoRsyU4yUzg/company-logo_100_100/0/1631053379295?e=2147483647\u0026v=beta\u0026t=CmnUj5LeO5Yi-nA9xLgEYBPU5eZdLrPBG2qXmPhhoe4",
                "starts_at": {
                    "day": 1,
                    "month": 1,
                    "year": 2017
                },
                "title": "Youtube Content Creator - \"John Marty\""
            },
            {
                "company": "Amazon",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/amazon",
                "description": "I had a mix of roles at Amazon from Sr. PM to Sr. Manager of Product\nTwo years were spent on Marketplace Product Quality and 2 years in New Business Innovation",
                "ends_at": {
                    "day": 31,
                    "month": 3,
                    "year": 2021
                },
                "location": "Greater Seattle Area",
                "logo_url": "https://media.licdn.com/dms/image/C560BAQHTvZwCx4p2Qg/company-logo_100_100/0/1612205615891?e=2147483647\u0026v=beta\u0026t=PG9v_TmuSDxc9nAjnwxAFTWfFwhri5iJcJ4bcODhtPA",
                "starts_at": {
                    "day": 1,
                    "month": 3,
                    "year": 2017
                },
                "title": "Sr. Manager of Product"
            },
            {
                "company": "American Express",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/american-express",
                "description": null,
                "ends_at": {
                    "day": 31,
                    "month": 3,
                    "year": 2017
                },
                "location": "Phoenix, Arizona Area",
                "logo_url": "https://media.licdn.com/dms/image/C4D0BAQGRhsociEn4gQ/company-logo_100_100/0/1523269243842?e=2147483647\u0026v=beta\u0026t=SHRbiG3uqsCTfE1Gyd77tgJWtHAm4cYp-c6uILKTVNs",
                "starts_at": {
                    "day": 1,
                    "month": 7,
                    "year": 2015
                },
                "title": "Senior Global Product Manager"
            },
            {
                "company": "Mile High Automation, Inc.",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/mile-high-automation-inc-",
                "description": "Mile High Automation is a Smart Home Technology (Internet of Things) software and hardware development company. Our mission is to flawlessly develop and deliver impeccable software, hardware and system design for the high-end consumer market nationally and internationally. \n\n\u2022  Performed a short term change management engagement to lead a 12 member cross functional team through a major strategy and vision transition\n\u2022  Developed an international supply chain that increased profit margin by 30% on core products\n\u2022  Conceptualized, implemented, and rolled out a CRM that led to a 15% higher month over month close rate; trained sales team on newly created key performance indicators to maximize growth\n\u2022  Developed, implemented and oversaw a training process that scaled to 180+ national subcontractors\n\u2022  Translated user stories into detailed product requirements documents that the software development team used to build new features and functionality \n\u2022  Developed benchmarks for customer service, sales, and traffic conversion to maximize profit",
                "ends_at": {
                    "day": 31,
                    "month": 7,
                    "year": 2014
                },
                "location": "Denver Colorado",
                "logo_url": "https://media.licdn.com/dms/image/C4E0BAQHofg3toK4P7A/company-logo_100_100/0/1519903210468?e=2147483647\u0026v=beta\u0026t=vasirOnrmfFkQru9S8JBNtci00COt_s9x2AOexxqd-8",
                "starts_at": {
                    "day": 1,
                    "month": 3,
                    "year": 2014
                },
                "title": "Sr. Product Manager"
            },
            {
                "company": "EOS Controls",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/eos-controls",
                "description": "A Smart Home Technology (Internet of Things) software and hardware development company specializing in the mid to high-end condominium market in the United States and South America. \nEOS Controls supports the advancement of affordable and easy to user smart home technology through a network of non-traditional sales channels of architects, designers, and contractors. \n\n\u2022  Coordinated engineering, design, and marketing strategy for the launch of 6 iOS apps\n\u2022  Led a 5 member product team of engineers; conducted daily stand-ups and weekly design review meetings\n\u2022  Managed and prioritized product backlog for development Sprints as well as tested products before release\n\u2022  Effectively placed products through non-traditional distribution channels by identifying and developing relationships with over 100 national and international builders, architects, and designers",
                "ends_at": {
                    "day": 31,
                    "month": 5,
                    "year": 2014
                },
                "location": "Miami, Florida",
                "logo_url": "https://media.licdn.com/dms/image/C560BAQFV1hvbuwyU-A/company-logo_100_100/0/1519867781218?e=2147483647\u0026v=beta\u0026t=s5UGQj-N-5VatokXj3YN6IxOPmKpUZeetC5OZH-B-xU",
                "starts_at": {
                    "day": 1,
                    "month": 2,
                    "year": 2012
                },
                "title": "Founder/ Chief Operating Officer"
            },
            {
                "company": "Axxis Audio",
                "company_linkedin_profile_url": "https://www.linkedin.com/company/axxis-audio",
                "description": "Specializing in Smart Home Technology - Home Automation, Internet of Things\n\n\u2022  Raised $10,000 in investment to develop a home theater and home automation sales and installation business that grew to multi-million dollar sales (sold the company in 2011)\n\u2022  Developed mission-centric training, responsibility, and accountability framework \n\u2022  10 Direct Reports\n\u2022  Responsible for resource planning, scheduling, and project management \n\u2022  Filled the role of HR and developed a team building program for 10 direct reports, that included formal training, personal and professional peer support, mentoring and professional development; resulting in 20% higher retention rate and improved trust and communication\n\u2022  Deployed an ERP Solution in 2007 that unified 5 departments and provided a central reporting and accountability framework for a 23% employees productivity gain\n\u2022  Handled acquisition of 2nd largest competitor Cobalt Automation",
                "ends_at": {
                    "day": 31,
                    "month": 1,
                    "year": 2012
                },
                "location": "Durango Colorado",
                "logo_url": "https://media.licdn.com/dms/image/C560BAQHI-DLifzJs9Q/company-logo_100_100/0/1519868629336?e=2147483647\u0026v=beta\u0026t=l1Sk5NQO2Mtpo7HpppRkMhogjVXCwx5yxIxhcwUpNuc",
                "starts_at": {
                    "day": 1,
                    "month": 11,
                    "year": 2002
                },
                "title": "President/Founder"
            }
        ],
        "first_name": "John",
        "follower_count": null,
        "full_name": "John Marty",
        "groups": [],
        "headline": "Financial Freedom through Real Estate - LinkedIn Top Voice",
        "languages": [
            "English",
            "Spanish",
            "Japanese"
        ],
        "last_name": "Marty",
        "occupation": "Co-Founder at Freedom Fund Real Estate",
        "people_also_viewed": [],
        "profile_pic_url": "https://media.licdn.com/dms/image/C5603AQHaJSx0CBAUIA/profile-displayphoto-shrink_800_800/0/1558325759208?e=2147483647\u0026v=beta\u0026t=BluXpPg88xFnU2wMGLjuCUykSk_wKNdh8x3PI9wm6MI",
        "public_identifier": "johnrmarty",
        "recommendations": [
            "Rebecca Canfield\n\n      \n          \n          \n\n\n\n              \n                \n        \n              \n  \n\n      \n          John Marty is a genius at his craft. He is skilled in the art of making people feel empowered to seek out roles that they are qualified for, ask for salaries that they deserve, and creates a kind of pay it forward lifestyle. John helps you to get to places that you only thought were possible for other people. Anyone that is fortunate enough to learn from John should consider themselves extremely lucky. I know I do. ",
            "Zoe Sanoff\n\n      \n          \n          \n\n\n\n              \n                \n        \n              \n  \n\n      \n          John is so focused on helping guide you through an interview process not just for Amazon but on interviewing in general.  I\u0027ve generally done well at interviewing, my skills are top notch now.  John is so focused on on his clients and really goes above and beyond.  John is genuine, knowledgeable, well spoken and non-judgemental.  He is so encouraging, so positive and really easy to talk to.  Thank you John!"
        ],
        "similarly_named_profiles": [
            {
                "link": "https://www.linkedin.com/in/john-martinez-90384a229",
                "location": "San Antonio, TX",
                "name": "John Martinez",
                "summary": "Owner of Fight or Flight Medical Consultants, LLC  , Owner Marty\u2019s Hardwood Works"
            },
            {
                "link": "https://www.linkedin.com/in/senatormarty",
                "location": "St Paul, MN",
                "name": "John Marty",
                "summary": null
            },
            {
                "link": "https://www.linkedin.com/in/johnmarty",
                "location": "Orlando, FL",
                "name": "John Marty",
                "summary": "Lead Software Engineer, Commerce at Disney Parks  \u0026 Resorts Digital"
            },
            {
                "link": "https://www.linkedin.com/in/john-marty-ba56b478",
                "location": "Sarver, PA",
                "name": "John Marty",
                "summary": "Podiatrist at Ankle and Foot care inc"
            }
        ],
        "state": "Washington",
        "summary": "Most people go through life lost, disengaged, and unhappy at work and in their lives - I\u0027m on a mission to solve that.\n\nI spent 10 years as the founder of Axxis Audio, an electronics company that grew to multi-million dollar sales, which I sold in 2012. At that time, I funneled my earnings into the creation of an Internet of Things company, but numerous factors lead to its demise after 2 hard fought years. \n\nAt 31, I was penny-less, had a baby on the way, and had zero job prospects (despite applying to 150 companies). My desperate situation led me to take a job at Best Buy for $12 an hour while reinventing myself through the completion of an MBA at the University of Colorado, and a 6-month software development boot camp. \n\nAfter graduation, I landed at American Express as a Senior Product Manager and then got poached by Amazon in 2017 (because of my LinkedIn profile). My journey has led to a deep sense of perspective, humility, and purpose that I draw on to help others find clarity, meaning, and happiness in their careers and lives. \n\nCheck out my website for details on my Mindset Reset Podcast, Public Speaking, Consulting, or my free 40 page LinkedIn guide\n\nhttp://www.johnraphaelmarty.com/\n\nFAQ\u0027s\n\nQ: Can you speak at my Company, University, event or podcast?\nA: I\u0027d love to! I\u0027ve shared my message on the future of employment, breaking into big tech, and my personal story of reinventing myself and discovering my sense of purpose (and how you can too!).\n\n\u2611\ufe0f  YouTube Channel #1 (John Marty) : http://www.youtube.com/c/JohnMarty-uncommon\n\u2611\ufe0f  YouTube Channel #2 (Tech Careers for non-engineers: https://www.youtube.com/channel/UC900gMMPLwRGGXSTW1gdZHA\n\nFUN FACTS:\n\u2611\ufe0f I am an Avid cyclist and runner, and I just started learning to skateboard a half-pipe.\n\u2611\ufe0f Into the Enneagram? - I\u0027m a #3 (The Achiever)\n\nLETS CONNECT:\n\u2611\ufe0f Email: [email protected] (don\u0027t forget that \"R\"....The other guy gets my emails all the time)",
        "volunteer_work": []
    }
}
Key Description Example
linkedin_profile_url
LinkedIn Profile URL of the person that most closely matches the role
 "https://www.linkedin.com/in/senatormarty"
profile
A PersonEndpointResponse object
 See PersonEndpointResponse object

PersonEndpointResponse

Key Description Example
public_identifier
The vanity identifier of the public LinkedIn profile.
The vanity identifier comes after the /in/ part of the LinkedIn Profile URL
in the following format: https://www.linkedin.com/in/<public_identifier>
 "johnrmarty"
profile_pic_url
A temporary link to the user's profile picture that is valid for 30 minutes.
The temporal nature of the link is by design to prevent having Proxycurl be the mirror for the images.
The developer is expected to handle these images by downloading the image and re-hosting the image.
See this post for context.
Some profile pictures might be of the standard LinkedIn's profile picture placeholder. It is so because. See this post for context.
 "https://media.licdn.com/dms/image/C5603AQHaJSx0CBAUIA/profile-displayphoto-shrink_800_800/0/1558325759208?e=2147483647\u0026v=beta\u0026t=BluXpPg88xFnU2wMGLjuCUykSk_wKNdh8x3PI9wm6MI"
background_cover_image_url
A temporary link to the user's background cover picture
that is valid for 30 minutes.
The temporal nature of the link is by design to prevent
having Proxycurl be the mirror for the images.
The developer is expected to handle these images
by downloading the image and re-hosting the image.
See this post for context.
 "https://media.licdn.com/dms/image/C5616AQH9tkBTUhHfng/profile-displaybackgroundimage-shrink_200_800/0/1614530499015?e=2147483647\u0026v=beta\u0026t=VEoCyedtZulnAVYWT9BXfKHi5OFp8avElNjiz8kjSTU"
first_name
First name of the user.
 "John"
last_name
Last name of the user.
 "Marty"
full_name
Full name of the user (first_name + last_name)
 "John Marty"
follower_count
Follower count for this profile
 null
occupation
The title and company name of the user's current employment.
 "Co-Founder at Freedom Fund Real Estate"
headline
The tagline written by the user for his profile.
 "Financial Freedom through Real Estate - LinkedIn Top Voice"
summary
A blurb (longer than the tagline) written by the user for his profile.
 "Most people go through life lost, disengaged, and unhappy at work and in their lives - I\u0027m on a mission to solve that.\n\nI spent 10 years as the founder of Axxis Audio, an electronics company that grew to multi-million dollar sales, which I sold in 2012. At that time, I funneled my earnings into the creation of an Internet of Things company, but numerous factors lead to its demise after 2 hard fought years. \n\nAt 31, I was penny-less, had a baby on the way, and had zero job prospects (despite applying to 150 companies). My desperate situation led me to take a job at Best Buy for $12 an hour while reinventing myself through the completion of an MBA at the University of Colorado, and a 6-month software development boot camp. \n\nAfter graduation, I landed at American Express as a Senior Product Manager and then got poached by Amazon in 2017 (because of my LinkedIn profile). My journey has led to a deep sense of perspective, humility, and purpose that I draw on to help others find clarity, meaning, and happiness in their careers and lives. \n\nCheck out my website for details on my Mindset Reset Podcast, Public Speaking, Consulting, or my free 40 page LinkedIn guide\n\nhttp://www.johnraphaelmarty.com/\n\nFAQ\u0027s\n\nQ: Can you speak at my Company, University, event or podcast?\nA: I\u0027d love to! I\u0027ve shared my message on the future of employment, breaking into big tech, and my personal story of reinventing myself and discovering my sense of purpose (and how you can too!).\n\n\u2611\ufe0f YouTube Channel #1 (John Marty) : http://www.youtube.com/c/JohnMarty-uncommon\n\u2611\ufe0f YouTube Channel #2 (Tech Careers for non-engineers: https://www.youtube.com/channel/UC900gMMPLwRGGXSTW1gdZHA\n\nFUN FACTS:\n\u2611\ufe0f I am an Avid cyclist and runner, and I just started learning to skateboard a half-pipe.\n\u2611\ufe0f Into the Enneagram? - I\u0027m a #3 (The Achiever)\n\nLETS CONNECT:\n\u2611\ufe0f Email: [email protected] (don\u0027t forget that \"R\"....The other guy gets my emails all the time)"
country
The user's country of residence depicted by
a 2-letter country code (ISO 3166-1 alpha-2).
 "US"
country_full_name
The user's country of residence, in English words.
 "United States of America"
city
The city that the user is living at.
 "Seattle"
state
The state that the user is living at.
 "Washington"
experiences
The user's list of historic work experiences.
 See Experience object
education
The user's list of education background.
 See Education object
languages
A list of languages that the user claims to be familiar with,
and has added to his/her profile.
Do note that we do not have the proficiency level as
that data point is not available on a public LinkedIn profile.
 ["English", "Chinese", "Japanese"]
accomplishment_organisations
List of noteworthy organizations that this user is part of.
 See AccomplishmentOrg object
accomplishment_publications
List of noteworthy publications that this user has partook in.
 See Publication object
accomplishment_honors_awards
List of noteworthy honours and awards that this user has won.
 See HonourAward object
accomplishment_patents
List of noteworthy patents won by this user.
 See Patent object
accomplishment_courses
List of noteworthy courses partook by this user.
 See Course object
accomplishment_projects
List of noteworthy projects undertaken by this user.
 See Project object
accomplishment_test_scores
List of noteworthy test scores accomplished by this user.
 See TestScore object
volunteer_work
List of historic volunteer work experiences.
 See VolunteeringExperience object
certifications
List of noteworthy certifications accomplished by this user.
 See Certification object
connections
Total count of LinkedIn connections.
 500
people_also_viewed
A list of other LinkedIn profiles closely related to this user.
 See PeopleAlsoViewed object
recommendations
List of recommendations made by other users about this profile.
 ["Professional and dedicated approach towards clients and collegues."]
activities
A list of LinkedIn status activities.
 See Activity object
similarly_named_profiles
A list of other LinkedIn profiles with similar names.
 See SimilarProfile object
articles
A list of content-based articles posted by this user.
 See Article object
groups
A list of LinkedIn groups that this user is a part of.",
 See PersonGroup object
inferred_salary
A salary range inferred from the user's current job title and company.
 See InferredSalary object
gender
Gender of the user.
 "male"
birth_date
Birth date of the user.
 See Date object
industry
Industry that the user works in.
 "government administration"
extra
A bundle of extra data on this user.
 See PersonExtra object
interests
A list of interests that the user has.
 ["education", "health", "human rights"]
personal_emails
A list of personal emails associated with this user.
 ["[email protected]", "[email protected]", "cde@@outlook.com"]
personal_numbers
A list of personal mobile phone numbers associated with this user.
 ["+6512345678", "+6285123450953", "+6502300340"]

Experience

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

Date

Key Description Example
day
1
month
8
year
2023

Education

Key Description Example
starts_at
{"day": 1, "month": 1, "year": 2013}
ends_at
{"day": 31, "month": 12, "year": 2015}
field_of_study
"Finance + Economics"
degree_name
"Master of Business Administration (MBA)"
school
"University of Colorado Denver"
school_linkedin_profile_url
"https://www.linkedin.com/school/university-of-colorado-denver/"
description
null
logo_url
"https://media.licdn.com/dms/image/C560BAQGVi9eAHgWxFw/company-logo_100_100/0/1673448029676?e=2147483647\u0026v=beta\u0026t=NG6ttckXvnS2DX3abTfVACRY2E9Q1EcryNaJLRbE9OE"
grade
null
activities_and_societies
null

AccomplishmentOrg

Key Description Example
starts_at
{"day": 1, "month": 1, "year": 2012}
ends_at
{"day": 1, "month": 8, "year": 2016}
org_name
"Microsoft"
title
"Software Developer"
description
null

Publication

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

HonourAward

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

Patent

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

Course

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

Project

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

TestScore

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

VolunteeringExperience

Key Description Example
starts_at
{"day": 1, "month": 1, "year": 2012}
ends_at
{"day": 1, "month": 8, "year": 2016}
title
Name of volunteer activity.
 "Surveyor"
cause
"To help the world"
company
The company's display name.
 "Microsoft"
company_linkedin_profile_url
The company's profile URL.
If present, could be used with
Company Profile Endpoint for more info.
 "https://www.linkedin.com/company/microsoft"
description
null
logo_url
URL of the logo of the organisation.
 null

Certification

Key Description Example
starts_at
null
ends_at
null
name
Name of the course or program.
 "SAFe Agile Framework Practitioner - ( Scrum, XP, and Lean Practices in the SAFe Enterprise)"
license_number
null
display_source
null
authority
The organisation body issuing this certificate.
 "Scaled Agile, Inc."
url
null

PeopleAlsoViewed

Key Description Example
link
URL of the profile.
Useable with Person profile endpoint
 "https://www.linkedin.com/in/johndoe"
name
"John Doe"
summary
"Software Engineer at Google"
location
"Singapore"

Activity

Key Description Example
title
"Yesterday I toured a $1.2M property in California that has a large 13K sq ft lot with two homes on it. After 5 minutes of being on-site I\u2026"
link
"https://www.linkedin.com/posts/johnrmarty_financialfreedom-realestate-technology-activity-6940294635743301632-rsLo"
activity_status
"Shared by John Marty"

SimilarProfile

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

Article

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

PersonGroup

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

InferredSalary

Key Description Example
min
35000
max
45000

PersonExtra

Key Description Example
github_profile_id
This profile's Github account.
 "github-username"
facebook_profile_id
This profile's Facebook account.
 "facebook-username"
twitter_profile_id
This profile's twitter account.
 "twitter-username"

Response Headers

Header Key Description Example
X-Proxycurl-Credit-Cost Total cost of credits for this API call 3

Search API

Company Search Endpoint

GET /proxycurl/api/search/company

Cost: 35 credits / successful request base charge. + 3 credits / result returned (Extra charges might be incurred if premium optional parameters are used. Please read the description of the parameters that you intend to use).

Base charge does not apply when using a next_page URL.

Search for companies that meet a set of criteria within our exhaustive dataset of company profiles.

curl \
    -G \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/search/company' \
    --data-urlencode 'public_identifier_not_in_list=stripe,amazon' \
    --data-urlencode 'public_identifier_in_list=stripe,amazon' \
    --data-urlencode 'enrich_profiles=enrich' \
    --data-urlencode 'page_size=10' \
    --data-urlencode 'funding_raised_before=2019-12-30' \
    --data-urlencode 'funding_raised_after=2019-12-30' \
    --data-urlencode 'funding_amount_min=1000000' \
    --data-urlencode 'funding_amount_max=1000000' \
    --data-urlencode 'founded_before_year=1999' \
    --data-urlencode 'founded_after_year=1999' \
    --data-urlencode 'description=(?i)medical device' \
    --data-urlencode 'employee_count_min=1000' \
    --data-urlencode 'employee_count_max=1000' \
    --data-urlencode 'industry=(?i)^(higher )?education$' \
    --data-urlencode 'name=Technology' \
    --data-urlencode 'follower_count_max=1000' \
    --data-urlencode 'follower_count_min=1000' \
    --data-urlencode 'type=NON_PROFIT' \
    --data-urlencode 'city=Seattle|Los Angeles' \
    --data-urlencode 'region=United States' \
    --data-urlencode 'country=us'

import requests

api_key = 'YOUR_API_KEY'
headers = {'Authorization': 'Bearer ' + api_key}
api_endpoint = 'https://nubela.co/proxycurl/api/search/company'
params = {
    'public_identifier_not_in_list': 'stripe,amazon',
    'public_identifier_in_list': 'stripe,amazon',
    'enrich_profiles': 'enrich',
    'page_size': '10',
    'funding_raised_before': '2019-12-30',
    'funding_raised_after': '2019-12-30',
    'funding_amount_min': '1000000',
    'funding_amount_max': '1000000',
    'founded_before_year': '1999',
    'founded_after_year': '1999',
    'description': '(?i)medical device',
    'employee_count_min': '1000',
    'employee_count_max': '1000',
    'industry': '(?i)^(higher )?education$',
    'name': 'Technology',
    'follower_count_max': '1000',
    'follower_count_min': '1000',
    'type': 'NON_PROFIT',
    'city': 'Seattle|Los Angeles',
    'region': 'United States',
    'country': 'us',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=headers)

Run in Postman

URL Parameters

Parameter Required Description Example
public_identifier_not_in_list no
A list of public identifiers (the identifying portion of the company’s profile URL).
The target company’s identifier must not be a member of this list.
 stripe,amazon
public_identifier_in_list no
A list of public identifiers (the identifying portion of the company’s profile URL).
The target company’s identifier must be a member of this list.
 stripe,amazon
enrich_profiles no
Get the company's complete profile data rather than just the URLs to their LinkedIn profiles.

Each request respond with a streaming response of profiles.

The valid values are:

- skip (default): lists company's profile url
- enrich: include company's profile data in the list

Calling this API endpoint with this parameter would add 1 credit per result returned.
 enrich
page_size no
Tune the maximum results returned per API call.

The default value of this parameter is 100.

Accepted values for this parameter is an integer ranging from 1 to 100.

When enrich_profiles=enrich, this parameter accepts value ranging from 1 to 10.
 10
funding_raised_before no
Filter companies that have raised funding before this date.
 2019-12-30
funding_raised_after no
Filter companies that have raised funding after this date.
 2019-12-30
funding_amount_min no
Filter companies that have raised at least this much (USD) funding amount.
 1000000
funding_amount_max no
Filter companies that have raised at most this much (USD) funding amount.
 1000000
founded_before_year no
Filter companies that were founded before this year.
 1999
founded_after_year no
Filter companies that were founded after this year.
 1999
description no
Filter companies with a description matching the provided regular expression.

The accepted value for this parameter is a regular expression which is case sensitive by default and accepts an (?i) flag.
The default value of this parameter is null.
 (?i)medical device
employee_count_min no
Filter companies with at least this many employees.
 1000
employee_count_max no
Filter companies with at most this many employees.
 1000
industry no
Use this parameter to filter companies belonging to an industry that matches the provided regular expression. The industry attribute, found in a LinkedIn Company profile, describes the industry in which the company operates. The value of this attribute is an enumerator. This CSV file provides an exhaustive list of possible values for this attribute.

The accepted value for this parameter is a regular expression which is case sensitive by default and accepts an (?i) flag. The default value of this parameter is null.
 (?i)^(higher )?education$
name no
Filter companies with a name matching the provided regular expression.

The accepted value for this parameter is a regular expression which is case sensitive by default and accepts an (?i) flag.
The default value of this parameter is null.
 Technology
follower_count_max no
Filter companies with a LinkedIn follower count less than this value.
 1000
follower_count_min no
Filter companies with a LinkedIn follower count more than this value.
 1000
type no
Filter companies of the provided LinkedIn 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
 NON_PROFIT
city no
Filter companies based in cities matching the provided regular expression.

The accepted value for this parameter is a regular expression which is case sensitive by default and accepts an (?i) flag.
The default value of this parameter is null.
 Seattle|Los Angeles
region no
Filter companies based in regions matching the provided regular expression.
A “region” in this context means “state,” “province,” or similar political division, depending on what country you’re querying.

The accepted value for this parameter is a regular expression which is case sensitive by default and accepts an (?i) flag.
The default value of this parameter is null.
 United States
country no
Filter companies with an office based in this country.

This parameter accepts a case-insensitive Alpha-2 ISO3166 country code.
 us

Response

{
    "next_page": null,
    "results": [
        {
            "linkedin_profile_url": "https://www.linkedin.com/company/apple/",
            "profile": {
                "affiliated_companies": [
                    {
                        "industry": "Software Development",
                        "link": "https://www.linkedin.com/company/youtube",
                        "location": "San Bruno, CA",
                        "name": "YouTube"
                    },
                    {
                        "industry": "Software Development",
                        "link": "https://www.linkedin.com/showcase/google-cloud",
                        "location": "Mountain View, California",
                        "name": "Google Cloud"
                    },
                    {
                        "industry": "Advertising Services",
                        "link": "https://www.linkedin.com/showcase/think-with-google",
                        "location": "Mountain View, California",
                        "name": "Think with Google"
                    },
                    {
                        "industry": "Advertising Services",
                        "link": "https://www.linkedin.com/showcase/google-ads-",
                        "location": "Mountain View, California",
                        "name": "Google Ads"
                    },
                    {
                        "industry": "Software Development",
                        "link": "https://www.linkedin.com/showcase/googledevelopers",
                        "location": "Mountain View, CA",
                        "name": "Google Developers"
                    },
                    {
                        "industry": "Software Development",
                        "link": "https://www.linkedin.com/showcase/google-analytics",
                        "location": "Mountain View, California",
                        "name": "Google Analytics"
                    },
                    {
                        "industry": "IT Services and IT Consulting",
                        "link": "https://www.linkedin.com/showcase/googleworkspace",
                        "location": "Mountain View, California",
                        "name": "Google Workspace"
                    },
                    {
                        "industry": "Advertising Services",
                        "link": "https://www.linkedin.com/showcase/googlemarketingplatform",
                        "location": "Mountain View, California",
                        "name": "Google Marketing Platform"
                    },
                    {
                        "industry": "Software Development",
                        "link": "https://www.linkedin.com/showcase/google-developer-groups",
                        "location": "Mountain View, CA",
                        "name": "Google Developer Groups (GDG)"
                    },
                    {
                        "industry": "Advertising Services",
                        "link": "https://www.linkedin.com/showcase/google-ad-manager",
                        "location": "Mountain View, California",
                        "name": "Google Ad Manager"
                    },
                    {
                        "industry": "E-Learning Providers",
                        "link": "https://www.linkedin.com/showcase/grow-with-google",
                        "location": "Mountain View, California",
                        "name": "Grow with Google"
                    },
                    {
                        "industry": "Software Development",
                        "link": "https://www.linkedin.com/showcase/google-for-startups",
                        "location": "San Francisco, California",
                        "name": "Google for Startups"
                    },
                    {
                        "industry": "Research Services",
                        "link": "https://www.linkedin.com/company/x",
                        "location": "Mountain View, CA",
                        "name": "X, the moonshot factory"
                    },
                    {
                        "industry": "Technology, Information and Internet",
                        "link": "https://www.linkedin.com/showcase/google-small-business",
                        "location": "Mountain View, California",
                        "name": "Google Small Business"
                    },
                    {
                        "industry": "Technology, Information and Internet",
                        "link": "https://www.linkedin.com/showcase/google-cloud-partners",
                        "location": "Mountain View, California",
                        "name": "Google Cloud Partners"
                    },
                    {
                        "industry": "Human Resources Services",
                        "link": "https://www.linkedin.com/showcase/rework-with-google",
                        "location": null,
                        "name": "re:Work with Google"
                    },
                    {
                        "industry": "Advertising Services",
                        "link": "https://www.linkedin.com/showcase/google-partners",
                        "location": null,
                        "name": "Google Partners"
                    },
                    {
                        "industry": "IT Services and IT Consulting",
                        "link": "https://www.linkedin.com/showcase/chrome-enterprise",
                        "location": null,
                        "name": "Chrome Enterprise"
                    },
                    {
                        "industry": "Software Development",
                        "link": "https://www.linkedin.com/showcase/androiddev",
                        "location": "Mountain View, California",
                        "name": "Android Developers"
                    },
                    {
                        "industry": "IT Services and IT Consulting",
                        "link": "https://www.linkedin.com/showcase/googleplaybiz",
                        "location": "Mountain View, CA",
                        "name": "Google Play business community"
                    },
                    {
                        "industry": "Online Audio and Video Media",
                        "link": "https://www.linkedin.com/showcase/google-news-initiative",
                        "location": "Mountain View, CA",
                        "name": "Google News Initiative"
                    },
                    {
                        "industry": "Advertising Services",
                        "link": "https://www.linkedin.com/showcase/googleadmob",
                        "location": null,
                        "name": "Google AdMob"
                    },
                    {
                        "industry": "Software Development",
                        "link": "https://www.linkedin.com/showcase/google-health",
                        "location": null,
                        "name": "Google Health"
                    },
                    {
                        "industry": "Technology, Information and Internet",
                        "link": "https://www.linkedin.com/showcase/google-pay",
                        "location": "Mountain View, California",
                        "name": "Google Pay"
                    },
                    {
                        "industry": "Software Development",
                        "link": "https://www.linkedin.com/showcase/google-user-research.",
                        "location": null,
                        "name": "Google User Experience Research"
                    },
                    {
                        "industry": "Venture Capital and Private Equity Principals",
                        "link": "https://ca.linkedin.com/company/capitalg",
                        "location": "San Francisco, CA",
                        "name": "CapitalG"
                    },
                    {
                        "industry": "Software Development",
                        "link": "https://www.linkedin.com/showcase/android_by_google",
                        "location": null,
                        "name": "Android"
                    },
                    {
                        "industry": "IT Services and IT Consulting",
                        "link": "https://www.linkedin.com/showcase/androidenterprise",
                        "location": "Mountain View, CA",
                        "name": "Android Enterprise"
                    },
                    {
                        "industry": "Software Development",
                        "link": "https://ng.linkedin.com/showcase/gwgafrica",
                        "location": "Lagos, Lagos",
                        "name": "Grow with Google Africa"
                    },
                    {
                        "industry": "Software Development",
                        "link": "https://www.linkedin.com/showcase/flutterdevofficial",
                        "location": "Mountain View, California",
                        "name": "Flutter Dev"
                    },
                    {
                        "industry": "Software Development",
                        "link": "https://www.linkedin.com/showcase/firebase",
                        "location": "Mountain View, CA",
                        "name": "Firebase"
                    },
                    {
                        "industry": "Advertising Services",
                        "link": "https://www.linkedin.com/company/adometry",
                        "location": "Mountain View, CA",
                        "name": "Adometry (acquired by Google)"
                    },
                    {
                        "industry": "Software Development",
                        "link": "https://www.linkedin.com/showcase/google-nest",
                        "location": "Mountain View, California",
                        "name": "Google Nest Pro \u0026 Enterprise Partners"
                    },
                    {
                        "industry": "Software Development",
                        "link": "https://www.linkedin.com/showcase/tensorflowdev",
                        "location": null,
                        "name": "TensorFlow"
                    },
                    {
                        "industry": "Software Development",
                        "link": "https://www.linkedin.com/showcase/google-developers-north-america",
                        "location": "Mountain View, CA",
                        "name": "Google Developers North America"
                    },
                    {
                        "industry": "Technology, Information and Internet",
                        "link": "https://www.linkedin.com/showcase/google-chrome",
                        "location": "Mountain View, CA",
                        "name": "Google Chrome"
                    },
                    {
                        "industry": "Advertising Services",
                        "link": "https://www.linkedin.com/showcase/rare-with-google",
                        "location": null,
                        "name": "Rare with Google"
                    },
                    {
                        "industry": null,
                        "link": "https://www.linkedin.com/showcase/flutterdev-hold",
                        "location": null,
                        "name": "Flutter"
                    },
                    {
                        "industry": null,
                        "link": "https://www.linkedin.com/showcase/firebase-hold",
                        "location": null,
                        "name": "Firebase"
                    }
                ],
                "background_cover_image_url": "https://s3.us-west-000.backblazeb2.com/proxycurl/company/google/cover?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=0004d7f56a0400b0000000001%2F20230119%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20230119T060024Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=abb7a4b87583cffda8db24d58d906c644998fae8cbb99e98c69a35720fcd0050",
                "company_size": [
                    10001,
                    null
                ],
                "company_size_on_linkedin": 319856,
                "company_type": "PUBLIC_COMPANY",
                "description": "A problem isn\u0027t truly solved until it\u0027s solved for all. Googlers build products that help create opportunities for everyone, whether down the street or across the globe. Bring your insight, imagination and a healthy disregard for the impossible. Bring everything that makes you unique. Together, we can build for everyone.\n\nCheck out our career opportunities at careers.google.com.",
                "follower_count": 27472792,
                "founded_year": null,
                "hq": {
                    "city": "Mountain View",
                    "country": "US",
                    "is_hq": true,
                    "line_1": "1600 Amphitheatre Parkway",
                    "postal_code": "94043",
                    "state": "CA"
                },
                "industry": "Software Development",
                "linkedin_internal_id": "1441",
                "locations": [
                    {
                        "city": "Mountain View",
                        "country": "US",
                        "is_hq": true,
                        "line_1": "1600 Amphitheatre Parkway",
                        "postal_code": "94043",
                        "state": "CA"
                    },
                    {
                        "city": "New York",
                        "country": "US",
                        "is_hq": false,
                        "line_1": "111 8th Ave",
                        "postal_code": "10011",
                        "state": "NY"
                    },
                    {
                        "city": "Amsterdam",
                        "country": "NL",
                        "is_hq": false,
                        "line_1": "Claude Debussylaan 34",
                        "postal_code": "1082 MD",
                        "state": "North Holland"
                    },
                    {
                        "city": "Sao Paulo",
                        "country": "BR",
                        "is_hq": false,
                        "line_1": "Avenida Brigadeiro Faria Lima, 3477",
                        "postal_code": "04538-133",
                        "state": "SP"
                    },
                    {
                        "city": "Kitchener",
                        "country": "CA",
                        "is_hq": false,
                        "line_1": "51 Breithaupt St",
                        "postal_code": "N2H 5G5",
                        "state": "ON"
                    },
                    {
                        "city": "Dublin",
                        "country": "IE",
                        "is_hq": false,
                        "line_1": "Barrow Street",
                        "postal_code": null,
                        "state": "County Dublin"
                    },
                    {
                        "city": "Bengaluru",
                        "country": "IN",
                        "is_hq": false,
                        "line_1": "Old Madras Road",
                        "postal_code": "560016",
                        "state": "Karnataka"
                    },
                    {
                        "city": "Boulder",
                        "country": "US",
                        "is_hq": false,
                        "line_1": "2590 Pearl St",
                        "postal_code": "80302",
                        "state": "CO"
                    },
                    {
                        "city": "Seattle",
                        "country": "US",
                        "is_hq": false,
                        "line_1": "601 N 34th St",
                        "postal_code": "98103",
                        "state": "WA"
                    },
                    {
                        "city": "Sydney",
                        "country": "AU",
                        "is_hq": false,
                        "line_1": "48 Pirrama Rd",
                        "postal_code": "2009",
                        "state": "NSW"
                    },
                    {
                        "city": "Irvine",
                        "country": "US",
                        "is_hq": false,
                        "line_1": "19510 Jamboree Rd",
                        "postal_code": "92612",
                        "state": "CA"
                    },
                    {
                        "city": "Chicago",
                        "country": "US",
                        "is_hq": false,
                        "line_1": "320 N Morgan St",
                        "postal_code": "60607",
                        "state": "IL"
                    },
                    {
                        "city": "Mumbai",
                        "country": "IN",
                        "is_hq": false,
                        "line_1": "3 Bandra Kurla Complex Road",
                        "postal_code": "400051",
                        "state": "Maharashtra"
                    },
                    {
                        "city": "Taguig City",
                        "country": "PH",
                        "is_hq": false,
                        "line_1": "5th Ave",
                        "postal_code": null,
                        "state": "National Capital Region"
                    },
                    {
                        "city": "Singapore",
                        "country": "SG",
                        "is_hq": false,
                        "line_1": "3 Pasir Panjang Rd",
                        "postal_code": "118484",
                        "state": "Singapore"
                    },
                    {
                        "city": "Hyderabad",
                        "country": "IN",
                        "is_hq": false,
                        "line_1": "13",
                        "postal_code": "500084",
                        "state": "TS"
                    },
                    {
                        "city": "Melbourne",
                        "country": "AU",
                        "is_hq": false,
                        "line_1": "90 Collins St",
                        "postal_code": "3000",
                        "state": "VIC"
                    },
                    {
                        "city": "San Bruno",
                        "country": "US",
                        "is_hq": false,
                        "line_1": "901 Cherry Ave",
                        "postal_code": "94066",
                        "state": "CA"
                    },
                    {
                        "city": "Madrid",
                        "country": "ES",
                        "is_hq": false,
                        "line_1": "Plaza Pablo Ruiz Picasso",
                        "postal_code": "28046",
                        "state": "Community of Madrid"
                    },
                    {
                        "city": "Washington",
                        "country": "US",
                        "is_hq": false,
                        "line_1": "25 Massachusetts Ave NW",
                        "postal_code": "20001",
                        "state": "DC"
                    },
                    {
                        "city": "Gurugram",
                        "country": "IN",
                        "is_hq": false,
                        "line_1": "15",
                        "postal_code": "122001",
                        "state": "HR"
                    },
                    {
                        "city": "Bogota",
                        "country": "CO",
                        "is_hq": false,
                        "line_1": "Carrera 11A 94-45",
                        "postal_code": "110221",
                        "state": "Bogota, D.C."
                    },
                    {
                        "city": "Wan Chai",
                        "country": "HK",
                        "is_hq": false,
                        "line_1": "2 Matheson St",
                        "postal_code": null,
                        "state": "Hong Kong"
                    },
                    {
                        "city": "Reston",
                        "country": "US",
                        "is_hq": false,
                        "line_1": "1875 Explorer St",
                        "postal_code": "20190",
                        "state": "VA"
                    },
                    {
                        "city": "Toronto",
                        "country": "CA",
                        "is_hq": false,
                        "line_1": "111 Richmond St W",
                        "postal_code": "M5H 2G4",
                        "state": "ON"
                    },
                    {
                        "city": "San Francisco",
                        "country": "US",
                        "is_hq": false,
                        "line_1": "345 Spear St",
                        "postal_code": "94105",
                        "state": "CA"
                    },
                    {
                        "city": "Cambridge",
                        "country": "US",
                        "is_hq": false,
                        "line_1": "355 Main St",
                        "postal_code": "02142",
                        "state": "MA"
                    },
                    {
                        "city": "Milan",
                        "country": "IT",
                        "is_hq": false,
                        "line_1": "Via Federico Confalonieri, 4",
                        "postal_code": "20124",
                        "state": "Lomb."
                    },
                    {
                        "city": "London",
                        "country": "GB",
                        "is_hq": false,
                        "line_1": "St Giles High Street",
                        "postal_code": "WC2H 8AG",
                        "state": "England"
                    },
                    {
                        "city": "Austin",
                        "country": "US",
                        "is_hq": false,
                        "line_1": "9606 N Mopac Expy",
                        "postal_code": "78759",
                        "state": "TX"
                    },
                    {
                        "city": "Los Angeles",
                        "country": "US",
                        "is_hq": false,
                        "line_1": "340 Main St",
                        "postal_code": "90291",
                        "state": "CA"
                    },
                    {
                        "city": "Madrid",
                        "country": "ES",
                        "is_hq": false,
                        "line_1": "Plaza Pablo Ruiz Picasso",
                        "postal_code": "28020",
                        "state": "Community of Madrid"
                    },
                    {
                        "city": "Ann Arbor",
                        "country": "US",
                        "is_hq": false,
                        "line_1": "2300 Traverwood Dr",
                        "postal_code": "48105",
                        "state": "MI"
                    },
                    {
                        "city": "Las Condes",
                        "country": "CL",
                        "is_hq": false,
                        "line_1": "Avenida Costanera Sur",
                        "postal_code": "7550000",
                        "state": "Santiago Metropolitan"
                    },
                    {
                        "city": "Atlanta",
                        "country": "US",
                        "is_hq": false,
                        "line_1": "10 10th St NE",
                        "postal_code": "30309",
                        "state": "GA"
                    },
                    {
                        "city": "Warsaw",
                        "country": "PL",
                        "is_hq": false,
                        "line_1": "ulica Emilii Plater 53",
                        "postal_code": "00-125",
                        "state": "MA"
                    },
                    {
                        "city": "Bengaluru",
                        "country": "IN",
                        "is_hq": false,
                        "line_1": "3 Swamy Vivekananda Road",
                        "postal_code": "560016",
                        "state": "Karnataka"
                    },
                    {
                        "city": "Kirkland",
                        "country": "US",
                        "is_hq": false,
                        "line_1": "777 6th St S",
                        "postal_code": "98033",
                        "state": "WA"
                    },
                    {
                        "city": "Munich",
                        "country": "DE",
                        "is_hq": false,
                        "line_1": "Erika-Mann-Strasse 33",
                        "postal_code": "80636",
                        "state": "BY"
                    },
                    {
                        "city": "Miguel Hidalgo",
                        "country": "MX",
                        "is_hq": false,
                        "line_1": "Montes Urales",
                        "postal_code": "11000",
                        "state": "CDMX"
                    },
                    {
                        "city": "Buenos Aires City",
                        "country": "AR",
                        "is_hq": false,
                        "line_1": "Avenida Alicia Moreau de Justo 350",
                        "postal_code": "1107",
                        "state": "Buenos Aires Autonomous City"
                    },
                    {
                        "city": "Paris",
                        "country": "FR",
                        "is_hq": false,
                        "line_1": "8 Rue de Londres",
                        "postal_code": "75009",
                        "state": "IdF"
                    },
                    {
                        "city": "Tel Aviv-Yafo",
                        "country": "IL",
                        "is_hq": false,
                        "line_1": "Yigal Allon 98",
                        "postal_code": "67891",
                        "state": "Tel Aviv"
                    },
                    {
                        "city": "Berlin",
                        "country": "DE",
                        "is_hq": false,
                        "line_1": "Unter den Linden 14",
                        "postal_code": "10117",
                        "state": "BE"
                    },
                    {
                        "city": "Hamburg",
                        "country": "DE",
                        "is_hq": false,
                        "line_1": "ABC-Strasse 19",
                        "postal_code": "20354",
                        "state": "HH"
                    },
                    {
                        "city": "Frisco",
                        "country": "US",
                        "is_hq": false,
                        "line_1": "6175 Main St",
                        "postal_code": "75034",
                        "state": "TX"
                    },
                    {
                        "city": "Zurich",
                        "country": "CH",
                        "is_hq": false,
                        "line_1": "Brandschenkestrasse 110",
                        "postal_code": "8002",
                        "state": "ZH"
                    },
                    {
                        "city": "Stockholm",
                        "country": "SE",
                        "is_hq": false,
                        "line_1": "Kungsbron 2",
                        "postal_code": "111 22",
                        "state": "Stockholm County"
                    }
                ],
                "name": "Google",
                "profile_pic_url": "https://s3.us-west-000.backblazeb2.com/proxycurl/company/google/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=0004d7f56a0400b0000000001%2F20230119%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20230119T060024Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=0d3500b39da8db1d2d8f5727a9ac39a7c4a88b4632ed68209dee12f06bc79aca",
                "search_id": "1441",
                "similar_companies": [
                    {
                        "industry": "Software Development",
                        "link": "https://www.linkedin.com/company/amazon",
                        "location": "Seattle, WA",
                        "name": "Amazon"
                    },
                    {
                        "industry": "Software Development",
                        "link": "https://www.linkedin.com/company/microsoft",
                        "location": "Redmond, Washington",
                        "name": "Microsoft"
                    },
                    {
                        "industry": "Computers and Electronics Manufacturing",
                        "link": "https://www.linkedin.com/company/apple",
                        "location": "Cupertino, California",
                        "name": "Apple"
                    },
                    {
                        "industry": "Software Development",
                        "link": "https://www.linkedin.com/company/meta",
                        "location": "Menlo Park, CA",
                        "name": "Meta"
                    },
                    {
                        "industry": "Entertainment Providers",
                        "link": "https://www.linkedin.com/company/netflix",
                        "location": "Los Gatos, CA",
                        "name": "Netflix"
                    },
                    {
                        "industry": "IT Services and IT Consulting",
                        "link": "https://www.linkedin.com/company/ibm",
                        "location": "Armonk, New York, NY",
                        "name": "IBM"
                    },
                    {
                        "industry": "Software Development",
                        "link": "https://www.linkedin.com/company/linkedin",
                        "location": "Sunnyvale, CA",
                        "name": "LinkedIn"
                    },
                    {
                        "industry": "Business Consulting and Services",
                        "link": "https://www.linkedin.com/company/deloitte",
                        "location": null,
                        "name": "Deloitte"
                    },
                    {
                        "industry": "IT Services and IT Consulting",
                        "link": "https://in.linkedin.com/company/tata-consultancy-services",
                        "location": "Mumbai, Maharashtra",
                        "name": "Tata Consultancy Services"
                    },
                    {
                        "industry": "Manufacturing",
                        "link": "https://uk.linkedin.com/company/unilever",
                        "location": "Blackfriars, London",
                        "name": "Unilever"
                    }
                ],
                "specialities": [
                    "search",
                    "ads",
                    "mobile",
                    "android",
                    "online video",
                    "apps",
                    "machine learning",
                    "virtual reality",
                    "cloud",
                    "hardware",
                    "artificial intelligence",
                    "youtube",
                    "software"
                ],
                "tagline": null,
                "universal_name_id": "google",
                "updates": [
                    {
                        "article_link": null,
                        "image": "https://media.licdn.com/dms/image/C5605AQFthnjiTD6Mvg/videocover-high/0/1660754102856?e=2147483647\u0026v=beta\u0026t=PPOsA9J3vCTXWhuZclqSBQl7DLSDLvy5hKWlkHI85YE",
                        "posted_on": {
                            "day": 13,
                            "month": 9,
                            "year": 2022
                        },
                        "text": "Want to kick start your #LifeAtGoogle but not sure where to begin? Explore our Build Your Future site, where you can learn about developmental programs, learn tips for future interviews, sign up for informational events, and even hear real stories from Googlers who\u2019ve been where you are now. Get started \u2192 https://bit.ly/3SKPzQB",
                        "total_likes": 4267
                    },
                    {
                        "article_link": null,
                        "image": "https://media.licdn.com/dms/image/C4D22AQGcvTlKRR3qvQ/feedshare-shrink_2048_1536/0/1672854668558?e=1676505600\u0026v=beta\u0026t=whRRx9ULPEuyw_FgUg4Z3N3O9iksyJW7ewCGZA6ujdg",
                        "posted_on": null,
                        "text": "Ariana, welcome to Google. Here\u2019s to a year full of growth, learning, and experiences at #LifeAtGoogle! \ud83c\udf89",
                        "total_likes": 397
                    },
                    {
                        "article_link": null,
                        "image": "https://media.licdn.com/dms/image/C4D22AQGcvTlKRR3qvQ/feedshare-shrink_2048_1536/0/1672854668558?e=1676505600\u0026v=beta\u0026t=whRRx9ULPEuyw_FgUg4Z3N3O9iksyJW7ewCGZA6ujdg",
                        "posted_on": {
                            "day": 6,
                            "month": 1,
                            "year": 2023
                        },
                        "text": null,
                        "total_likes": 0
                    },
                    {
                        "article_link": null,
                        "image": "https://media.licdn.com/dms/image/C5622AQHlEhyso9-BAA/feedshare-shrink_800/0/1672235570251?e=1676505600\u0026v=beta\u0026t=PaHpVodYauVt_Th4eZRJAz_S5LuD_e6MJJZkqEiENBQ",
                        "posted_on": {
                            "day": 10,
                            "month": 1,
                            "year": 2023
                        },
                        "text": "With a new year comes new beginnings. Welcome to Google, Mega, we\u2019re glad you and your #Mewgler are here! #LifeAtGoogle",
                        "total_likes": 1252
                    },
                    {
                        "article_link": null,
                        "image": "https://media.licdn.com/dms/image/C5622AQHlEhyso9-BAA/feedshare-shrink_800/0/1672235570251?e=1676505600\u0026v=beta\u0026t=PaHpVodYauVt_Th4eZRJAz_S5LuD_e6MJJZkqEiENBQ",
                        "posted_on": {
                            "day": 30,
                            "month": 12,
                            "year": 2022
                        },
                        "text": null,
                        "total_likes": 0
                    },
                    {
                        "article_link": null,
                        "image": "https://media.licdn.com/dms/image/C5605AQHir6yRaHkgHg/feedshare-thumbnail_720_1280/0/1672258205329?e=2147483647\u0026v=beta\u0026t=ZILK1L9klkFzLD0SKezztfPT5rSbdscMWVcTMgoUeWY",
                        "posted_on": {
                            "day": 30,
                            "month": 12,
                            "year": 2022
                        },
                        "text": "Turn on job alerts and explore all that the Google careers site has to offer \u2192 https://goo.gle/3HCR9kn #LifeAtGoogle",
                        "total_likes": 2186
                    },
                    {
                        "article_link": "https://blog.google/inside-google/life-at-google/jennys-path-to-become-a-director-of-customer-engineering/",
                        "image": null,
                        "posted_on": {
                            "day": 23,
                            "month": 12,
                            "year": 2022
                        },
                        "text": "\"Leaders at Google ask themselves, \u0027How can we get Googlers from where they are today to where they aspire to be?\u0027\" In the last #MyPathtoGoogle of the year, meet our Director of Customer Engineering based in Hong Kong, Jenny Sun. Jenny shares her path to a leadership role after starting in tech as a software engineer and how her desire to learn has helped her customers, teams, and personal career grow.",
                        "total_likes": 2038
                    },
                    {
                        "article_link": "https://fairygodboss.com/articles/im-a-team-lead-at-google-heres-how-ergs-and-mentorship-advanced-my-career",
                        "image": null,
                        "posted_on": {
                            "day": 23,
                            "month": 12,
                            "year": 2022
                        },
                        "text": "Meet Nancy Hwang, a Product Activation and Customer Experience team lead here at Google. Earlier this month, Nancy sat down with Fairygodboss to reflect on how mentorship and her involvement in an employee resource group have positively impacted her career journey at Google. \n\nRead about Nancy\u2019s story and her advice on how to advance your career \u2b07\ufe0f",
                        "total_likes": 1490
                    },
                    {
                        "article_link": null,
                        "image": "https://media.licdn.com/dms/image/C4E22AQG2ZKINx_jsZw/feedshare-shrink_2048_1536/0/1670381081829?e=1676505600\u0026v=beta\u0026t=ywsC6hkhcztq3V61xVvf5go2D_rSr53Waoq3sdlczqY",
                        "posted_on": {
                            "day": 23,
                            "month": 12,
                            "year": 2022
                        },
                        "text": "365 days full of learnings, and more to come! We\u2019re glad you\u2019re part of #LifeAtGoogle, Eunice.",
                        "total_likes": 18817
                    },
                    {
                        "article_link": null,
                        "image": "https://media.licdn.com/dms/image/C4E22AQG2ZKINx_jsZw/feedshare-shrink_2048_1536/0/1670381081829?e=1676505600\u0026v=beta\u0026t=ywsC6hkhcztq3V61xVvf5go2D_rSr53Waoq3sdlczqY",
                        "posted_on": {
                            "day": 13,
                            "month": 12,
                            "year": 2022
                        },
                        "text": null,
                        "total_likes": 0
                    },
                    {
                        "article_link": null,
                        "image": null,
                        "posted_on": {
                            "day": 23,
                            "month": 12,
                            "year": 2022
                        },
                        "text": "2022 is almost over, which means it\u2019s time to reflect! Googlers, you shared lots of projects with the world this year. Which was your favorite to work on? Which coworkers made your #LifeAtGoogle brighter every day? Tag them in the comments with a shoutout!",
                        "total_likes": 1234
                    },
                    {
                        "article_link": null,
                        "image": "https://media.licdn.com/dms/image/C5622AQFLUJbMj4V7Vw/feedshare-shrink_800/0/1670208017850?e=1676505600\u0026v=beta\u0026t=qFxz6eV4tBGTznrHcq_qJw31_TePt6JrrjOXXwMF6Iw",
                        "posted_on": {
                            "day": 16,
                            "month": 12,
                            "year": 2022
                        },
                        "text": "A bit of insight on the Noogler hat tradition from the team that keeps the tradition going! #LifeAtGoogle",
                        "total_likes": 3078
                    },
                    {
                        "article_link": null,
                        "image": "https://media.licdn.com/dms/image/C5622AQFLUJbMj4V7Vw/feedshare-shrink_800/0/1670208017850?e=1676505600\u0026v=beta\u0026t=qFxz6eV4tBGTznrHcq_qJw31_TePt6JrrjOXXwMF6Iw",
                        "posted_on": {
                            "day": 13,
                            "month": 12,
                            "year": 2022
                        },
                        "text": null,
                        "total_likes": 0
                    },
                    {
                        "article_link": null,
                        "image": "https://media.licdn.com/dms/image/C5622AQHGS9rpL1dwCA/feedshare-shrink_2048_1536/0/1671117185457?e=1676505600\u0026v=beta\u0026t=7oFrPTZU5gB0uS1mzaVqt13ftFApKTeQah7Ace4iL7U",
                        "posted_on": {
                            "day": 16,
                            "month": 12,
                            "year": 2022
                        },
                        "text": "Chris Kiagiri, Technical Account manager, joined Google 15 years ago, as Kenya\u2019s employee number 2. \n\nLast month at our Google Sandbox Nairobi event, he shared with our participants his career journey and Google\u2019s 15-years of Engineering in Africa.\n\n\u201cI often tell students that Google hadn\u2019t even been founded when I graduated from high school, so they shouldn\u0027t limit their dreams to the opportunities that currently exist.\u201c \n\nThank you to our participants, we hope you left with first-hand experience of what #LifeatGoogle is all about \u2014 and thank you to Chris and all other Googlers who made this experience possible! \n\nWant to learn more? Check out our upcoming and on-demand events here \u003e https://goo.gle/3VDHOg8",
                        "total_likes": 1821
                    }
                ],
                "website": "https://goo.gle/3m1IN7m"
            }
        }
    ]
}
Key Description Example
results
A list of SearchResult objects.
 See CSearchResult object
next_page
The URL to the next page of search results.
 null
total_result_count
Total results found
 23

CSearchResult

Key Description Example
linkedin_profile_url
The LinkedIn Profile URL of the company
 "\n https://www.linkedin.com/company/apple/\n "
profile
If enrich_profiles=enrich is specified, the company's entire profile
is returned. Otherwise this field will return null.
 See LinkedinCompany object

LinkedinCompany

Key Description Example
linkedin_internal_id
LinkedIn's Internal and immutable ID of this Company profile.
 "1441"
description
A textual description of the company.
 "A problem isn\u0027t truly solved until it\u0027s solved for all. Googlers build products that help create opportunities for everyone, whether down the street or across the globe. Bring your insight, imagination and a healthy disregard for the impossible. Bring everything that makes you unique. Together, we can build for everyone.\n\nCheck out our career opportunities at careers.google.com."
website
The URL of the company's website.
 "https://goo.gle/3m1IN7m"
industry
The industry attribute, found in a LinkedIn Company profile, describes the industry in which the company operates. The value of this attribute is an enumerator. This CSV file provides an exhaustive list of possible values for this attribute.
 "Software Development"
company_size
Sequenceed range of company head count
 [10001, null]
company_size_on_linkedin
The size of the company as indicated on LinkedIn.
 319856
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
The year the company was founded.
 null
specialities
A list of specialities.
 ["search", "ads", "mobile", "android", "online video", "apps", "machine learning", "virtual reality", "cloud", "hardware", "artificial intelligence", "youtube", "software"]
locations
List of CompanyLocation
 See CompanyLocation object
name
The name of the company.
 "Google"
tagline
A short, catchy phrase that represents the company's mission or brand.
 "Think Different - But Not Too Different"
universal_name_id
A unique numerical identifier for the company used in the LinkedIn platform.
 "google"
profile_pic_url
The URL of the company's profile picture.
 "https://s3.us-west-000.backblazeb2.com/proxycurl/company/google/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=0004d7f56a0400b0000000001%2F20230119%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20230119T060024Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=0d3500b39da8db1d2d8f5727a9ac39a7c4a88b4632ed68209dee12f06bc79aca"
background_cover_image_url
The URL of the company's background cover image.
 "https://s3.us-west-000.backblazeb2.com/proxycurl/company/google/cover?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=0004d7f56a0400b0000000001%2F20230119%2Fus-west-000%2Fs3%2Faws4_request\u0026X-Amz-Date=20230119T060024Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=abb7a4b87583cffda8db24d58d906c644998fae8cbb99e98c69a35720fcd0050"
search_id
Useable with Job listing endpoint
 "1441"
similar_companies
List of SimilarCompany
 See SimilarCompany object
affiliated_companies
List of AffiliatedCompany
 See AffiliatedCompany object
updates
List of CompanyUpdate
 See CompanyUpdate object
follower_count
The number of followers the company has on LinkedIn.
 27472792
acquisitions
A Acquisition object
 See Acquisition object
exit_data
List of Exit
 See Exit object
extra
Company extra when extra=include
 See CompanyDetails object
funding_data
Company Funding data when funding_data=include
 See Funding object
categories
The categories attribute is fetched from the company's Crunchbase profile. Values for this attribute are free-form text, and there is no exhaustive list of categories. Consider the categories attribute as "hints" regarding the products or services offered by the company.
 ["artificial-intelligence", "virtual-reality"]

CompanyLocation

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

SimilarCompany

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

AffiliatedCompany

Key Description Example
name
"LinkedIn"
link
"https://www.linkedin.com/company/linkedin"
industry
"Internet"
location
"Sunnyvale, California"

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
2023

Acquisition

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

AcquiredCompany

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

Acquisitor

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

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

Funding

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

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"

Response Headers

Header Key Description Example
X-Proxycurl-Credit-Cost Total cost of credits for this API call 35

Person Search Endpoint

GET /proxycurl/api/search/person/

Cost: 35 credits / successful request base charge. + 3 credits / result returned. (Extra charges might be incurred if premium optional parameters are used. Please read the description of the parameters that you intend to use).

Base charge does not apply when using a next_page URL.

Search for people who meet a set of criteria within our exhaustive dataset of people profiles.

This API endpoint is powered by LinkDB, our exhaustive dataset of people and company profiles.

curl \
    -G \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/search/person/' \
    --data-urlencode 'country=US' \
    --data-urlencode 'public_identifier_not_in_list=williamhgates,johnrmarty' \
    --data-urlencode 'public_identifier_in_list=williamhgates,johnrmarty' \
    --data-urlencode 'enrich_profiles=enrich' \
    --data-urlencode 'page_size=10' \
    --data-urlencode 'current_company_funding_raised_before=2019-12-30' \
    --data-urlencode 'current_company_funding_raised_after=2019-12-30' \
    --data-urlencode 'current_company_funding_amount_min=1000000' \
    --data-urlencode 'current_company_funding_amount_max=1000000' \
    --data-urlencode 'current_company_founded_before_year=1999' \
    --data-urlencode 'current_company_founded_after_year=1999' \
    --data-urlencode 'current_company_description=(?i)medical device' \
    --data-urlencode 'current_company_employee_count_min=1000' \
    --data-urlencode 'current_company_employee_count_max=1000' \
    --data-urlencode 'current_company_industry=(?i)^(higher )?education$' \
    --data-urlencode 'current_company_follower_count_max=1000' \
    --data-urlencode 'current_company_follower_count_min=1000' \
    --data-urlencode 'current_company_type=NON_PROFIT' \
    --data-urlencode 'current_company_city=Seattle|Los Angeles' \
    --data-urlencode 'current_company_region=United States' \
    --data-urlencode 'current_company_country=us' \
    --data-urlencode 'skills=(?i)accounting' \
    --data-urlencode 'interests=(?i)technology' \
    --data-urlencode 'industries=(?i)automotive' \
    --data-urlencode 'summary=(?i)founder' \
    --data-urlencode 'headline=(?i)founder' \
    --data-urlencode 'city=Seattle|Los Angeles' \
    --data-urlencode 'region=United States' \
    --data-urlencode 'languages=Mandarin|Chinese' \
    --data-urlencode 'linkedin_groups=(?i)haskell' \
    --data-urlencode 'past_company_name=Stripe|Apple' \
    --data-urlencode 'current_company_name=Stripe|Apple' \
    --data-urlencode 'past_job_description=(?i)education' \
    --data-urlencode 'current_job_description=(?i)education' \
    --data-urlencode 'past_company_linkedin_profile_url=https://www.linkedin.com/company/apple' \
    --data-urlencode 'current_company_linkedin_profile_url=https://www.linkedin.com/company/apple' \
    --data-urlencode 'current_role_before=2019-12-30' \
    --data-urlencode 'current_role_after=2019-12-30' \
    --data-urlencode 'past_role_title=(?i)founder' \
    --data-urlencode 'current_role_title=(?i)founder' \
    --data-urlencode 'education_school_linkedin_profile_url=https://www.linkedin.com/school/national-university-of-singapore/' \
    --data-urlencode 'education_school_name=Caltech|Massachusetts Institute of Technology' \
    --data-urlencode 'education_degree_name=\bMBA\b' \
    --data-urlencode 'education_field_of_study=(?i)computer science' \
    --data-urlencode 'last_name=Jackson|Johnson' \
    --data-urlencode 'first_name=Sarah?'

import requests

api_key = 'YOUR_API_KEY'
headers = {'Authorization': 'Bearer ' + api_key}
api_endpoint = 'https://nubela.co/proxycurl/api/search/person/'
params = {
    'country': 'US',
    'public_identifier_not_in_list': 'williamhgates,johnrmarty',
    'public_identifier_in_list': 'williamhgates,johnrmarty',
    'enrich_profiles': 'enrich',
    'page_size': '10',
    'current_company_funding_raised_before': '2019-12-30',
    'current_company_funding_raised_after': '2019-12-30',
    'current_company_funding_amount_min': '1000000',
    'current_company_funding_amount_max': '1000000',
    'current_company_founded_before_year': '1999',
    'current_company_founded_after_year': '1999',
    'current_company_description': '(?i)medical device',
    'current_company_employee_count_min': '1000',
    'current_company_employee_count_max': '1000',
    'current_company_industry': '(?i)^(higher )?education$',
    'current_company_follower_count_max': '1000',
    'current_company_follower_count_min': '1000',
    'current_company_type': 'NON_PROFIT',
    'current_company_city': 'Seattle|Los Angeles',
    'current_company_region': 'United States',
    'current_company_country': 'us',
    'skills': '(?i)accounting',
    'interests': '(?i)technology',
    'industries': '(?i)automotive',
    'summary': '(?i)founder',
    'headline': '(?i)founder',
    'city': 'Seattle|Los Angeles',
    'region': 'United States',
    'languages': 'Mandarin|Chinese',
    'linkedin_groups': '(?i)haskell',
    'past_company_name': 'Stripe|Apple',
    'current_company_name': 'Stripe|Apple',
    'past_job_description': '(?i)education',
    'current_job_description': '(?i)education',
    'past_company_linkedin_profile_url': 'https://www.linkedin.com/company/apple',
    'current_company_linkedin_profile_url': 'https://www.linkedin.com/company/apple',
    'current_role_before': '2019-12-30',
    'current_role_after': '2019-12-30',
    'past_role_title': '(?i)founder',
    'current_role_title': '(?i)founder',
    'education_school_linkedin_profile_url': 'https://www.linkedin.com/school/national-university-of-singapore/',
    'education_school_name': 'Caltech|Massachusetts Institute of Technology',
    'education_degree_name': '\bMBA\b',
    'education_field_of_study': '(?i)computer science',
    'last_name': 'Jackson|Johnson',
    'first_name': 'Sarah?',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=headers)

Run in Postman

URL Parameters

Parameter Required Description Example
country yes
Filter people located in this country.
This parameter accepts a case-insensitive Alpha-2 ISO3166 country code.
 US
public_identifier_not_in_list no
A list of public identifiers (the identifying portion of the person’s profile URL).
The target person’s identifier must not be a member of this list.
 williamhgates,johnrmarty
public_identifier_in_list no
A list of public identifiers (the identifying portion of the person’s profile URL).
The target person’s identifier must be a member of this list.
 williamhgates,johnrmarty
enrich_profiles no
Get the person's complete profile data rather than just the URLs to their LinkedIn profiles.

Each request respond with a streaming response of profiles.

The valid values are:

* skip (default): lists person's profile url only
* enrich: include person's profile data in the list

Calling this API endpoint with this parameter would add 1 credit per result returned.
 enrich
page_size no
Tune the maximum results returned per API call.

The default value of this parameter is 100.

Accepted values for this parameter is an integer ranging from 1 to 100.

When enrich_profiles=enrich, this parameter accepts value ranging from 1 to 10.
 10
current_company_funding_raised_before no
Filter people who are currently working at a company that has raised funding before this date.
 2019-12-30
current_company_funding_raised_after no
Filter people who are currently working at a company that has raised funding after this date.
 2019-12-30
current_company_funding_amount_min no
Filter people who are currently working at a company that has raised at least this much (USD) funding amount.
 1000000
current_company_funding_amount_max no
Filter people who are currently working at a company that has raised at most this much (USD) funding amount.
 1000000
current_company_founded_before_year no
Filter people who are currently working at a company that was founded before this year.
 1999
current_company_founded_after_year no
Filter people who are currently working at a company that was founded after this year.
 1999
current_company_description no
Filter people who are currently working at a company with a description matching the provided regular expression.

The accepted value for this parameter is a regular expression which is case sensitive by default and accepts an (?i) flag.
The default value of this parameter is null.
 (?i)medical device
current_company_employee_count_min no
Filter people who are currently working at a company with at least this many employees.
 1000
current_company_employee_count_max no
Filter people who are currently working at a company with at most this many employees.
 1000
current_company_industry no
Filter people who are currently working at a company belonging to an industry that matches the provided regular expression. The industry attribute, found in a LinkedIn Company profile, describes the industry in which the company operates. The value of this attribute is an enumerator. This CSV file provides an exhaustive list of possible values for this attribute.

The accepted value for this parameter is a regular expression which is case sensitive by default and accepts an (?i) flag. The default value of this parameter is null.
 (?i)^(higher )?education$
current_company_follower_count_max no
Filter people who are currently working at a company with a LinkedIn follower count less than this value.
 1000
current_company_follower_count_min no
Filter people who are currently working at a company with a LinkedIn follower count more than this value.
 1000
current_company_type no
Filter people who are currently working at a company of the provided LinkedIn 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
 NON_PROFIT
current_company_city no
Filter people who are currently working at a company based in a city matching the provided regular expression.

The accepted value for this parameter is a regular expression which is case sensitive by default and accepts an (?i) flag.
The