NAV
shell python

Overview

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

With Proxycurl API, you can

Open API 3.0

Download Our Proxycurl OpenAPI 3.0 Specs

Authentication

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

The bearer token is injected in the Authorization header

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

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

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

Rate limit

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

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

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

You should handle 429 errors and apply exponential backoff.

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.

Credits

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

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

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

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

Timeouts and API response time

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

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

We recommend a timeout of 60 seconds.

Errors

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

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

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

Explain it to me like I'm 5

Jobs API

What you have What you get Which API Endpoint to use?
LinkedIn (Company) Profile URL Detailed job data Job Profile Endpoint
Company Profile URL List of open job position Jobs 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
Company Profile Picture 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
Work Email Address LinkedIn (Person) Profile URL Reverse Work Email Lookup Endpoint
LinkedIn (Person) Profile URL List of Personal Contact Numbers Personal Contact Number Lookup Endpoint
LinkedIn (Person) Profile URL List of Personal Emails Personal Email Lookup Endpoint
Email Address Disposable Email Check Disposable email Endpoint

People API

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

School API

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

Reveal API

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

Meta API

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

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[asyncio]'

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

# install proxycurl-py with twisted
$ pip install 'proxycurl[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

Jobs API

Jobs Listing Count Endpoint

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

Cost: 2 credits / successful request.

Count number of jobs posted by a company on LinkedIn

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/v2/linkedin/company/job/count?when=past-month&flexibility=remote&geo_id=92000000&keyword=software+engineer&search_id=1035'
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/v2/linkedin/company/job/count'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
params = {
    'when': 'past-month',
    'flexibility': 'remote',
    'geo_id': '92000000',
    'keyword': 'software engineer',
    'search_id': '1035',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
when no The time when the job is posted,
It accepts the following case-insensitive values only:
- yesterday
- past-week
- past-month
- anytime (default)
past-month
flexibility no The flexibility of the job.
It accepts the following 3 case insensitive values only:
- remote
- on-site
- hybrid
- anything (default)
remote
geo_id no The geo_id of the location to search for.
For example, 92000000 is the geo_id of world wide.

See this article as to how you may be able to match regions to geo_id input values.
92000000
keyword no The keyword to search for. software engineer
search_id no The search_id of the company on LinkedIn.
You can get the search_id of a LinkedIn company via
Company Profile API.
1035

Response

{
    "count": 887622
}
Key Description Example
count 887622

Jobs Listing Endpoint

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

Cost: 2 credits / successful request.

List jobs posted by a company on LinkedIn

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/v2/linkedin/company/job?when=past-month&flexibility=remote&geo_id=92000000&keyword=software+engineer&search_id=1035'
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/v2/linkedin/company/job'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
params = {
    'when': 'past-month',
    'flexibility': 'remote',
    'geo_id': '92000000',
    'keyword': 'software engineer',
    'search_id': '1035',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
when no The time when the job is posted,
It accepts the following case-insensitive values only:
- yesterday
- past-week
- past-month
- anytime (default)
past-month
flexibility no The flexibility of the job.
It accepts the following 3 case insensitive values only:
- remote
- on-site
- hybrid
- anything (default)
remote
geo_id no The geo_id of the location to search for.
For example, 92000000 is the geo_id of world wide.

See this article as to how you may be able to match regions to geo_id input values.
92000000
keyword no The keyword to search for. software engineer
search_id no The search_id of the company on LinkedIn.
You can get the search_id of a LinkedIn company via
Company Profile API.
1035

Response

{
    "job": [
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Product Management: Intern Opportunities for University Students",
            "job_url": "https://www.linkedin.com/jobs/view/product-management-intern-opportunities-for-university-students-at-microsoft-3203330682",
            "list_date": "2022-10-09",
            "location": "New York, NY"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Content Strategist",
            "job_url": "https://www.linkedin.com/jobs/view/content-strategist-at-microsoft-3257692764",
            "list_date": "2022-10-21",
            "location": "United States"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Product Management: Intern Opportunities for University Students",
            "job_url": "https://www.linkedin.com/jobs/view/product-management-intern-opportunities-for-university-students-at-microsoft-3285166057",
            "list_date": "2022-10-16",
            "location": "New Jersey, United States"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Product Management: Intern Opportunities for University Students",
            "job_url": "https://www.linkedin.com/jobs/view/product-management-intern-opportunities-for-university-students-at-microsoft-3203328879",
            "list_date": "2022-10-28",
            "location": "Hawaii, United States"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Product Management: Intern Opportunities for University Students",
            "job_url": "https://www.linkedin.com/jobs/view/product-management-intern-opportunities-for-university-students-at-microsoft-3203334096",
            "list_date": "2022-10-09",
            "location": "Mountain View, CA"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Content Strategist",
            "job_url": "https://www.linkedin.com/jobs/view/content-strategist-at-microsoft-3257696537",
            "list_date": "2022-10-21",
            "location": "Hawaii, United States"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Product Management: Intern Opportunities for University Students",
            "job_url": "https://www.linkedin.com/jobs/view/product-management-intern-opportunities-for-university-students-at-microsoft-3203327999",
            "list_date": "2022-10-29",
            "location": "Illinois, United States"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Product Management: Intern Opportunities for University Students",
            "job_url": "https://www.linkedin.com/jobs/view/product-management-intern-opportunities-for-university-students-at-microsoft-3203330696",
            "list_date": "2022-10-09",
            "location": "Washington, United States"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Product Management: Intern Opportunities for University Students",
            "job_url": "https://www.linkedin.com/jobs/view/product-management-intern-opportunities-for-university-students-at-microsoft-3203327990",
            "list_date": "2022-10-28",
            "location": "Massachusetts, United States"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Product Management: Intern Opportunities for University Students",
            "job_url": "https://www.linkedin.com/jobs/view/product-management-intern-opportunities-for-university-students-at-microsoft-3203330693",
            "list_date": "2022-10-28",
            "location": "Utah, United States"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Product Management: Intern Opportunities for University Students",
            "job_url": "https://www.linkedin.com/jobs/view/product-management-intern-opportunities-for-university-students-at-microsoft-3203333219",
            "list_date": "2022-10-09",
            "location": "Washington, DC"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Product Management: Intern Opportunities for University Students",
            "job_url": "https://www.linkedin.com/jobs/view/product-management-intern-opportunities-for-university-students-at-microsoft-3326765134",
            "list_date": "2022-10-26",
            "location": "Bellevue, WA"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Program Manager (Chief of Staff Office)",
            "job_url": "https://www.linkedin.com/jobs/view/program-manager-chief-of-staff-office-at-microsoft-3321408962",
            "list_date": "2022-10-20",
            "location": "United States"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Product Management: Intern Opportunities for University Students",
            "job_url": "https://www.linkedin.com/jobs/view/product-management-intern-opportunities-for-university-students-at-microsoft-3203332363",
            "list_date": "2022-10-09",
            "location": "Dallas, TX"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Product Management: Intern Opportunities for University Students",
            "job_url": "https://www.linkedin.com/jobs/view/product-management-intern-opportunities-for-university-students-at-microsoft-3203331488",
            "list_date": "2022-10-09",
            "location": "Pennsylvania, United States"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Content Strategist",
            "job_url": "https://www.linkedin.com/jobs/view/content-strategist-at-microsoft-3257696539",
            "list_date": "2022-10-21",
            "location": "New York, NY"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Product Management: Intern Opportunities for University Students",
            "job_url": "https://www.linkedin.com/jobs/view/product-management-intern-opportunities-for-university-students-at-microsoft-3203327997",
            "list_date": "2022-10-28",
            "location": "North Carolina, United States"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Product Management: Intern Opportunities for University Students",
            "job_url": "https://www.linkedin.com/jobs/view/product-management-intern-opportunities-for-university-students-at-microsoft-3203334106",
            "list_date": "2022-10-09",
            "location": "Florida, United States"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Product Management: Intern Opportunities for University Students",
            "job_url": "https://www.linkedin.com/jobs/view/product-management-intern-opportunities-for-university-students-at-microsoft-3203334098",
            "list_date": "2022-10-09",
            "location": "Cambridge, MA"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Content Strategist",
            "job_url": "https://www.linkedin.com/jobs/view/content-strategist-at-microsoft-3257696527",
            "list_date": "2022-10-21",
            "location": "San Francisco, CA"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Content Strategist",
            "job_url": "https://www.linkedin.com/jobs/view/content-strategist-at-microsoft-3257697337",
            "list_date": "2022-10-21",
            "location": "Florida, United States"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Business Operations: Full-time Opportunities for University Graduates, United States",
            "job_url": "https://www.linkedin.com/jobs/view/business-operations-full-time-opportunities-for-university-graduates-united-states-at-microsoft-3301555138",
            "list_date": "2022-10-28",
            "location": "Bellevue, WA"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Product Management: Intern Opportunities for University Students",
            "job_url": "https://www.linkedin.com/jobs/view/product-management-intern-opportunities-for-university-students-at-microsoft-3203328882",
            "list_date": "2022-10-28",
            "location": "Delaware, United States"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Product Management: Intern Opportunities for University Students",
            "job_url": "https://www.linkedin.com/jobs/view/product-management-intern-opportunities-for-university-students-at-microsoft-3203331492",
            "list_date": "2022-10-09",
            "location": "Oregon, United States"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Business Operations: Full-time Opportunities for University Graduates, United States",
            "job_url": "https://www.linkedin.com/jobs/view/business-operations-full-time-opportunities-for-university-graduates-united-states-at-microsoft-3301550928",
            "list_date": "2022-10-28",
            "location": "Redmond, WA"
        }
    ],
    "next_page_api_url": "http://nubela.co/proxycurl/proxycurl/api/v2/linkedin/company/job?pagination=eyJwYWdlIjogMX0\u0026search_id=1035",
    "next_page_no": 1,
    "previous_page_api_url": null,
    "previous_page_no": null
}
Key Description Example
job List of Job See Job object
next_page_no 1
next_page_api_url "https://nubela.co/proxycurl/api/v2/linkedin/company/job?pagination=eyJwYWdlIjogMX0\u0026search_id=1035"
previous_page_no null
previous_page_api_url null

Job

Key Description Example
company "Microsoft"
company_url "https://www.linkedin.com/company/microsoft"
job_title "Product Management: Intern Opportunities for University Students"
job_url "https://www.linkedin.com/jobs/view/product-management-intern-opportunities-for-university-students-at-microsoft-3203330682"
list_date "2022-10-09"
location "New York, NY"

Job Profile Endpoint

GET /proxycurl/api/linkedin/job

Cost: 2 credits / successful request.

Get structured data of a LinkedIn Job Profile

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

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

URL Parameters

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

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

Response

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

JobCompany

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

Company API

Employee Count Endpoint

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

Cost: 1 credit / successful request.

Get a number of total employees of a Company.

Get an employee count of this company from various sources.

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

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

URL Parameters

Parameter Required Description Example
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
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/

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

Employee Search API Endpoint

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

Cost: 10 credits / successful request. + 6 credits / employee returned

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.

Results are limited by data that we have within LinkDB. 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 \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/linkedin/company/employee/search/?page_size=1000&linkedin_company_profile_url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fmicrosoft%2F&keyword_regex=%5BCc%5D%5BEe%5D%5BOo%5D'
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/linkedin/company/employee/search/'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
params = {
    'page_size': '1000',
    'linkedin_company_profile_url': 'https://www.linkedin.com/company/microsoft/',
    'keyword_regex': '[Cc][Ee][Oo]',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
page_size no Tune the maximum results returned per API call.
The default value of this parameter is 200000.
Accepted values for this parameter is an integer ranging from 1 to 200000.
1000
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. [Cc][Ee][Oo]

Response

{
    "employees": [
        {
            "profile": null,
            "profile_url": "https://www.linkedin.com/in/satyanadella"
        }
    ],
    "next_page": null
}
Key Description Example
employees [{"profile": null, "profile_url": "https://www.linkedin.com/in/satyanadella"}]
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"

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 \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/linkedin/company/profile-picture?linkedin_company_profile_url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fapple%2F'
import requests

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

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": "http://localhost:4566/proxycurl-web-dev/company/apple/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20220912%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20220912T065816Z\u0026X-Amz-Expires=1800\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=40e484b7b1a9c4fd712d99b658d68efb115d8b20be227c8d5c49fc62dfd4d480"
}
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.
"http://localhost:4566/proxycurl-web-dev/company/apple/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20220912%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20220912T065816Z\u0026X-Amz-Expires=1800\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=40e484b7b1a9c4fd712d99b658d68efb115d8b20be227c8d5c49fc62dfd4d480"

Employee Listing Endpoint

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

Cost: 3 credits / employee returned.

Get a list of employees of a Company.

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

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/linkedin/company/employees/?enrich_profiles=enrich&role_search=%5BFf%5D%5BOo%5D%5BUu%5D%5BNn%5D%5BDd%5D%5BEe%5D%5BRr%5D&page_size=100&employment_status=current&resolve_numeric_id=false&url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fmicrosoft'
import requests

api_endpoint = 'https://nubela.co/proxycurl/api/linkedin/company/employees/'
api_key = 'YOUR_API_KEY'
header_dic = {'Authorization': 'Bearer ' + api_key}
params = {
    'enrich_profiles': 'enrich',
    'role_search': '[Ff][Oo][Uu][Nn][Dd][Ee][Rr]',
    'page_size': '100',
    'employment_status': 'current',
    'resolve_numeric_id': 'false',
    'url': 'https://www.linkedin.com/company/microsoft',
}
response = requests.get(api_endpoint,
                        params=params,
                        headers=header_dic)

URL Parameters

Parameter Required Description Example
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 is a regular expression (regex).

(The base cost of calling this API endpoint with this parameter would be 10 credits.
Each employee matched and returned would cost 6 credits per employee returned.)
[Ff][Oo][Uu][Nn][Dd][Ee][Rr]
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 100.
100
employment_status no Parameter to tell the API to return past or current employees.

Valid values are current, past, and all:

* current (default) : lists current employees
* past : lists past employees
* all : lists current & past employees
current
resolve_numeric_id no Enable support for Company Profile URLs with numerical IDs that you most frequently fetch from Sales Navigator.
We achieve this by resolving numerical IDs into vanity IDs with cached company profiles from LinkDB.
For example, we will turn https://www.linkedin.com/company/1234567890 to https://www.linkedin.com/company/acme-corp -- for which the API endpoint only supports the latter.

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

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

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": "http://localhost:4566/proxycurl-web-dev/person/williamhgates/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20221003%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20221003T091809Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=653f499173f225e30141b4f7ff86e45b16a4fdb6cc91fec10f395fb27427ad26",
                "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 [{"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": "http://localhost:4566/proxycurl-web-dev/person/williamhgates/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20221003%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20221003T091809Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=653f499173f225e30141b4f7ff86e45b16a4fdb6cc91fec10f395fb27427ad26", "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 "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"

Company Lookup Endpoint

GET /proxycurl/api/linkedin/company/resolve

Cost: 2 credits / successful request.

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

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

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

URL Parameters

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

Response

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

Remarks

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

Company Profile Endpoint

GET /proxycurl/api/linkedin/company

Cost: 1 credit / successful request.

Get structured data of a Company Profile

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

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

URL Parameters

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

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

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

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

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

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

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

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

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

Response

{
    "acquisitions": {
        "acquired": [
            {
                "announced_date": {
                    "day": 1,
                    "month": 1,
                    "year": 2022
                },
                "crunchbase_profile_url": "https://www.crunchbase.com/organization/silver-edge",
                "linkedin_profile_url": "https://www.linkedin.com/company/silver-edge",
                "price": 100
            }
        ],
        "acquired_by": null
    },
    "affiliated_companies": [
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/company/youtube",
            "location": "San Bruno, CA",
            "name": "YouTube"
        }
    ],
    "background_cover_image_url": "http://localhost:4566/proxycurl-web-dev/company/apple/cover?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20221124%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20221124T064058Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=3e7f1611e2f1f9c8072529c1b203cce689a39eb58870f89699759968d4fca09f",
    "categories": [],
    "company_size": [
        10001,
        null
    ],
    "company_size_on_linkedin": 255823,
    "company_type": "PUBLIC_COMPANY",
    "description": "We\u2019re a diverse collective of thinkers and doers, continually reimagining what\u2019s possible to help us all do what we love in new ways. And the same innovation that goes into our products also applies to our practices \u2014 strengthening our commitment to leave the world better than we found it. This is where your work can make a difference in people\u2019s lives. Including your own.\n\nApple is an equal opportunity employer that is committed to inclusion and diversity. Visit apple.com/careers to learn more.",
    "exit_data": [],
    "extra": {
        "company_type": null,
        "contact_email": null,
        "crunchbase_rank": 1,
        "facebook_id": null,
        "founding_date": null,
        "ipo_date": null,
        "ipo_status": null,
        "number_of_acquisitions": null,
        "number_of_exits": null,
        "number_of_funding_rounds": null,
        "number_of_investments": null,
        "number_of_investors": null,
        "number_of_lead_investments": null,
        "number_of_lead_investors": null,
        "operating_status": null,
        "phone_number": null,
        "stock_symbol": null,
        "total_fund_raised": null,
        "total_funding_amount": null,
        "twitter_id": null
    },
    "follower_count": 17789389,
    "founded_year": 1976,
    "funding_data": [],
    "hq": {
        "city": "Cupertino",
        "country": "US",
        "is_hq": true,
        "line_1": "1 Apple Park Way",
        "postal_code": "95014",
        "state": "California"
    },
    "industry": "Computers and Electronics Manufacturing",
    "linkedin_internal_id": "162479",
    "locations": [
        {
            "city": "Cupertino",
            "country": "US",
            "is_hq": true,
            "line_1": "1 Apple Park Way",
            "postal_code": "95014",
            "state": "California"
        }
    ],
    "name": "Apple",
    "profile_pic_url": "http://localhost:4566/proxycurl-web-dev/company/apple/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20221124%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20221124T064058Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=d85ef15f2bbc0c2ae5da60ec41ae02da7fbf4561b3afdad318a6e1168659d3e9",
    "search_id": "162479",
    "similar_companies": [
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/company/google",
            "location": "Mountain View, CA",
            "name": "Google"
        },
        {
            "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": "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": "Motor Vehicle Manufacturing",
            "link": "https://www.linkedin.com/company/tesla-motors",
            "location": "Austin, Texas",
            "name": "Tesla"
        },
        {
            "industry": "IT Services and IT Consulting",
            "link": "https://www.linkedin.com/company/ibm",
            "location": "Armonk, New York, NY",
            "name": "IBM"
        },
        {
            "industry": "Computers and Electronics Manufacturing",
            "link": "https://kr.linkedin.com/company/samsung-electronics",
            "location": "Suwon-Si, Gyeonggi-Do",
            "name": "Samsung Electronics"
        },
        {
            "industry": "Software Development",
            "link": "https://www.linkedin.com/company/linkedin",
            "location": "Sunnyvale, CA",
            "name": "LinkedIn"
        },
        {
            "industry": "Musicians",
            "link": "https://se.linkedin.com/company/spotify",
            "location": "Stockholm, Stockholm County",
            "name": "Spotify"
        }
    ],
    "specialities": [
        "Innovative Product Development",
        "World-Class Operations",
        "Retail",
        "Telephone Support"
    ],
    "tagline": null,
    "universal_name_id": "apple",
    "updates": [],
    "website": "http://www.apple.com/careers"
}
Key Description Example
linkedin_internal_id LinkedIn's Internal and immutable ID of this Company profile. "162479"
description "We\u2019re a diverse collective of thinkers and doers, continually reimagining what\u2019s possible to help us all do what we love in new ways. And the same innovation that goes into our products also applies to our practices \u2014 strengthening our commitment to leave the world better than we found it. This is where your work can make a difference in people\u2019s lives. Including your own.\n\nApple is an equal opportunity employer that is committed to inclusion and diversity. Visit apple.com/careers to learn more."
website "http://www.apple.com/careers"
industry "Computers and Electronics Manufacturing"
company_size Listed range of company head count [10001, null]
company_size_on_linkedin 255823
hq A CompanyLocation object See CompanyLocation object
company_type Possible values:

EDUCATIONAL: Educational Institution

GOVERNMENT_AGENCY: Government Agency

NON_PROFIT : Nonprofit

PARTNERSHIP : Partnership

PRIVATELY_HELD: Privately Held

PUBLIC_COMPANY: Public Company

SELF_EMPLOYED: Self-Employed

SELF_OWNED: Sole Proprietorship
"PUBLIC_COMPANY"
founded_year 1976
specialities ["Innovative Product Development", "World-Class Operations", "Retail", "Telephone Support"]
locations List of CompanyLocation See CompanyLocation object
name "Apple"
tagline "Think Different - But Not Too Different"
universal_name_id "apple"
profile_pic_url "http://localhost:4566/proxycurl-web-dev/company/apple/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20221124%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20221124T064058Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=d85ef15f2bbc0c2ae5da60ec41ae02da7fbf4561b3afdad318a6e1168659d3e9"
background_cover_image_url "http://localhost:4566/proxycurl-web-dev/company/apple/cover?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20221124%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20221124T064058Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=3e7f1611e2f1f9c8072529c1b203cce689a39eb58870f89699759968d4fca09f"
search_id Useable with Job listing endpoint "162479"
similar_companies List of SimilarCompany See SimilarCompany object
updates List of CompanyUpdate See CompanyUpdate object
follower_count 17789389
acquisitions An Acquisition object See Acquisition object
exit_data List of Exit See Exit object
extra Company extra when extra=include See CompanyDetails object
funding_data Company Funding data when funding_data=include See Funding object
categories A list of categories` ["artificial-intelligence", "virtual-reality"]

CompanyLocation

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

SimilarCompany

Key Description Example
name "Google"
link "https://www.linkedin.com/company/google"
industry "Software Development"
location "Mountain View, CA"

CompanyUpdate

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

Date

Key Description Example
day 30
month 9
year 2021

Acquisition

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

AcquiredCompany

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

Date

Key Description Example
day 1
month 4
year 1976

Acquisitor

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

Date

Key Description Example
day 6
month 3
year 2020

Exit

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

CompanyDetails

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

Date

Key Description Example
day 1
month 1
year 2000

Funding

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

Date

Key Description Example
day 1
month 1
year 2001

Investor

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

Contact API

Reverse Work Email Lookup Endpoint

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

Cost: 3 credits / successful request.

Resolve LinkedIn Profile from a work email address

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

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

URL Parameters

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

Response

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

Remarks

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

Work Email Lookup Endpoint

GET /proxycurl/api/linkedin/profile/email

Cost: 3 credits / request.

Lookup work email address of a LinkedIn Person Profile.

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

Endpoint behavior

This endpoint may not return results immediately.

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

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

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

URL Parameters

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

Status codes

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

Response

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

Webhook request

We will make a POST request to your webhook, if one is provided under callback_url parameter in the initial request. The request will contain the following form data:

Key Description Example
email Work email addres found (if any) "[email protected]"
status The status of the lookup attempt. It could return either:
email_found - For which we found a work email address.
email_not_found - For which we did not find a work email address.
"email_found"

Personal Contact Number Lookup Endpoint

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

Cost: 1 credit / contact number returned.

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

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

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

URL Parameters

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

Response

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

Personal Email Lookup Endpoint

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

Cost: 1 credit / email returned.

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

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

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

URL Parameters

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

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

Response

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

Disposable Email Address Check Endpoint

GET /proxycurl/api/disposable-email

Cost: 0 credit / request.

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

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

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

URL Parameters

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

Response

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

People API

Person Lookup Endpoint

GET /proxycurl/api/linkedin/profile/resolve

Cost: 2 credits / successful request.

Resolve LinkedIn Profile

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

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

URL Parameters

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

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

Response

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

Remarks

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

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 \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/linkedin/person/profile-picture?linkedin_person_profile_url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fwilliamhgates%2F'
import requests

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

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": "http://localhost:4566/proxycurl-web-dev/person/williamhgates/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20220912%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20220912T065816Z\u0026X-Amz-Expires=1800\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=90c8940f41a287bec0492da96a1f331e49fdbb81d08aeff0d7f251fdff90facd"
}
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.
"http://localhost:4566/proxycurl-web-dev/person/williamhgates/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20220912%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20220912T065816Z\u0026X-Amz-Expires=1800\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=90c8940f41a287bec0492da96a1f331e49fdbb81d08aeff0d7f251fdff90facd"

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 \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/find/company/role?role=ceo&company_name=nubela'
import requests

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

URL Parameters

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

Response

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

Person Profile Endpoint

GET /proxycurl/api/v2/linkedin

Cost: 1 credit / successful request.

Get structured data of a Personal Profile

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

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

URL Parameters

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

URL should be in the format of https://www.linkedin.com/in/<public-identifier>
https://www.linkedin.com/in/johnrmarty/
fallback_to_cache yes Tweaks the fallback behavior if an error arises from fetching a fresh profile.

This parameter accepts the following values:
* on-error (default value) - Fallback to reading the profile from cache if an error arises.
* never - Do not ever read profile from cache.
on-error
use_cache no if-present The default behavior. Fetches profile from cache regardless of age of profile. If profile is not available in cache, API will attempt to source profile externally.

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

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

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

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

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

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

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

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

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

Response

{
    "accomplishment_courses": [],
    "accomplishment_honors_awards": [],
    "accomplishment_organisations": [],
    "accomplishment_patents": [],
    "accomplishment_projects": [
        {
            "description": "gMessenger was built using Ruby on Rails, and the Bootstrap HTML, CSS, and JavaScript framework. It uses a Websocket-Rails integration to post a user\u0027s message content to the page in real time, with no page refresh required. gMessenger also includes custom authentication with three different permissions levels.",
            "ends_at": 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": "http://localhost:4566/proxycurl-web-dev/person/johnrmarty/cover?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20221124%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20221124T040239Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=2f924408d6c19d5d887821d023f90b1b3d18f54280cd730bde8551cac359a3a7",
    "birth_date": null,
    "certifications": [
        {
            "authority": "Scaled Agile, Inc.",
            "display_source": null,
            "ends_at": null,
            "license_number": null,
            "name": "SAFe Agile Framework Practitioner - ( Scrum, XP, and Lean Practices in the SAFe Enterprise)",
            "starts_at": null,
            "url": null
        },
        {
            "authority": "Scrum Alliance",
            "display_source": null,
            "ends_at": null,
            "license_number": null,
            "name": "SCRUM Alliance Certified Product Owner",
            "starts_at": null,
            "url": null
        },
        {
            "authority": "Scaled Agile, Inc.",
            "display_source": null,
            "ends_at": null,
            "license_number": null,
            "name": "Scaled Agile Framework PM/PO",
            "starts_at": null,
            "url": null
        }
    ],
    "city": "Seattle",
    "connections": 500,
    "country": "US",
    "country_full_name": "United States of America",
    "education": [
        {
            "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-exp1.licdn.com/dms/image/D560BAQFIQU2Fhi-sog/company-logo_100_100/0/1666575424135?e=2147483647\u0026v=beta\u0026t=V1vNuA0I5gbAG9BWL40UJf1HgN2y7mBxSeJ_uSaJSSc",
            "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-exp1.licdn.com/dms/image/C4E0BAQG1D1RHEvbQZQ/company-logo_100_100/0/1519872735270?e=2147483647\u0026v=beta\u0026t=ww_R6rRsCb2M_xkEta5ynMn6VxkUt1XwOhVEtLZXSfA",
            "school": "Galvanize Inc",
            "school_linkedin_profile_url": "https://www.linkedin.com/school/galvanize-it/",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2015
            }
        },
        {
            "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-exp1.licdn.com/dms/image/C4D0BAQGs5hZ3ROf-iw/company-logo_100_100/0/1519856111543?e=2147483647\u0026v=beta\u0026t=62k4mEoRdeQf4C6AF12Z05_t6i1VgNk50jr7RHkEsf8",
            "school": "Fort Lewis College",
            "school_linkedin_profile_url": "https://www.linkedin.com/school/fort-lewis-college/",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 1999
            }
        },
        {
            "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-exp1.licdn.com/dms/image/C560BAQEYxazZM_hXgQ/company-logo_100_100/0/1634934418976?e=2147483647\u0026v=beta\u0026t=wI0YdMmxIctkzvnKxRfuAbT8h5eok_DlUqEph68J37s",
            "starts_at": {
                "day": 1,
                "month": 8,
                "year": 2021
            },
            "title": "Co-Founder"
        },
        {
            "company": "Mindset Reset Podcast",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/mindset-reset-podcast",
            "description": "We dive into the mindsets of the world\u2019s foremost thought leaders and turn them into actionable insights so that others can discover greater happiness, success, and fulfillment.\n\nhttps://podcasts.apple.com/us/podcast/mindset-reset/id1553212607",
            "ends_at": null,
            "location": "Denver, Colorado, United States",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQF9QJVQm3SOvA/company-logo_100_100/0/1614527476576?e=2147483647\u0026v=beta\u0026t=m3tx83nMN-E3XQFoJG0Wmch8U4qKnJ9i--5NSAfffC0",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2021
            },
            "title": "Founder"
        },
        {
            "company": "Product School",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/product-school",
            "description": "Product School is a global leader in Product Management training with a community of over one million product professionals. As a featured speaker, I help inspire the next generation of Product Managers to create innovative products and apply best practices in their work.",
            "ends_at": {
                "day": 31,
                "month": 12,
                "year": 2020
            },
            "location": "Seattle, Washington, United States",
            "logo_url": "https://media-exp1.licdn.com/dms/image/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-exp1.licdn.com/dms/image/C560BAQFG_MrwBC_iZg/company-logo_100_100/0/1594610187483?e=2147483647\u0026v=beta\u0026t=7NNWG1ZclbNsUW0k0PuD-v5xTmfpIcthOmHCDyMwWMk",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2020
            },
            "title": "Founder"
        },
        {
            "company": "Amazon",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/amazon",
            "description": null,
            "ends_at": {
                "day": 31,
                "month": 3,
                "year": 2021
            },
            "location": "Greater Seattle Area",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQHTvZwCx4p2Qg/company-logo_100_100/0/1612205615891?e=2147483647\u0026v=beta\u0026t=PG9v_TmuSDxc9nAjnwxAFTWfFwhri5iJcJ4bcODhtPA",
            "starts_at": {
                "day": 1,
                "month": 2,
                "year": 2019
            },
            "title": "Sr. Product Manager - New Business Innovation"
        },
        {
            "company": "Amazon",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/amazon",
            "description": null,
            "ends_at": {
                "day": 28,
                "month": 2,
                "year": 2019
            },
            "location": "Seattle, Washington, United States",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQHTvZwCx4p2Qg/company-logo_100_100/0/1612205615891?e=2147483647\u0026v=beta\u0026t=PG9v_TmuSDxc9nAjnwxAFTWfFwhri5iJcJ4bcODhtPA",
            "starts_at": {
                "day": 1,
                "month": 3,
                "year": 2017
            },
            "title": "Senior Manager of Product Management - Marketplace Product Quality"
        },
        {
            "company": "YouTube",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/youtube",
            "description": "Mission: to help others land their dream jobs at a top tech companies that aligns with their passions.",
            "ends_at": null,
            "location": "Greater Seattle Area",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C4D0BAQEfoRsyU4yUzg/company-logo_100_100/0/1631053379295?e=2147483647\u0026v=beta\u0026t=CmnUj5LeO5Yi-nA9xLgEYBPU5eZdLrPBG2qXmPhhoe4",
            "starts_at": {
                "day": 1,
                "month": 2,
                "year": 2019
            },
            "title": "YouTube Content Creator - \"Tech Careers for Non-Engineers\""
        },
        {
            "company": "YouTube",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/youtube",
            "description": null,
            "ends_at": null,
            "location": "Seattle, Washington",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C4D0BAQEfoRsyU4yUzg/company-logo_100_100/0/1631053379295?e=2147483647\u0026v=beta\u0026t=CmnUj5LeO5Yi-nA9xLgEYBPU5eZdLrPBG2qXmPhhoe4",
            "starts_at": {
                "day": 1,
                "month": 1,
                "year": 2017
            },
            "title": "Youtube Content Creator - \"John Marty\""
        },
        {
            "company": "American Express",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/american-express",
            "description": null,
            "ends_at": {
                "day": 31,
                "month": 3,
                "year": 2017
            },
            "location": "Phoenix, Arizona Area",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C4D0BAQGRhsociEn4gQ/company-logo_100_100/0/1523269243842?e=2147483647\u0026v=beta\u0026t=SHRbiG3uqsCTfE1Gyd77tgJWtHAm4cYp-c6uILKTVNs",
            "starts_at": {
                "day": 1,
                "month": 7,
                "year": 2015
            },
            "title": "Senior Global Product Manager"
        },
        {
            "company": "Mile High Automation, Inc.",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/mile-high-automation-inc-",
            "description": "Mile High Automation is a Smart Home Technology (Internet of Things) software and hardware development company. Our mission is to flawlessly develop and deliver impeccable software, hardware and system design for the high-end consumer market nationally and internationally. \n\n\u2022  Performed a short term change management engagement to lead a 12 member cross functional team through a major strategy and vision transition\n\u2022  Developed an international supply chain that increased profit margin by 30% on core products\n\u2022  Conceptualized, implemented, and rolled out a CRM that led to a 15% higher month over month close rate; trained sales team on newly created key performance indicators to maximize growth\n\u2022  Developed, implemented and oversaw a training process that scaled to 180+ national subcontractors\n\u2022  Translated user stories into detailed product requirements documents that the software development team used to build new features and functionality \n\u2022  Developed benchmarks for customer service, sales, and traffic conversion to maximize profit",
            "ends_at": {
                "day": 31,
                "month": 7,
                "year": 2014
            },
            "location": "Denver Colorado",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C4E0BAQHofg3toK4P7A/company-logo_100_100/0/1519903210468?e=2147483647\u0026v=beta\u0026t=vasirOnrmfFkQru9S8JBNtci00COt_s9x2AOexxqd-8",
            "starts_at": {
                "day": 1,
                "month": 3,
                "year": 2014
            },
            "title": "Sr. Product Manager"
        },
        {
            "company": "EOS Controls",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/eos-controls",
            "description": "A Smart Home Technology (Internet of Things) software and hardware development company specializing in the mid to high-end condominium market in the United States and South America. \nEOS Controls supports the advancement of affordable and easy to user smart home technology through a network of non-traditional sales channels of architects, designers, and contractors. \n\n\u2022  Coordinated engineering, design, and marketing strategy for the launch of 6 iOS apps\n\u2022  Led a 5 member product team of engineers; conducted daily stand-ups and weekly design review meetings\n\u2022  Managed and prioritized product backlog for development Sprints as well as tested products before release\n\u2022  Effectively placed products through non-traditional distribution channels by identifying and developing relationships with over 100 national and international builders, architects, and designers",
            "ends_at": {
                "day": 31,
                "month": 5,
                "year": 2014
            },
            "location": "Miami, Florida",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQFV1hvbuwyU-A/company-logo_100_100/0/1519867781218?e=2147483647\u0026v=beta\u0026t=s5UGQj-N-5VatokXj3YN6IxOPmKpUZeetC5OZH-B-xU",
            "starts_at": {
                "day": 1,
                "month": 2,
                "year": 2012
            },
            "title": "Founder/ Chief Operating Officer"
        },
        {
            "company": "Axxis Audio",
            "company_linkedin_profile_url": "https://www.linkedin.com/company/axxis-audio",
            "description": "Specializing in Smart Home Technology - Home Automation, Internet of Things\n\n\u2022  Raised $10,000 in investment to develop a home theater and home automation sales and installation business that grew to multi-million dollar sales (sold the company in 2011)\n\u2022  Developed mission-centric training, responsibility, and accountability framework \n\u2022  10 Direct Reports\n\u2022  Responsible for resource planning, scheduling, and project management \n\u2022  Filled the role of HR and developed a team building program for 10 direct reports, that included formal training, personal and professional peer support, mentoring and professional development; resulting in 20% higher retention rate and improved trust and communication\n\u2022  Deployed an ERP Solution in 2007 that unified 5 departments and provided a central reporting and accountability framework for a 23% employees productivity gain\n\u2022  Handled acquisition of 2nd largest competitor Cobalt Automation",
            "ends_at": {
                "day": 31,
                "month": 1,
                "year": 2012
            },
            "location": "Durango Colorado",
            "logo_url": "https://media-exp1.licdn.com/dms/image/C560BAQHI-DLifzJs9Q/company-logo_100_100/0/1519868629336?e=2147483647\u0026v=beta\u0026t=l1Sk5NQO2Mtpo7HpppRkMhogjVXCwx5yxIxhcwUpNuc",
            "starts_at": {
                "day": 1,
                "month": 11,
                "year": 2002
            },
            "title": "President/Founder"
        }
    ],
    "extra": {
        "facebook_profile_id": null,
        "github_profile_id": null,
        "twitter_profile_id": null
    },
    "first_name": "John",
    "full_name": "John Marty",
    "gender": null,
    "groups": [],
    "headline": "Financial Freedom through Real Estate - LinkedIn Top Voice",
    "industry": null,
    "inferred_salary": {
        "max": null,
        "min": null
    },
    "interests": [],
    "languages": [
        "English",
        "Spanish",
        "Japanese"
    ],
    "last_name": "Marty",
    "occupation": "Co-Founder at Freedom Fund Real Estate",
    "people_also_viewed": [],
    "personal_emails": [],
    "personal_numbers": [],
    "profile_pic_url": "http://localhost:4566/proxycurl-web-dev/person/johnrmarty/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20221124%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20221124T040239Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=e35ca0faf6a0909b64d3fe956f5aa1776659974ae3468558af12aa87a793c973",
    "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/johntmarty",
            "location": "Portland, OR",
            "name": "John Marty",
            "summary": "Director - Brand Finance"
        },
        {
            "link": "https://www.linkedin.com/in/johnmarty",
            "location": "Orlando, FL",
            "name": "John Marty",
            "summary": "Lead Software Engineer, Commerce at Disney Parks  \u0026 Resorts Digital"
        }
    ],
    "skills": [],
    "state": "Washington",
    "summary": "Most people go through life lost, disengaged, and unhappy at work and in their lives - I\u0027m on a mission to solve that.\n\nI spent 10 years as the founder of Axxis Audio, an electronics company that grew to multi-million dollar sales, which I sold in 2012. At that time, I funneled my earnings into the creation of an Internet of Things company, but numerous factors lead to its demise after 2 hard fought years. \n\nAt 31, I was penny-less, had a baby on the way, and had zero job prospects (despite applying to 150 companies). My desperate situation led me to take a job at Best Buy for $12 an hour while reinventing myself through the completion of an MBA at the University of Colorado, and a 6-month software development boot camp. \n\nAfter graduation, I landed at American Express as a Senior Product Manager and then got poached by Amazon in 2017 (because of my LinkedIn profile). My journey has led to a deep sense of perspective, humility, and purpose that I draw on to help others find clarity, meaning, and happiness in their careers and lives. \n\nCheck out my website for details on my Mindset Reset Podcast, Public Speaking, Consulting, or my free 40 page LinkedIn guide\n\nhttp://www.johnraphaelmarty.com/\n\nFAQ\u0027s\n\nQ: Can you speak at my Company, University, event or podcast?\nA: I\u0027d love to! I\u0027ve shared my message on the future of employment, breaking into big tech, and my personal story of reinventing myself and discovering my sense of purpose (and how you can too!).\n\n\u2611\ufe0f  YouTube Channel #1 (John Marty) : http://www.youtube.com/c/JohnMarty-uncommon\n\u2611\ufe0f  YouTube Channel #2 (Tech Careers for non-engineers: https://www.youtube.com/channel/UC900gMMPLwRGGXSTW1gdZHA\n\nFUN FACTS:\n\u2611\ufe0f I am an Avid cyclist and runner, and I just started learning to skateboard a half-pipe.\n\u2611\ufe0f Into the Enneagram? - I\u0027m a #3 (The Achiever)\n\nLETS CONNECT:\n\u2611\ufe0f Email: [email protected] (don\u0027t forget that \"R\"....The other guy gets my emails all the time)",
    "volunteer_work": []
}
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.
"http://localhost:4566/proxycurl-web-dev/person/johnrmarty/profile?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20221124%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20221124T040239Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=e35ca0faf6a0909b64d3fe956f5aa1776659974ae3468558af12aa87a793c973"
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. "http://localhost:4566/proxycurl-web-dev/person/johnrmarty/cover?X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=%2F20221124%2F%2Fs3%2Faws4_request\u0026X-Amz-Date=20221124T040239Z\u0026X-Amz-Expires=3600\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=2f924408d6c19d5d887821d023f90b1b3d18f54280cd730bde8551cac359a3a7"
first_name First name of the user. "John"
last_name Last name of the user. "Marty"
full_name Full name of the user (first_name + last_name) "John Marty"
occupation The title and company name of the user's current employment. "Co-Founder at Freedom Fund Real Estate"
headline The tagline written by the user for his profile. "Financial Freedom through Real Estate - LinkedIn Top Voice"
summary A blurb (longer than the tagline) written by the user for his profile. "Most people go through life lost, disengaged, and unhappy at work and in their lives - I\u0027m on a mission to solve that.\n\nI spent 10 years as the founder of Axxis Audio, an electronics company that grew to multi-million dollar sales, which I sold in 2012. At that time, I funneled my earnings into the creation of an Internet of Things company, but numerous factors lead to its demise after 2 hard fought years. \n\nAt 31, I was penny-less, had a baby on the way, and had zero job prospects (despite applying to 150 companies). My desperate situation led me to take a job at Best Buy for $12 an hour while reinventing myself through the completion of an MBA at the University of Colorado, and a 6-month software development boot camp. \n\nAfter graduation, I landed at American Express as a Senior Product Manager and then got poached by Amazon in 2017 (because of my LinkedIn profile). My journey has led to a deep sense of perspective, humility, and purpose that I draw on to help others find clarity, meaning, and happiness in their careers and lives. \n\nCheck out my website for details on my Mindset Reset Podcast, Public Speaking, Consulting, or my free 40 page LinkedIn guide\n\nhttp://www.johnraphaelmarty.com/\n\nFAQ\u0027s\n\nQ: Can you speak at my Company, University, event or podcast?\nA: I\u0027d love to! I\u0027ve shared my message on the future of employment, breaking into big tech, and my personal story of reinventing myself and discovering my sense of purpose (and how you can too!).\n\n\u2611\ufe0f YouTube Channel #1 (John Marty) : http://www.youtube.com/c/JohnMarty-uncommon\n\u2611\ufe0f YouTube Channel #2 (Tech Careers for non-engineers: https://www.youtube.com/channel/UC900gMMPLwRGGXSTW1gdZHA\n\nFUN FACTS:\n\u2611\ufe0f I am an Avid cyclist and runner, and I just started learning to skateboard a half-pipe.\n\u2611\ufe0f Into the Enneagram? - I\u0027m a #3 (The Achiever)\n\nLETS CONNECT:\n\u2611\ufe0f Email: [email protected] (don\u0027t forget that \"R\"....The other guy gets my emails all the time)"
country The user's country of residence depicted by a 2-letter country code (ISO 3166-1 alpha-2). "US"
country_full_name The user's country of residence, in English words. "United States of America"
city The city that the user is living at. "Seattle"
state The state that the user is living at. "Washington"
experiences The user's list of historic work experiences. See Experience object
education The user's list of education background. See Education object
languages A list of languages that the user claims to be familiar with, and has added to his/her profile.

Do note that we do not have the proficiency level as that data point is not available on a public LinkedIn profile.
["English", "Spanish", "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
skills A list of keyword-based skills that this user boasts of on his LinkedIn profile. ["branding", "cad tools", "art"]
inferred_salary A salary range inferred from the user's current job title and company. See InferredSalary object
gender Gender of the user. "male"
birth_date Birth date of the user. See Date object
industry Industry that the user works in. "government administration"
interests A list of interests that the user has. ["education", "health", "human rights"]
extra A bundle of extra data on this user. See PersonExtra object
personal_emails A list of personal emails associated with this user. ["[email protected]", "[email protected]", "[email protected]@outlook.com"]
personal_numbers A list of personal mobile phone numbers associated with this user. ["+6512345678", "+6285123450953", "+6502300340"]

Experience

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

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

Date

Key Description Example
day 1
month 8
year 2021

Education

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

Date

Key Description Example
day 1
month 1
year 2013

AccomplishmentOrg

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

Date

Key Description Example
day 1
month 1
year 2012

Publication

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

Date

Key Description Example
day 1
month 1
year 1970

HonourAward

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

Date

Key Description Example
day 1
month 1
year 1970

Patent

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

Date

Key Description Example
day 1
month 1
year 1970

Course

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

Project

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

Date

Key Description Example
day 1
month 3
year 2015

TestScore

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

Date

Key Description Example
day 1
month 1
year 2010

Certification

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

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"

Date

Key Description Example
day 27
month 11
year 2019

PersonGroup

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

InferredSalary

Key Description Example
min 35000
max 45000

Date

Key Description Example
day 1
month 1
year 1990

PersonExtra

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

School API

Student Listing Endpoint

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

Cost: 3 credits / student returned.

Get a list of students of a school or university.

curl \
    -X GET \
    -H "Authorization: Bearer ${YOUR_API_KEY}" \
    'https://nubela.co/proxycurl/api/linkedin/school/students/?enrich_profiles=enrich&search_keyword=%28Computer%28.%2A%29%29&page_size=10&student_status=current&resolve_numeric_id=false&linkedin_school_url=https%3A%2F%2Fwww.linkedin.com%2Fschool%2Fstanford-university'
import requests

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

URL Parameters

Parameter Required Description Example
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 is a regular expression (regex).

(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(.*))
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 100.
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
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
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

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. [{"profile": null, "profile_url": "https://www.linkedin.com/in/minghowlogic"}, {"profile": null, "profile_url": "https://www.linkedin.com/in/zhengpingzhou"}]
next_page The API URI that will lead to the next page of results. null

School Profile Endpoint

GET /proxycurl/api/linkedin/school

Cost: 1 credit / successful request.

Get structured data of a LinkedIn School Profile

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

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

URL Parameters

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

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

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

Response

{
    "background_cover_image_url": "https://media-exp1.licdn.com/dms/image/C4D1BAQH9RnIm5udicQ/company-background_10000/0/1519796779731?e=1654585200\u0026v=beta\u0026t=OpKFclmBc0ERcn8EiRImFXJrsVmNXlXOD9JpJx5NJQA",
    "company_size": [
        5001,
        10000
    ],
    "company_size_on_linkedin": 15199,
    "company_type": "EDUCATIONAL_INSTITUTION",
    "description": "At NUS, we are shaping the future through our people and our pursuit of new frontiers in knowledge. In a single century, we have become a university of global influence and an Asian thought leader. Our location at the crossroads of Asia informs our mission and gives us a tremendous vantage point to help create opportunities and address the pressing issues facing Singapore, Asia and the world.\r\rAt NUS, we believe in education, research and service that change lives.",
    "follower_count": 470304,
    "founded_year": 1905,
    "hq": {
        "city": "Singapore",
        "country": "SG",
        "is_hq": true,
        "line_1": "21 Lower Kent Ridge Road, Singapore",
        "postal_code": "119077",
        "state": null
    },
    "industry": "Higher Education",
    "linkedin_internal_id": "5524",
    "locations": [
        {
            "city": "Singapore",
            "country": "SG",
            "is_hq": true,
            "line_1": "21 Lower Kent Ridge Road, Singapore",
            "postal_code": "119077",
            "state": null
        }
    ],
    "name": "National University of Singapore",
    "profile_pic_url": "https://media-exp1.licdn.com/dms/image/C4D0BAQGvBq9cz6AIIQ/company-logo_400_400/0/1519856127538?e=1661990400\u0026v=beta\u0026t=K6ND2NedE8iKNY9YKoQXhDCl773XebFKY0VbX-5sATA",
    "search_id": "5524",
    "similar_companies": [
        {
            "industry": "Education Management",
            "link": "https://www.linkedin.com/school/nus-business-school/",
            "location": null,
            "name": "NUS Business School"
        },
        {
            "industry": "Higher Education",
            "link": "https://www.linkedin.com/school/nusfass/",
            "location": null,
            "name": "NUS Faculty of Arts and Social Sciences"
        },
        {
            "industry": "Research",
            "link": "https://www.linkedin.com/company/solar-energy-research-institute-of-singapore-seris",
            "location": null,
            "name": "Solar Energy Research Institute of Singapore"
        },
        {
            "industry": "Higher Education",
            "link": "https://www.linkedin.com/school/duke-nus/",
            "location": null,
            "name": "Duke-NUS Medical School"
        },
        {
            "industry": "Professional Training \u0026 Coaching",
            "link": "https://www.linkedin.com/company/iss_nus",
            "location": null,
            "name": "Institute of Systems Science, National University of Singapore"
        },
        {
            "industry": "Higher Education",
            "link": "https://www.linkedin.com/company/nusfst",
            "location": null,
            "name": "NUS Department of Food Science and Technology"
        },
        {
            "industry": "Education Management",
            "link": "https://www.linkedin.com/company/centre-for-future-ready-graduates",
            "location": null,
            "name": "NUS Centre for Future-ready Graduates"
        }
    ],
    "specialities": [
        "education",
        "research",
        "broad-based curriculum",
        "cross-faculty enrichment"
    ],
    "tagline": null,
    "universal_name_id": "national-university-of-singapore",
    "updates": [],
    "website": "http://nus.edu.sg"
}
Key Description Example
linkedin_internal_id LinkedIn's Internal and immutable ID of this Company profile. "5524"
description "At NUS, we are shaping the future through our people and our pursuit of new frontiers in knowledge. In a single century, we have become a university of global influence and an Asian thought leader. Our location at the crossroads of Asia informs our mission and gives us a tremendous vantage point to help create opportunities and address the pressing issues facing Singapore, Asia and the world.\r\rAt NUS, we believe in education, research and service that change lives."
website "http://nus.edu.sg"
industry "Higher Education"
company_size Listed range of company head count [5001, 10000]
company_size_on_linkedin 15199
hq A CompanyLocation object See CompanyLocation object
company_type Possible values:

EDUCATIONAL: Educational Institution

GOVERNMENT_AGENCY: Government Agency

NON_PROFIT : Nonprofit

PARTNERSHIP : Partnership

PRIVATELY_HELD: Privately Held

PUBLIC_COMPANY: Public Company

SELF_EMPLOYED: Self-Employed

SELF_OWNED: Sole Proprietorship
"EDUCATIONAL_INSTITUTION"
founded_year 1905
specialities ["education", "research", "broad-based curriculum", "cross-faculty enrichment"]
locations List of CompanyLocation See CompanyLocation object
name "National University of Singapore"
tagline "Think Different - But Not Too Different"
universal_name_id "national-university-of-singapore"
profile_pic_url "https://media-exp1.licdn.com/dms/image/C4D0BAQGvBq9cz6AIIQ/company-logo_400_400/0/1519856127538?e=1661990400\u0026v=beta\u0026t=K6ND2NedE8iKNY9YKoQXhDCl773XebFKY0VbX-5sATA"
background_cover_image_url "https://media-exp1.licdn.com/dms/image/C4D1BAQH9RnIm5udicQ/company-background_10000/0/1519796779731?e=1654585200\u0026v=beta\u0026t=OpKFclmBc0ERcn8EiRImFXJrsVmNXlXOD9JpJx5NJQA"
search_id Useable with Job listing endpoint "5524"
similar_companies List of SimilarCompany See SimilarCompany object
updates List of CompanyUpdate See CompanyUpdate object
follower_count 470304

CompanyLocation

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

SimilarCompany

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

CompanyUpdate

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

Date

Key Description Example
day 30
month 9
year 2021

Reveal API

Reveal Endpoint

GET /proxycurl/api/reveal/company

Cost: 2 credits / successful request. (No credits will be charged if the supplied IP is a known residential IP address)

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

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

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

URL Parameters

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

Response

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

Meta API

View Credit Balance Endpoint

GET /proxycurl/api/credit-balance

Cost: 0 credit / successful request.

Get your current credit(s) balance

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

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

Response

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