PEpeopledatalabs
Company Endpoints

/company/enrich

Changed on
get/v5/company/enrich

Request

Query parameters

pdl_idstring

The PDL ID of the company to enrich.

namestring

The name of the company.

profilestring

A social profile of the company (linkedin/facebook/twitter/crunchbase).

tickerstring

The company's stock ticker, if publicly traded.

websitestring

A website the company uses.

locationstring

The location of the company's headquarters. This can be anything from a street address to a country name.

street_addressstring

The company HQ's street address.

localitystring

The company HQ's locality. e.g. San Francisco

regionstring

The company HQ's region. e.g. California

countrystring

The company HQ's country.

postal_codestring

The company HQ's postal code.

prettyboolean

Whether the output should have human-readable indentation.

titlecaseboolean

All text in API responses returns as lowercase by default. Setting titlecase to true will titlecase response data instead.

include_if_matchedboolean

If true, the response will include the top-level field matched that contains a list of every input that matched this profile.

min_likelihoodinteger

The minimum likelihood score a response must possess in order to return a 200.

requiredstring
Example:location AND (website OR linkedin_url)

The fields a response must have in order to count as a match.

Headers

Content-Type'application/json'

The content type

Response

Company Found

affiliated_profilesstring[]

A list of company IDs that PDL has flagged as being affiliated and having an association to this company (either parent or child)

alternative_namesstring[]

The list of names associated with this company filtered to ensure data quality

employee_countinteger

The current integer number of employees working at the company.

facebook_urlstring

Primary company facebook

foundedinteger

The founded year of the company

headlinestring

The company's 'headline' summary

idstring

PDL company ID. This is currently non-persistent and generated from the company's primary linkedin username

industry'accounting' | 'airlines/aviation' | 'alternative dispute resolution' | 'alternative medicine' | 'animation' | 'apparel & fashion' | 'architecture & planning' | 'arts and crafts' | 'automotive' | 'aviation & aerospace' | 'banking' | 'biotechnology' | 'broadcast media' | 'building materials' | 'business supplies and equipment' | 'capital markets' | 'chemicals' | 'civic & social organization' | 'civil engineering' | 'commercial real estate' | 'computer & network security' | 'computer games' | 'computer hardware' | 'computer networking' | 'computer software' | 'construction' | 'consumer electronics' | 'consumer goods' | 'consumer services' | 'cosmetics' | 'dairy' | 'defense & space' | 'design' | 'e-learning' | 'education management' | 'electrical/electronic manufacturing' | 'entertainment' | 'environmental services' | 'events services' | 'executive office' | 'facilities services' | 'farming' | 'financial services' | 'fine art' | 'fishery' | 'food & beverages' | 'food production' | 'fund-raising' | 'furniture' | 'gambling & casinos' | 'glass, ceramics, & concrete' | 'government administration' | 'government relations' | 'graphic design' | 'health, wellness and fitness' | 'higher education' | 'hospital & health care' | 'hospitality' | 'human resources' | 'import and export' | 'individual & family services' | 'industrial automation' | 'information services' | 'information technology and services' | 'insurance' | 'international affairs' | 'international trade and development' | 'internet' | 'investment banking' | 'investment management' | 'judiciary' | 'law enforcement' | 'law practice' | 'legal services' | 'legislative office' | 'leisure, travel, & tourism' | 'libraries' | 'logistics and supply chain' | 'luxury goods & jewelry' | 'machinery' | 'management consulting' | 'maritime' | 'market research' | 'marketing and advertising' | 'mechanical or industrial engineering' | 'media production' | 'medical devices' | 'medical practice' | 'mental health care' | 'military' | 'mining & metals' | 'motion pictures and film' | 'museums and institutions' | 'music' | 'nanotechnology' | 'newspapers' | 'non-profit organization management' | 'oil & energy' | 'online media' | 'outsourcing/offshoring' | 'package/freight delivery' | 'packaging and containers' | 'paper & forest products' | 'performing arts' | 'pharmaceuticals' | 'philanthropy' | 'photography' | 'plastics' | 'political organization' | 'primary/secondary education' | 'printing' | 'professional training & coaching' | 'program development' | 'public policy' | 'public relations and communications' | 'public safety' | 'publishing' | 'railroad manufacture' | 'ranching' | 'real estate' | 'recreational facilities and services' | 'religious institutions' | 'renewables & environment' | 'research' | 'restaurants' | 'retail' | 'security and investigations' | 'semiconductors' | 'shipbuilding' | 'sporting goods' | 'sports' | 'staffing and recruiting' | 'supermarkets' | 'telecommunications' | 'textiles' | 'think tanks' | 'tobacco' | 'translation and localization' | 'transportation/trucking/railroad' | 'utilities' | 'venture capital & private equity' | 'veterinary' | 'warehousing' | 'wholesale' | 'wine and spirits' | 'wireless' | 'writing and editing'

Self reported industry -- the enum is from linkedin's standard industries

linkedin_idstring

Primary company linkedin ID

linkedin_urlstring

Primary company linkedin url

namestring

The company's main common name

profilesstring[]

A list of all profiles associated with the company

size'1-10' | '11-50' | '51-200' | '201-500' | '501-1000' | '1001-5000' | '5001-10000' | '10001+'

A range representing the number of people working at the company

summarystring

Company description

tagsstring[]

Tags associated with the company

tickerstring

Company Ticker, (only for public companies)

twitter_urlstring

Primary company twitter url

type'educational' | 'government' | 'nonprofit' | 'private' | 'public'

The type of the company

websitestring

Primary company website

Changes

  • e479e570df32Revision changes
    • info

      added the new optional query request parameter country

    • info

      added the new optional query request parameter include_if_matched

    • info

      added the new optional query request parameter locality

    • info

      added the new optional query request parameter location

    • info

      added the new optional query request parameter min_likelihood

    • info

      added the new optional query request parameter postal_code

    • info

      added the new optional query request parameter region

    • info

      added the new optional query request parameter required

    • info

      added the new optional query request parameter street_address

    • info

      added the new optional query request parameter ticker

    • info

      added the new optional query request parameter titlecase