Fetch Profile
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.
curl --request POST \
--url https://bee.theswarm.com/v2/profiles/fetch \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{
"ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"fields": [
"profile_info"
]
}'
{
"results": [
{
"id": "<string>",
"connections": [
{
"userId": "<string>",
"userEmail": "<string>",
"userLinkedinName": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"sources": [
{
"origin": "<string>",
"network": "<string>"
}
],
"connectionStrength": 123,
"manualStrength": 123,
"strengthNormalized": 123
}
],
"lists": [
{
"id": "<string>",
"name": "<string>",
"status": "<string>"
}
],
"notes": [
{
"id": "<string>",
"content": "<string>"
}
],
"tags": [
{
"id": "<string>",
"name": "<string>"
}
],
"profileInfo": {
"id": "<string>",
"fullName": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"linkedinUrl": "<string>",
"workEmail": "<string>",
"personalEmails": [
"<string>"
],
"industry": "<string>",
"jobTitle": "<string>",
"jobTitleRole": "<string>",
"jobSeniority": [
"<string>"
],
"jobCompanyId": "<string>",
"jobCompanyName": "<string>",
"jobCompanyLogoUrl": "<string>",
"jobCompanyWebsite": "<string>",
"jobCompanySize": {
"min": 123,
"max": 123
},
"jobCompanyIndustry": "<string>",
"jobCompanyLocationName": "<string>",
"jobCompanyLinkedinUrl": "<string>",
"experience": [
{
"isPrimary": true,
"companyId": "<string>",
"company": {
"id": "<string>",
"canonicalName": "<string>",
"name": "<string>",
"founded": "2023-11-07T05:31:56Z",
"industry": "<string>",
"website": "<string>",
"size": {
"min": 123,
"max": 123
},
"networks": [
{
"network": "<string>",
"id": "<string>",
"url": "<string>"
}
],
"locations": [
{
"location": {
"name": "<string>",
"city": "<string>",
"state": "<string>",
"country": "<string>",
"streetAddress": "<string>",
"postalCode": "<string>"
},
"headquarter": true
}
],
"logo": "<string>"
},
"title": "<string>",
"startDate": "2023-12-25",
"endDate": "2023-12-25"
}
],
"latestRoleChangeAt": "2023-12-25",
"latestCompanyChangeAt": "2023-12-25",
"locationName": "<string>",
"locationNames": [
"<string>"
],
"interests": [
"<string>"
],
"skills": [
"<string>"
],
"education": [
{
"school": {
"name": "<string>",
"type": "<string>",
"id": "<string>",
"location": {
"name": "<string>",
"city": "<string>",
"state": "<string>",
"country": "<string>",
"streetAddress": "<string>",
"postalCode": "<string>"
},
"website": "<string>"
},
"startDate": "2023-12-25",
"endDate": "2023-12-25",
"degrees": [
"<string>"
],
"majors": [
"<string>"
],
"minors": [
"<string>"
]
}
],
"profiles": [
{
"network": "<string>",
"id": "<string>",
"url": "<string>"
}
],
"updatedAt": "2023-11-07T05:31:56Z",
"currentJobUpdatedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z"
}
}
],
"notFound": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
}
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. |
profile_info | Detailed profile data, e.g. work experience, education, etc. |
Please note that investorData
is no longer a valid field in fetch requests. This information is now available as investor_data
nested within the profile_info
object. For more details on this structure change, please refer to the Models > Profile. documentation.
To see a full response of the Fetch endpoint see Models > Profile
Authorizations
Body
connections
, lists
, notes
, tags
, profile_info
Response
List of profiles with corresponding data
The unique identifier of the profile
The connections of the profile
The unique identifier of the user
The email of the user
The LinkedIn name of the user
The creation date of the connection
The strength of the connection
The normalized strength of the connection
The manually set strength of the connection
The profile information
The unique identifier of the profile
The full name of the profile
The first name of the profile
The last name of the profile
The LinkedIn URL of the profile
The update date of the profile
The creation date of the profile
The work email of the profile
The personal emails of the profile
The industry of the profile
The title of the current job
The role of the title in the current job
The person's seniority in the current job
The unique identifier of the company in the current job
The name of the company in the current job
The logo URL of the company in the current job
The website of the company in the current job
The industry of the company in the current job
The location name of the company in the current job
The LinkedIn URL of the company in the current job
The experience of the profile
Whether the job is primary or not
The unique identifier of the company in the job
The title of the job
The start date of the job
The unique identifier of the company
The name of the company
The canonical name of the company
The founding date of the company
The industry of the company
The website of the company
The networks of the company
The locations of the company
The logo of the company
The end date of the job
The date of the latest role change
The date of the latest company change
The location name of the profile
The location names of the profile
The interests of the profile
The skills of the profile
The education of the profile
The name of the school
The type of the school
The unique identifier of the school
The website of the school
The start date of the education
The end date of the education
The degrees of the education
The majors of the education
The minors of the education
The update date of current job in the profile
List of profile ids that were not found
curl --request POST \
--url https://bee.theswarm.com/v2/profiles/fetch \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{
"ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"fields": [
"profile_info"
]
}'
{
"results": [
{
"id": "<string>",
"connections": [
{
"userId": "<string>",
"userEmail": "<string>",
"userLinkedinName": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"sources": [
{
"origin": "<string>",
"network": "<string>"
}
],
"connectionStrength": 123,
"manualStrength": 123,
"strengthNormalized": 123
}
],
"lists": [
{
"id": "<string>",
"name": "<string>",
"status": "<string>"
}
],
"notes": [
{
"id": "<string>",
"content": "<string>"
}
],
"tags": [
{
"id": "<string>",
"name": "<string>"
}
],
"profileInfo": {
"id": "<string>",
"fullName": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"linkedinUrl": "<string>",
"workEmail": "<string>",
"personalEmails": [
"<string>"
],
"industry": "<string>",
"jobTitle": "<string>",
"jobTitleRole": "<string>",
"jobSeniority": [
"<string>"
],
"jobCompanyId": "<string>",
"jobCompanyName": "<string>",
"jobCompanyLogoUrl": "<string>",
"jobCompanyWebsite": "<string>",
"jobCompanySize": {
"min": 123,
"max": 123
},
"jobCompanyIndustry": "<string>",
"jobCompanyLocationName": "<string>",
"jobCompanyLinkedinUrl": "<string>",
"experience": [
{
"isPrimary": true,
"companyId": "<string>",
"company": {
"id": "<string>",
"canonicalName": "<string>",
"name": "<string>",
"founded": "2023-11-07T05:31:56Z",
"industry": "<string>",
"website": "<string>",
"size": {
"min": 123,
"max": 123
},
"networks": [
{
"network": "<string>",
"id": "<string>",
"url": "<string>"
}
],
"locations": [
{
"location": {
"name": "<string>",
"city": "<string>",
"state": "<string>",
"country": "<string>",
"streetAddress": "<string>",
"postalCode": "<string>"
},
"headquarter": true
}
],
"logo": "<string>"
},
"title": "<string>",
"startDate": "2023-12-25",
"endDate": "2023-12-25"
}
],
"latestRoleChangeAt": "2023-12-25",
"latestCompanyChangeAt": "2023-12-25",
"locationName": "<string>",
"locationNames": [
"<string>"
],
"interests": [
"<string>"
],
"skills": [
"<string>"
],
"education": [
{
"school": {
"name": "<string>",
"type": "<string>",
"id": "<string>",
"location": {
"name": "<string>",
"city": "<string>",
"state": "<string>",
"country": "<string>",
"streetAddress": "<string>",
"postalCode": "<string>"
},
"website": "<string>"
},
"startDate": "2023-12-25",
"endDate": "2023-12-25",
"degrees": [
"<string>"
],
"majors": [
"<string>"
],
"minors": [
"<string>"
]
}
],
"profiles": [
{
"network": "<string>",
"id": "<string>",
"url": "<string>"
}
],
"updatedAt": "2023-11-07T05:31:56Z",
"currentJobUpdatedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z"
}
}
],
"notFound": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
}