Multi-source Company API

Overview

This section covers basic information on the Multi-source Company API. To learn more about the API and its endpoints, follow the links below:

Multi-source Company API endpoints

Request types

Rate limits

Credits

Multi-source Company API endpoints

Our API is a data retrieval tool. The endpoints do not support analytic features.

Multi-source Company API features two search and three collect endpoints for searching and collecting relevant Multi-source Company data.

Request type	Endpoint	Function
POST	/v2/company_multi_source/search/es_dsl	Search for relevant company data using Elasticsearch DSL schema
POST	/v2/company_multi_source/search/es_dsl/preview	Retrieves a small set of partial data using Elasticsearch queries
GET	/v2/company_multi_source/collect/{company_id}	Collect Multi-source company data using IDs
GET	/v2/company_multi_source/collect/{profile_url/shorthand_name}	Collect Multi-source Company data using profile URLs or shorthand names*
GET	/v2/company_multi_source/enrich?website={URL}	Collect Multi-source company data using website URLs

*📌 Full profile URL example: www.professional-network.com/company/example-company. Shorthand name example: example-company.

Bulk Collect

Bulk Collect (Bulk API) expands upon Multi-source Company API's functionality, featuring two POST and two GET endpoints. Bulk Collect allows you to search and collect company data in bulk using company IDs and Elasticsearch DSL queries.

Request type	Endpoint
POST	/v2/data_requests/company_multi_source/ids
POST	/v2/data_requests/company_multi_source/es_dsl
GET	/v2/data_requests/{data_request_id}/files
GET	/v2/data_requests/{data_request_id}/files/{file_name}

Request types

All Multi-source Company API requests must be made over HTTPS. Requests made over HTTP will fail or be redirected to HTTPS.

Multi-source Company API supports two types of requests:

• Search endpoints support POST requests only.

• Collect endpoints support the GET requests only.

Request type	Endpoint
POST	/v2/company_multi_source/search/es_dsl
POST	/v2/company_multi_source/search/es_dsl/preview
GET	/v2/company_multi_source/collect/{company_id}
GET	/v2/company_multi_source/collect/{profile_url/shorthand_name}
GET	/v2/company_multi_source/enrich?website={URL}

Rate limits

Multi-source Company API endpoints restrict the number of requests allowed per second.

Search endpoints

Enrichment endpoints

Bulk Collect search and collection endpoints

Collection endpoints

18 requests per second

18 requests per second

27 requests per second

54 requests per second

Credits

Two search credits are deducted for one successful (200) request in the search endpoint:

• /v2/company_multi_source/search/es_dsl

• /v2/company_multi_source/search/es_dsl/preview

Two collection credits are deducted for one successful (200) request in the collection endpoints:

• /v2/company_multi_source/collect/{company_id}

• /v2/company_multi_source/collect/{profile_url/shorthand_name}

• /v2/company_multi_source/enrich?website={URL}

---

Read more about credits in the following topic:

General information about credits