Models
Profile
Overview of the data model representing a profile returned by the Fetch endpoint
Explore the detailed breakdown of each item model component, complete with properties and their descriptions.
Response Keys
The Profile JSON response is built around six core keys listed below:| Key | Description |
|---|---|
| id | ID of the person assigned by The Swarm that was previously returned by the /search endpoint. |
profile_info | Detailed profile data, e.g. work experience, education, etc. |
connections | A list of Team Members that are connected to the person. A team member can be identified by their email address or LinkedIn user name (if added LinkedIn url at the registration) |
lists | A list of Lists that the person is assigned to along with the status in the List. |
notes | All notes that have been added to the person by any of the team members |
tags | All tags assigned to the profile by any of the team members. |
Fill Rate
Data completeness for selected fields:| Field | Total | US |
|---|---|---|
| profile_info.full_name | 100% | 100% |
| profile_info.linkedin_usernames | 100% | 100% |
| profile_info.current_title | 94% | 94% |
| profile_info.current_company_name | 95% | 95% |
| profile_info.location_name | 96% | 99% |
| profile_info.current_seniority | 83% | 88% |
| profile_info.industry | 65% | 76% |
Timestamp Fields
| Field | Description |
|---|---|
| latest_role_change_at | Timestamp representing the start date of the most recent job detected for the profile. |
| current_job_updated_at | Timestamp of the most recent change detected in the current primary job, which includes changes in company, title, or both. |
| updated_at | Timestamp of the last update to any field in the profile document. Reflects any modification to the profile data. |
| created_at | Timestamp indicating when the profile was created in our database. |
| last_refresh_at | Timestamp of the latest attempt to refresh the profile data - either via rescraping the internet or receiving updated information from a data partner. |
JSON Schema
Here is the full JSON Schema for the data model returned by the Fetch endpoint. This schema outlines the structure and data types of the JSON response, offering a clear and detailed blueprint of the profile model.Profile JSON Schema v2
Profile JSON Schema v2
Copy
Ask AI
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"connections": {
"type": "array",
"items": {
"type": "object",
"properties": {
"userId": {
"type": "string"
},
"user_email": {
"type": "string"
},
"user_linkedin_name": {
"type": "string"
},
"created_at": {
"type": "string"
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"origin": {
"type": "string"
},
"network": {
"type": "string"
}
}
}
},
"connection_strength": {
"type": "number"
},
"manual_strength": {
"type": "number"
},
"strength_normalized": {
"type": "integer"
}
}
}
},
"lists": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"status": {
"type": "string"
}
}
}
},
"notes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"content": {
"type": "string"
}
}
}
},
"tags": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
}
}
},
"profile_info": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"full_name": {
"type": "string"
},
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"linkedin_url": {
"type": "string"
},
"work_email": {
"type": "string"
},
"personal_emails": {
"type": "array",
"items": {
"type": "string"
}
},
"current_title": {
"type": "string"
},
"current_company_id": {
"type": "string"
},
"current_company_name": {
"type": "string"
},
"current_company_website": {
"type": "string"
},
"current_company_size": {
"type": "object",
"properties": {
"min": {
"type": "integer"
},
"max": {
"type": "integer"
}
}
},
"current_company_industry": {
"type": "string"
},
"current_company_location": {
"type": "string"
},
"current_company_linkedin_url": {
"type": "string"
},
"experience": {
"type": "array",
"items": {
"type": "object",
"properties": {
"is_current": {
"type": "boolean"
},
"company_id": {
"type": "string"
},
"company": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"canonical_name": {
"type": "string"
},
"name": {
"type": "string"
},
"founded": {
"type": "string"
},
"industry": {
"type": "string"
},
"website": {
"type": "string"
},
"size": {
"type": "object",
"properties": {
"min": {
"type": "integer"
},
"max": {
"type": "integer"
}
}
},
"social_media": {
"type": "array",
"items": {
"type": "object",
"properties": {
"network": {
"type": "string"
},
"id": {
"type": "string"
},
"url": {
"type": "string"
}
}
}
},
"locations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"country": {
"type": "string"
},
"streetAddress": {
"type": "string"
},
"postalCode": {
"type": "string"
},
"headquarter": {
"type": "boolean"
}
}
}
}
}
},
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
}
}
}
},
"latest_role_change_at": {
"type": "string"
},
"latest_company_change_at": {
"type": "string"
},
"current_location": {
"type": "string"
},
"other_locations": {
"type": "array",
"items": {
"type": "string"
}
},
"skills": {
"type": "array",
"items": {
"type": "string"
}
},
"education": {
"type": "array",
"items": {
"type": "object",
"properties": {
"school": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"location": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"country": {
"type": "string"
}
}
},
"website": {
"type": "string"
}
}
},
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
},
"majors": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"social_media": {
"type": "array",
"items": {
"type": "object",
"properties": {
"network": {
"type": "string"
},
"url": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
},
"current_job_updated_at": {
"type": "string"
},
"updated_at": {
"type": "string"
},
"created_at": {
"type": "string"
}
}
}
}
}
Profile Example
An example of the profile returned by the Profile Fetch endpoint is given below.Profile Example
Profile Example
Copy
Ask AI
{
"id": "b8d4ba05-5158-4d80-a0a7-c8e650f7c95c",
"connections": [
{
"user_id": "68576a63-c8c3-4c92-88e8-b89a532ae3fa",
"user_email": "michal@theswarm.com",
"user_linkedin_name": "michal-bil",
"created_at": "2024-03-22T15:15:17.525907Z",
"sources": [
{
"origin": "plugin",
"network": "linkedin"
}
],
"connection_strength": 0.7084125480166015,
"manual_strength": null,
"strength_normalized": 1
}
],
"lists": [
{
"id": "58bb21af-6777-4a5d-a763-45df10258727",
"name": "Tech Leaders",
"status": "suggested"
}
],
"notes": [
{
"id": "a1037c27-b773-4c19-b987-c8854db6701d",
"content": "Cool guy. Met him while traveling to Bali."
}
],
"tags": [
{
"id": "faa5ba2a-23e9-40fd-8efe-720a2b6246d3",
"name": "Contact soon"
}
],
"profile_info": {
"id": "f0f9f467-7798-4b15-a913-3d1375c85390",
"full_name": "David Connors",
"first_name": "David",
"last_name": "Connors",
"current_location": "San Francisco, California, United States",
"linkedin_url": "linkedin.com/in/connorsdavid",
"work_email": "david@theswarm.com",
"personal_emails": [
"davidjulianconnors@gmail.com"
],
"current_title": "Co-Founder & CEO",
"current_seniority": [
"c-level"
],
"current_company_id": "09d9c510-c9f6-4c6e-9e62-fe5fedbeda87",
"current_company_name": "The Swarm",
"current_company_website": "theswarm.com",
"current_company_size": {
"min": 11,
"max": 50
},
"current_company_industry": "Computer Software",
"current_company_location": "San Francisco, California, United States",
"current_company_linkedin_url": "linkedin.com/company/wearetheswarm",
"experience": [
{
"is_current": true,
"company_id": "09d9c510-c9f6-4c6e-9e62-fe5fedbeda87",
"company": {
"id": "09d9c510-c9f6-4c6e-9e62-fe5fedbeda87",
"canonical_name": "wearetheswarm",
"name": "The Swarm",
"founded": "2021-01-01T00:00:00Z",
"industry": "Computer Software",
"website": "theswarm.com",
"size": {
"min": 11,
"max": 50
},
"social_media": [
{
"network": "linkedin",
"id": "76647462",
"url": "linkedin.com/company/wearetheswarm"
},
{
"network": "twitter",
"url": "twitter.com/wearetheswarm"
}
],
"locations": [
{
"name": "San Francisco, California, United States",
"city": "San Francisco",
"state": "California",
"country": "United States",
"street_address": "548 Market Street",
"postal_code": "94104",
"headquarter": true
}
]
},
"title": "Co-Founder & CEO",
"start_date": "2021-08-01"
},
{
"company_id": "f5d8c962-7987-4786-8754-5c85f8ba4bc3",
"company": {
"id": "f5d8c962-7987-4786-8754-5c85f8ba4bc3",
"canonical_name": "sequoia",
"name": "Sequoia Capital",
"founded": "1972-01-01T00:00:00Z",
"industry": "Venture Capital & Private Equity",
"website": "sequoiacap.com",
"size": {
"min": 51,
"max": 200
},
"social_media": [
{
"network": "linkedin",
"id": "11190",
"url": "linkedin.com/company/sequoia"
},
{
"network": "facebook",
"url": "facebook.com/sequoiacap"
},
{
"network": "twitter",
"url": "twitter.com/sequoia"
}
],
"locations": [
{
"name": "Menlo Park, California, United States",
"city": "Menlo Park",
"state": "California",
"country": "United States",
"street_address": "2800 Sand Hill Road",
"postal_code": "94025",
"headquarter": true
}
]
},
"title": "Founder-in-Residence",
"start_date": "2019-06-01",
"end_date": "2021-08-01"
},
{
"company_id": "b91ca025-b55e-485d-9838-40b64e9402d5",
"company": {
"id": "b91ca025-b55e-485d-9838-40b64e9402d5",
"canonical_name": "automately",
"name": "automately.io",
"founded": "2017-01-01T00:00:00Z",
"industry": "Information Technology and Services",
"website": "automately.io",
"size": {
"min": 1,
"max": 10
},
"social_media": [
{
"network": "linkedin",
"id": "17934171",
"url": "linkedin.com/company/automately"
}
],
"locations": [
{
"name": "Los Angeles, California, United States",
"city": "Los Angeles",
"state": "California",
"country": "United States",
"street_address": "2219 Main Street",
"postal_code": "90405",
"headquarter": true
}
]
},
"title": "Co-Founder & CEO",
"start_date": "2016-11-01",
"end_date": "2019-06-01"
},
{
"company": {
"name": "RevDev.io"
},
"title": "Co-Founder",
"start_date": "2018-01-01",
"end_date": "2019-01-01"
},
{
"company_id": "bcdfc1cb-7e6b-4e61-825b-c9306adcecb0",
"company": {
"id": "bcdfc1cb-7e6b-4e61-825b-c9306adcecb0",
"canonical_name": "docmatter",
"name": "Docmatter",
"founded": "0000-01-01T00:00:00Z",
"industry": "Hospital & Health Care",
"website": "docmatter.com",
"size": {
"min": 11,
"max": 50
},
"social_media": [
{
"network": "linkedin",
"id": "3242905",
"url": "linkedin.com/company/docmatter"
},
{
"network": "facebook",
"url": "facebook.com/docmatter"
},
{
"network": "twitter",
"url": "twitter.com/docmatterinc"
}
],
"locations": [
{
"name": "San Francisco, California, United States",
"city": "San Francisco",
"state": "California",
"country": "United States",
"street_address": "560 Davis Street, Suite 150",
"postal_code": "94111",
"headquarter": true
}
]
},
"title": "Growth",
"start_date": "2015-09-01",
"end_date": "2016-11-01"
},
{
"company_id": "6963a3df-a185-4c69-88fe-7e2b95786688",
"company": {
"id": "6963a3df-a185-4c69-88fe-7e2b95786688",
"canonical_name": "pwc",
"name": "PWC",
"founded": "1998-01-01T00:00:00Z",
"industry": "Accounting",
"website": "pwc.com",
"size": {
"min": 10001
},
"social_media": [
{
"network": "linkedin",
"id": "1044",
"url": "linkedin.com/company/pwc"
},
{
"network": "facebook",
"url": "facebook.com/execpress"
},
{
"network": "twitter",
"url": "twitter.com/pwc_llp"
}
],
"locations": [
{
"name": "New York, New York, United States",
"city": "New York",
"state": "New York",
"country": "United States",
"street_address": "300 Madison Avenue",
"postal_code": "10017",
"headquarter": true
}
]
},
"title": "Management Consultant | Digital and Emerging Technologies",
"start_date": "2014-06-01",
"end_date": "2015-11-01"
},
{
"company_id": "c3f4f899-85b0-4038-8eda-92c2dc654ee7",
"company": {
"id": "c3f4f899-85b0-4038-8eda-92c2dc654ee7",
"canonical_name": "management-consultancies-association",
"name": "Management Consultancies Association",
"founded": "1956-01-01T00:00:00Z",
"industry": "Management Consulting",
"website": "McA.org.uk",
"size": {
"min": 1,
"max": 10
},
"social_media": [
{
"network": "linkedin",
"id": "803387",
"url": "linkedin.com/company/management-consultancies-association"
},
{
"network": "facebook",
"url": "facebook.com/themcauk"
},
{
"network": "twitter",
"url": "twitter.com/themca_uk"
}
],
"locations": [
{
"name": "London, London, United Kingdom",
"city": "London",
"state": "London",
"country": "United Kingdom",
"headquarter": true
}
]
},
"title": "Vice Chair",
"start_date": "2014-05-01",
"end_date": "2015-08-01"
}
],
"other_locations": [
"San Francisco, California, United States"
],
"skills": [
"Analysis",
"Management Consulting",
"Business Strategy",
"Project Management",
"Management",
"Research",
"Data Analysis",
"Financial Modeling",
"Networking",
"Market Research",
"Microsoft Excel",
"Analytical Skills",
"Project Planning",
"Strategic Planning",
"Stakeholder Management",
"Operations Management",
"Operational Excellence",
"Event Management",
"Strategic Consulting",
"Strategy",
"Consulting"
],
"education": [
{
"school": {
"name": "University of Melbourne"
},
"start_date": "2007",
"end_date": "2010",
"degrees": [
"Bachelor of Commerce (Degree with Honours)"
],
"majors": [
""
]
},
{
"school": {
"name": "UC Santa Barbara"
},
"start_date": "2009",
"end_date": "2009",
"degrees": [
"Bachelor's Degree"
],
"majors": [
"Business/Managerial Economics"
]
},
{
"school": {
"name": "Uc Santa Barbara",
"location": {
"name": "Santa Barbara, California, United States",
"city": "Santa Barbara",
"state": "California",
"country": "United States"
},
"website": "ucsb.edu"
},
"start_date": "2009",
"end_date": "2009",
"degrees": [
"Bachelors"
],
"majors": [
"Economics",
"Business"
]
},
{
"school": {
"name": "Wesley College, Delaware",
"location": {
"name": "Dover, Delaware, United States",
"city": "Dover",
"state": "Delaware",
"country": "United States"
},
"website": "wesley.edu"
},
"start_date": "2001",
"end_date": "2006"
}
],
"social_media": [
{
"network": "linkedin",
"url": "www.linkedin.com/in/connorsdavid"
},
{
"network": "linkedin"
}
],
"latest_role_change_at": "2021-08-01",
"latest_company_change_at": "2021-08-01",
"current_job_updated_at": "2024-11-02T18:46:20.36853Z",
"updated_at": "2024-11-02T18:46:20.310219Z",
"created_at": "2023-07-25T18:30:44.131706Z"
}
}
Was this page helpful?
Assistant
Responses are generated using AI and may contain mistakes.