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": {
"user_id": {
"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"
},
"tags": {
"type": "array"
},
"profile_info": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"full_name": {
"type": "string"
},
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"headline": {
"type": "string"
},
"about": {
"type": "string"
},
"current_location": {
"type": "string"
},
"linkedin_url": {
"type": "string"
},
"current_title": {
"type": "string"
},
"current_seniority": {
"type": "array",
"items": {
"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"
},
"url": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
},
"locations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"country": {
"type": "string"
},
"street_address": {
"type": "string"
},
"postal_code": {
"type": "string"
},
"headquarter": {
"type": "boolean"
}
}
}
}
}
},
"title": {
"type": "string"
},
"seniority": {
"type": "array",
"items": {
"type": "string"
}
},
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
},
"status": {
"type": "string"
},
"location": {
"type": "array",
"items": {
"type": "string"
}
},
"description": {
"type": "string"
}
}
}
},
"other_locations": {
"type": "array",
"items": {
"type": "string"
}
},
"education": {
"type": "array",
"items": {
"type": "object",
"properties": {
"school": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"linkedin_url": {
"type": "string"
},
"linkedin_id": {
"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"
},
"degrees": {
"type": "array",
"items": {
"type": "string"
}
},
"majors": {
"type": "array",
"items": {
"type": "string"
}
},
"minors": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"social_media": {
"type": "array",
"items": {
"type": "object",
"properties": {
"connections": {
"type": "integer"
},
"followers": {
"type": "integer"
},
"id": {
"type": "string"
},
"join_date": {
"type": "string"
},
"network": {
"type": "string"
},
"url": {
"type": "string"
}
}
}
},
"latest_role_change_at": {
"type": "string"
},
"latest_company_change_at": {
"type": "string"
},
"current_job_updated_at": {
"type": "string"
},
"updated_at": {
"type": "string"
},
"created_at": {
"type": "string"
},
"last_refresh_at": {
"type": "string"
},
"work_email": {
"type": "string"
},
"personal_emails": {
"type": "array",
"items": {
"type": "string"
}
},
"interests": {
"type": "array",
"items": {
"type": "string"
}
},
"skills": {
"type": "array",
"items": {
"type": "string"
}
},
"current_function": {
"type": "string"
},
"smart_tags": {
"type": "array",
"items": {
"type": "string"
}
},
"investor_data": {
"type": "object",
"properties": {
"type": {
"type": "array",
"items": {
"type": "string"
}
},
"geo_focus": {
"type": "array",
"items": {
"type": "string"
}
},
"description": {
"type": "string"
},
"industry_focus": {
"type": "array",
"items": {
"type": "string"
}
},
"stage_focus": {
"type": "array",
"items": {
"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": "f0f9f467-7798-4b15-a913-3d1375c85390",
"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": 2
}
],
"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",
"headline": "Co-Founder/CEO at The Swarm ☀️ The Go-To-Network Platform",
"about": "• Co-Founder/CEO @ The Swarm\n• Founder-in-Residence @ Sequoia Capital\n• Co-Founder/CEO @ Automately.io (acquired by Sequoia)\n• Co-Founder @ RevDev.io (Revenue Development advisory)",
"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_function": "Sales & business development",
"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": "Software Development",
"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": "Software Development",
"website": "theswarm.com",
"size": {
"min": 11,
"max": 50
},
"social_media": [
{
"network": "dealroom",
"url": "app.dealroom.co/companies/the_swarm_1"
},
{
"network": "facebook",
"url": "www.facebook.com/wearetheswarm"
},
{
"network": "twitter",
"url": "twitter.com/wearetheswarm"
},
{
"network": "crunchbase",
"url": "crunchbase.com/organization/the-swarm-e90d"
},
{
"id": "496661-59",
"network": "pitchbook",
"url": "pitchbook.com/profiles/company/496661-59"
},
{
"network": "linkedin",
"url": "linkedin.com/company/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",
"seniority": [
"c-level"
],
"location": [
"San Francisco Bay Area"
],
"start_date": "2021-08-01",
"status": "ongoing"
},
{
"company_id": "f5d8c962-7987-4786-8754-5c85f8ba4bc3",
"company": {
"id": "f5d8c962-7987-4786-8754-5c85f8ba4bc3",
"canonical_name": "sequoia",
"name": "Sequoia Capital",
"founded": "1972-11-01T00:00:00Z",
"industry": "Finance",
"website": "sequoiacap.com",
"size": {
"min": 201,
"max": 500
},
"social_media": [
{
"network": "angelList",
"url": "angel.co/sequoia-capital"
},
{
"network": "blog",
"url": "sequoiacap.com/build/"
},
{
"network": "builtin",
"url": "builtin.com/company/sequoia-capital"
},
{
"network": "facebook",
"url": "www.facebook.com/sequoiacap"
},
{
"network": "golden",
"url": "golden.com/wiki/sequoia_capital-gerv6z"
},
{
"network": "levels",
"url": "www.levels.fyi/companies/sequoia-capital"
},
{
"network": "signalNFX",
"url": "signal.nfx.com/firms/sequoia-capital"
},
{
"network": "twitter",
"url": "www.twitter.com/sequoia"
},
{
"network": "crunchbase",
"url": "crunchbase.com/organization/sequoia-capital"
},
{
"network": "linkedin",
"url": "linkedin.com/company/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",
"seniority": [
"c-level"
],
"location": [
"San Francisco Bay Area"
],
"description": "Built products for investors, founders & recruiters.",
"start_date": "2019-06-01",
"end_date": "2021-08-01",
"status": "past"
},
{
"company_id": "b91ca025-b55e-485d-9838-40b64e9402d5",
"company": {
"id": "b91ca025-b55e-485d-9838-40b64e9402d5",
"canonical_name": "automately",
"name": "Automately",
"founded": "2017-01-01T00:00:00Z",
"industry": "Staffing and Recruiting",
"website": "sequoiacap.com",
"size": {
"min": 1,
"max": 10
},
"social_media": [
{
"network": "linkedin",
"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",
"seniority": [
"c-level"
],
"location": [
"San Francisco"
],
"description": "<p class=\"description\" data-section=\"currentPositions\">Founder and CEO of Automately.io, a San Francisco-based startup that provides Candidate Sourcing-as-a-Service for venture-backed companies looking to scale quickly.<br><br>Our systematized approach saves you hours of time, speeds up recruiting, and generates a robust pipeline of quality candidates, rapidly.<br> <br>We bring together the best practices from sales prospecting, talent sourcing, lead generation and automation to identify and attract top performers on your behalf, saving you hours of time.</p>",
"start_date": "2016-11-01",
"end_date": "2019-06-01",
"status": "past"
},
{
"company_id": "ea2f0978-eeb6-4c72-a67e-7fbfb095c022",
"company": {
"id": "ea2f0978-eeb6-4c72-a67e-7fbfb095c022",
"canonical_name": "revdevio",
"name": "revdev.io",
"founded": "2018-01-01T00:00:00Z",
"industry": "Management Consulting",
"website": "revdev.io",
"size": {
"min": 1,
"max": 10
},
"social_media": [
{
"id": "27225590",
"network": "linkedin",
"url": "linkedin.com/company/revdevio"
}
],
"locations": [
{
"name": "Portland, Oregon, United States",
"city": "Portland",
"state": "Oregon",
"country": "United States",
"headquarter": true
}
]
},
"title": "Co-Founder",
"seniority": [
"c-level"
],
"location": [
"San Francisco Bay Area"
],
"description": "<p class=\"item-body--margin-left item-body--title-small\">RevDev is a collective of Revenue Development advisors helping teams with great products build and scale great companies. <br><br>We believe that when you focus on Sales, Marketing, and Customer Success working together, they can deliver a better experience for customers, generate more revenue for their company, and have a whole lot more fun doing it. We use this collaborative, customer-centric approach to help early-stage B2B startups get their revenue development teams aligned and producing outsize results. </p>",
"start_date": "2018-01-01",
"end_date": "2019-01-01",
"status": "past"
},
{
"company_id": "bcdfc1cb-7e6b-4e61-825b-c9306adcecb0",
"company": {
"id": "bcdfc1cb-7e6b-4e61-825b-c9306adcecb0",
"canonical_name": "docmatter",
"name": "DocMatter",
"founded": "2012-01-01T00:00:00Z",
"industry": "Software",
"website": "docmatter.com",
"size": {
"min": 11,
"max": 50
},
"social_media": [
{
"network": "angelList",
"url": "angel.co/docmatter-1"
},
{
"network": "builtin",
"url": "builtin.com/company/docmatter-inc"
},
{
"network": "dealroom",
"url": "app.dealroom.co/companies/docmatter"
},
{
"network": "facebook",
"url": "www.facebook.com/docmatter"
},
{
"network": "golden",
"url": "golden.com/wiki/docmatter-8aam5g4"
},
{
"network": "levels",
"url": "www.levels.fyi/companies/docmatter"
},
{
"network": "twitter",
"url": "twitter.com/docmatterinc"
},
{
"network": "wellfound",
"url": "wellfound.com/company/docmatter-1"
},
{
"network": "crunchbase",
"url": "crunchbase.com/organization/docmatter"
},
{
"network": "linkedin",
"url": "linkedin.com/company/docmatter"
},
{
"id": "227048-05",
"network": "pitchbook",
"url": "pitchbook.com/profiles/company/227048-05"
}
],
"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",
"seniority": [
"senior"
],
"location": [
"San Francisco Bay Area"
],
"start_date": "2015-09-01",
"end_date": "2016-11-01",
"status": "past"
},
{
"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": "Tax Consulting",
"website": "fr.pwc.com",
"size": {
"min": 10001
},
"social_media": [
{
"network": "angelList",
"url": "angel.co/pricewaterhousecoopers-20"
},
{
"network": "facebook",
"url": "www.facebook.com/execpress"
},
{
"network": "golden",
"url": "golden.com/wiki/pwc_(pricewaterhousecoopers)-k36a3rp"
},
{
"network": "twitter",
"url": "twitter.com/pwc_llp"
},
{
"network": "crunchbase",
"url": "crunchbase.com/organization/pwc"
},
{
"network": "linkedin",
"url": "linkedin.com/company/pwc"
}
],
"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 & Emerging Technologies",
"seniority": [
"senior"
],
"location": [
"London, United Kingdom"
],
"start_date": "2012-06-01",
"end_date": "2015-11-01",
"status": "past"
},
{
"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": "Consulting",
"website": "mca.org.uk",
"size": {
"min": 51,
"max": 200
},
"social_media": [
{
"network": "facebook",
"url": "www.facebook.com/themcauk/"
},
{
"network": "twitter",
"url": "twitter.com/themca_uk"
},
{
"network": "crunchbase",
"url": "crunchbase.com/organization/management-consultancies-association"
},
{
"network": "linkedin",
"url": "linkedin.com/company/management-consultancies-association"
},
{
"id": "224814-61",
"network": "pitchbook",
"url": "pitchbook.com/profiles/company/224814-61"
}
],
"locations": [
{
"name": "London, London, United Kingdom",
"city": "London",
"state": "London",
"country": "United Kingdom",
"headquarter": true
}
]
},
"title": "Vice Chair (Young MCA)",
"seniority": [
"director"
],
"location": [
"London, United Kingdom"
],
"start_date": "2014-05-01",
"end_date": "2015-08-01",
"status": "past"
}
],
"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": "Wesley College",
"location": {
"name": "Melbourne, Victoria, Australia"
},
"website": "wesleycollege.edu.au",
"linkedin_url": "linkedin.com/school/wesley-college",
"linkedin_id": "0"
},
"start_date": "2001-01-01",
"end_date": "2006-01-01",
"degrees": [
"International Baccalaureate"
]
},
{
"school": {
"name": "UC Santa Barbara",
"location": {
"name": "Santa Barbara, California, United States"
},
"website": "ucsb.edu",
"linkedin_url": "linkedin.com/school/ucsantabarbara",
"linkedin_id": "0"
},
"start_date": "2009-01-01",
"end_date": "2009-01-01",
"degrees": [
"Bachelor's Degree"
],
"majors": [
"Business/Managerial Economics"
],
"minors": [
"example_string"
]
},
{
"school": {
"name": "University of Melbourne",
"location": {
"name": "Melbourne, Victoria, Australia"
},
"website": "unimelb.edu.au",
"linkedin_url": "linkedin.com/school/university-of-melbourne",
"linkedin_id": "0"
},
"start_date": "2007-01-01",
"end_date": "2010-01-01",
"degrees": [
"Bachelor of Commerce (Degree with Honours)"
]
}
],
"social_media": [
{
"connections": 8865,
"followers": 9238,
"join_date": "2010-03-03",
"network": "linkedin",
"url": "linkedin.com/in/connorsdavid"
},
{
"network": "twitter",
"url": "x.com/d_j_connors",
"connections": 123,
"followers": 123
}
],
"latest_role_change_at": "2021-08-01",
"latest_company_change_at": "2021-08-01",
"current_job_updated_at": "2025-08-12T12:44:32.65197Z",
"updated_at": "2025-09-02T21:00:47.340805Z",
"created_at": "2023-07-25T18:30:44.131706Z",
"last_refresh_at": "2025-09-02T21:00:47.340805Z",
"interests": [
"Technology and innovation",
"Market Research"
],
"smart_tags": [
"oneYearAtCurrentCompany"
]
}
}