Collect

7min

Overview
Find instructions for collection endpoint usage and data collection. 
Use the Base Employee collection endpoints to collect employee data using employee IDs or shorthand names. 
﻿Data collection using IDs﻿ 
Learn how to obtain company data using IDs. 
﻿Data collection using shorthand names﻿  
Learn how to obtain company data using shorthand names.
Used key
Collect endpoints
Employee ID
/v1/professional_network/employee_base/collect/{employee_id}
Shorthand name
/v1/professional_network/employee_base/collect/{shorthand_name}
Employee ID
Retrieved using Base Employee API search endpoints.
Employee shorthand name
Taken directly from profile URL (e.g., john-doe from www.professional_network.com/in/john-doe).
﻿
Other tutorials/helpful information for you to check before using the Base Employee API collection endpoints: 
﻿Base Employee API Elasticsearch schema﻿ 
﻿Base Employee API dictionary﻿ 
﻿Base Employee API sample﻿ 
Collection using IDs
Examples in this article are prepared using Postman. 
However, you can use the most convenient tool for you: terminal, Postman, or any API-compatible application.
﻿Response Codes﻿ 
See the list of possible error codes. 
Remember to replace {JWT} with the personal token that was generated for you.
Paste in the numeric profile ID instead of {employee_id} and your JWT token instead of {JWT} in the request template:
cURL request example
curl -X 'GET' \
'https://api.coresignal.com/cdapi/v1/professional_network/employee_base/collect/{employee_id}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {JWT}'
curl -X 'GET' \
'https://api.coresignal.com/cdapi/v1/professional_network/employee_base/collect/{employee_id}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {JWT}'
﻿
Copy the edited request.
Import the request in Postman by clicking the Import button and pasting the request in:
﻿
Click Authorization:
﻿
Select the Bearer token from the selection menu:
﻿
Make sure your JWT token has been imported to Postman:
﻿
Send the request
Collect profile data from Body:
﻿
Collection using shorthand names
Examples in this article are prepared using Postman. 
However, you can use the most convenient tool for you: terminal, Postman, or any API-compatible application.
﻿Response Codes﻿ 
See the list of possible error codes. 
Remember to replace {JWT} with the personal token that was generated for you.
Paste in the selected employee shorthand name instead of {shorthand_name} and your JWT token instead of {JWT} in the request template:
cURL request example
curl -X GET "https://api.coresignal.com/cdapi/v1/professional_network/employee_base/collect/{shorthand_name}"
 -H  "accept: application/json" 
 -H  "Authorization: Bearer {JWT}"
curl -X GET "https://api.coresignal.com/cdapi/v1/professional_network/employee_base/collect/{shorthand_name}"
 -H  "accept: application/json" 
 -H  "Authorization: Bearer {JWT}"
﻿
Copy the edited request.
Import the request in Postman by clicking the Import button and pasting the request in:
﻿
Click Authorization:
﻿
Select Bearer token and paste your token in:
﻿
Make sure your JWT token has been imported to Postman. 
﻿
Send the request:
﻿
Collect profile data from Body.
﻿

Used key	Collect endpoints
Employee ID	/v1/professional_network/employee_base/collect/{employee_id}
Shorthand name	/v1/professional_network/employee_base/collect/{shorthand_name}