Endpoints
V2 endpoints
Search Network V2 POST
The Search endpoint facilitates searching for profiles within the profile database based on their attributes. Utilizing OpenSearch as the underlying database technology, this endpoint accepts requests with OpenSearch domain-specific language (DSL), enabling powerful and flexible search queries.
See OpenSearch Mapping for the Search endpoint.
Search returns 1000 results per page.
Example Usage
Note: Replace "query"
with your OpenSearch DSL query defining the search criteria. The response will contain a list of profile IDs matching the search criteria, that can be later used in the Fetch endpoint
For more examples, refer to Examples.
Pagination
When making requests to the Search endpoint, pagination can be utilized to retrieve large sets of search results efficiently. As shown in the above API response, it will contain a pagination token that should be used in subsequent requests to fetch the next page of results.
Below is an example query that will query the next 5 records using the pagination token:
Fetch Profile V2 POST
The Fetch endpoint within the API facilitates the retrieval of specific profiles from the database based on their unique identifiers (profile IDs or LinkedIn usernames). This endpoint is designed to provide detailed information about individual profiles stored in the database, allowing users to access profile connections, lists, notes, and tags.
Example Usage
By default, the response contains the profile connections or team members that are connected to the profile. The API user may specify additional data about the profile in the fields
object that accepts the following values:
Mind that
investorData
is no longer allowed in the list of fields to fetch.investor_data
form now on is nested in theprofile_info
. More details in Models > Profile.
connections | List of team members who are connected to the given profile. The connection details are included (see Models > Profile) |
tags | Tags assigned to the profile |
lists | Lists the profile is assigned to |
notes | List of notes assigned to the profile. Private notes are not included. |
profile_info | Detailed profile data, e.g. work experience, education, etc. |
To see a full response of the Fetch endpoint see Models > Profile
V1 endpoints (to be sunset soon)
Search Network POST
The Search endpoint facilitates searching for profiles within the profile database based on their attributes. Utilizing OpenSearch as the underlying database technology, this endpoint accepts requests with OpenSearch domain-specific language (DSL), enabling powerful and flexible search queries.
See OpenSearch Mapping for the Search endpoint.
Search returns 1000 results per page.
Example usage
Note: Replace "query"
with your OpenSearch DSL query defining the search criteria. The response will contain a list of profile IDs matching the search criteria, that can be later used in the Fetch endpoint
For more examples, refer to Examples.
Fetch Profile POST
The Fetch endpoint within the API facilitates the retrieval of specific profiles from the database based on their unique identifiers (profile IDs or LinkedIn usernames). This endpoint is designed to provide detailed information about individual profiles stored in the database, allowing users to access profile connections, lists, notes, and tags.
Example Usage
By default, the response contains the profile connections or team members that are connected to the profile. The API user may specify additional data about the profile in the fields
object that accepts the following values:
connections | List of team members who are connected to the given profile. The connection details are included (see Models > Profile) |
tags | Tags assigned to the profile |
lists | Lists the profile is assigned to |
notes | List of notes assigned to the profile. Private notes are not included. |
profileInfo | Detailed profile data, e.g. work experience, education, etc. |
investorData | The investor data of the profile |
To see a full response of the Fetch endpoint see Models > Profile