> ## Documentation Index
> Fetch the complete documentation index at: https://docs.theswarm.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Refresh a Profile
> Triggers an on-demand refresh of a profile's data from available sources, returning the most current version of their LinkedIn information.
This endpoint is in beta. Please report any issues to [support@theswarm.com](mailto:support@theswarm.com)
## Endpoint
```text theme={null}
GET https://bee.theswarm.com/v2/profiles/fetch/refresh
```
## Query Parameters
| Parameter | Type | Required | Description |
| :------------- | :----- | :------- | :------------------------------------------------------------------- |
| `linkedinName` | string | Yes | LinkedIn username (slug) of the profile to enrich |
| `[other ids]` | string | | Support for more identifiers (emails, Swarm ID etc.) is coming soon! |
## Request Example
```text theme={null}
GET https://bee.theswarm.com/v2/profiles/fetch/refresh?linkedinName=olivier-roth
```
```text GET theme={null}
https://bee.theswarm.com/v2/profiles/fetch/refresh?linkedinName=olivier-roth
```
```text filename theme={null}
{
"id": "00000000-0000-0000-0000-000000000000",
"full_name": "Olivier Roth",
"headline": "Co-Founder & CGO at The Swarm, The Relationship Intelligence Leader",
"about": "I'm Olivier Roth, and I'm on a mission to help Go-To-Market leaders and investors embrace the power of Relationship Intelligence. With a knack for crafting growth strategies and a passion for fostering authentic connections, I've been fortunate to make an impact on large brands and high-growth startups worldwide.\n\nAs Co-Founder & Chief Growth Officer at The Swarm, I'm dedicated to helping companies and investors combine and unlock their extended networks' potential. \n\nReady to take your company network to the next level? Let's connect and explore how Relationship Intelligence can transform your business.\n\nYou can also get started for free at theswarm.com",
"current_location": "San Francisco, California, United States",
"linkedin_url": "linkedin.com/in/olivier-roth",
"current_title": "Co-Founder & Chief Growth Officer",
"current_company_name": "The Swarm 🔆",
"current_company_website": "theswarm.com",
"current_company_websites": [
"theswarm.com"
],
"current_company_location": "San Francisco Bay Area",
"current_company_linkedin_url": "linkedin.com/company/wearetheswarm",
"experience": [
{
"is_current": true,
"company": {
"name": "The Swarm 🔆",
"website": "theswarm.com",
"websites": [
"theswarm.com"
],
"social_media": [
{
"id": "76647462",
"network": "linkedin",
"url": "linkedin.com/company/wearetheswarm"
},
{
"network": "crunchbase",
"url": "crunchbase.com/organization/the-swarm-e90d"
},
{
"network": "contact",
"url": "www.theswarm.com/start"
},
{
"network": "twitter",
"url": "twitter.com/wearetheswarm"
},
{
"network": "facebook",
"url": "www.facebook.com/wearetheswarm"
},
{
"network": "pitchbook",
"url": "pitchbook.com/profiles/company/496661-59"
}
],
"locations": [
{
"name": "San Francisco Bay Area"
}
]
},
"title": "Co-Founder & Chief Growth Officer",
"description": "• Growth model, planning, and revenue expansion strategy\n• Branding, strategic positioning, and messaging\n• Pricing model, onboarding and paywall mechanics\n• Demand generation via social media, content marketing strategy and execution, website optimization, ads management, video marketing, event marketing.\n• Setting up sales playbooks, hiring and managing our sales team\n• Product ideation, vendor selection, and prototyping to increase adoption, retention and monetization\n• Collect insights and product requirements from key customers and prospects\n• Inbound lead qualification and nurturing during trials\n• Warm outbound at scale via The Swarm, email, LinkedIn, and online communities\n• Finding, closing, onboarding, and communicating with Swarm ambassadors and partners\n• Onboarding and orienting new customers, tracking customer roaster, status, revenue, churn risk\n• RevOps (subscription tracking, payments, receipts, renewal dates and communications, etc.)",
"start_date": "2022-01-01",
"status": "ongoing"
},
{
"company": {
"name": "Timelapse",
"industry": "Advertising",
"industries": [
"Advertising",
"Creative Agency",
"Digital Marketing"
],
"website": "teamtimelapse.com",
"websites": [
"teamtimelapse.com"
],
"social_media": [
{
"id": "3742382",
"network": "linkedin",
"url": "linkedin.com/company/teamtimelapse"
},
{
"network": "crunchbase",
"url": "crunchbase.com/organization/timelapse-4b5a"
},
{
"network": "golden",
"url": "golden.com/wiki/Timelapse-YXJKNDB"
},
{
"network": "facebook",
"url": "www.facebook.com/teamtimelapse.inc"
}
],
"locations": [
{
"name": "Denver, Colorado, United States"
}
]
},
"title": "Founder & CEO",
"description": "- Bootstrapped the agency to 7 figures and 8+ FT employees/30+ contractors\n- Built growth engines for hundreds of Seed/Series A startups\n- Worked with large orgs (Rakuten, Lyft, LinkedIn, Stanford) and Fortune 500 companies on growth marketing projects\n- Grew to 100+ customers across Europe and North America",
"start_date": "2014-05-01",
"end_date": "2021-12-01",
"status": "past"
},
{
"company": {
"name": "ClinCapture",
"website": "clincapture.com",
"websites": [
"clincapture.com"
],
"social_media": [
{
"id": "890144",
"network": "linkedin",
"url": "linkedin.com/company/clincapture"
},
{
"network": "crunchbase",
"url": "crunchbase.com/organization/clincapture"
},
{
"network": "facebook",
"url": "www.facebook.com/ClinCapture"
},
{
"network": "twitter",
"url": "twitter.com/ClinCapture"
}
],
"locations": [
{
"name": "Sunnyvale, California"
}
]
},
"title": "Marketing Manager",
"description": "- Management of annual marketing plan in support of organizational strategy and objectives.\n- Competitive intelligence and monthly marketing reports.\n- Market research and planning, strategic direction for promotion and advertising. \n- Implementation of in-house processes to measure the efficiency and productivity of marketing and communication actions.\n- Optimization of the customer relationship management strategy - this involves using technology to organize, automate, and synchronize business processes to find, attract, and win new clients. This includes developing and following up with reach-out campaigns.\n- Product Launches: ClinCapture 2.0 (clinical trial software), TechTrainings (classes, $150K in revenue) and CloudClinica (Beta).\n- Brought web traffic from 1,800 per month to +5,000 per month (+280%)\n- Webdesign, SEO strategy, Google Adwords, Adroll, LinkedIn ads.\n- Selection, implementation and management of Salesforce and Salesforce Pardot.\n- Public relations – this includes developing and placing press releases, building contact with the press, supporting public speakers.\n- Support of the sales team in establishing the direction and rationale for promotional activity on the product(s) line. \n- High quality marketing material for all products and services working hand-in-hand with the sales and programming teams.\n- Planning and organization of tradeshows in San Francisco, San Diego, Chicago, Boston, and Paris.\n- Website qualified leads from 10 to 150 a month.",
"start_date": "2012-01-01",
"end_date": "2014-09-01",
"status": "past"
},
{
"company": {
"name": "URGO Group",
"website": "urgo-group.fr",
"websites": [
"urgo-group.fr"
],
"social_media": [
{
"id": "2040803",
"network": "linkedin",
"url": "linkedin.com/company/urgo"
},
{
"network": "crunchbase",
"url": "crunchbase.com/organization/urgo-group"
},
{
"network": "contact",
"url": "urgo-group.fr/contact/"
},
{
"network": "twitter",
"url": "twitter.com/Groupe_Urgo"
},
{
"network": "golden",
"url": "golden.com/wiki/Urgo_Group-39ANW4W"
}
]
},
"title": "Strategic Marketing & Innovation Analyst",
"description": "- Full time position as Strategic Marketing & Innovation Analyst\n- In-depth market study on the field (Pharmaceutical products) in the United States, Japan, UK and Germany.\n- New product launch strategies and recommendations for the top management team.\n- Organization of innovation sessions with marketing teams (brand strategy, new developments, packaging improvements).\n- Full-time management of a Marketing & Communication Intern.",
"start_date": "2010-10-01",
"end_date": "2012-01-01",
"status": "past"
},
{
"company": {
"name": "Havas Creative Network",
"industry": "Advertising Services",
"industries": [
"Advertising Services"
],
"website": "havascreative.com",
"websites": [
"havascreative.com"
],
"social_media": [
{
"id": "2500",
"network": "linkedin",
"url": "linkedin.com/company/havas_creative_network"
},
{
"network": "contact",
"url": "havascreative.com/contact-us/"
}
],
"locations": [
{
"name": "Greater Paris Metropolitan Region"
}
]
},
"title": "Direct Marketing Project Manager",
"description": "- Web Project Manager for the Disneyland Paris brand.\n- Direct Marketing project management (emailing campaigns, mini-websites).\n- New business projects for the agency (Galeries Lafayette).\n- In-depth competitive market research and analysis on European theme parks market.",
"start_date": "2009-01-01",
"end_date": "2009-06-01",
"status": "past"
},
{
"company": {
"name": "Computer Sciences Corporation ",
"industry": "IT Services and IT Consulting",
"industries": [
"IT Services and IT Consulting"
],
"website": "dxc.com/us",
"websites": [
"dxc.com/us"
],
"social_media": [
{
"id": "77764578",
"network": "linkedin",
"url": "linkedin.com/company/computer-sciences-corporation-csc"
}
]
},
"title": "School Relationship Manager",
"description": "- 6 months internship as School Relationship Manager.\n- Partnership set-up with associations at top french business schools.\n- HR Branding and production of online broadcasted videos for students.\n- Setting-up of the new CSC visual identity plan online.",
"start_date": "2008-06-01",
"end_date": "2008-12-01",
"status": "past"
}
],
"skills": [
"Influencer Marketing",
"Go-to-Market Strategy",
"Branding & Identity",
"The Swarm",
"Innovation Consulting",
"Marketing Strategy",
"Project Coordination",
"Direct Marketing",
"Business Development",
"Market Research",
"Project Management",
"Oncology",
"Product Management",
"Marketing",
"Strategic Planning",
"Business Strategy",
"Management",
"Market Analysis",
"Marketing Communications",
"French"
],
"education": [
{
"school": {
"name": "ESCP Business School",
"location": {
"name": "Turin, Italy"
}
},
"start_date": "2006-01-01",
"end_date": "2010-01-01",
"degrees": [
"Master in Management Grandes Ecoles"
],
"majors": [
"Marketing"
]
},
{
"school": {
"name": "ESCP Business School",
"location": {
"name": "Turin, Italy"
}
},
"start_date": "2006-01-01",
"end_date": "2010-01-01",
"majors": [
"Marketing"
]
},
{
"school": {
"name": "Lycée Hoche, Versailles"
},
"start_date": "2004-01-01",
"end_date": "2006-01-01",
"degrees": [
"Prepa Grandes Ecoles - Business School 2-year Preparation"
],
"majors": [
"Grandes ecoles"
]
}
],
"certifications": [
{
"name": "Reforge Advanced Growth Series",
"organization": "Reforge",
"start_date": "2022-08-01"
},
{
"name": "Certified in Digital Marketing Analytics",
"organization": "MIT Sloan Executive Education",
"start_date": "2020-08-01"
}
],
"social_media": [
{
"connections": 9634,
"entity_id": "ACoAAAGuWksBmL1ed-Y_9vS08PTEBGeTnJH1QEI",
"followers": 11782,
"id": "28203595",
"joined_date": "2008-07-24",
"last_seen_at": "2026-03-23",
"network": "linkedin",
"slug": "olivier-roth",
"url": "linkedin.com/in/olivier-roth",
"url_status": "active"
},
{
"network": "crunchbase",
"url": "crunchbase.com/person/olivier-roth-ddb3"
},
{
"network": "twitter",
"url": "x.com/digi_liv"
},
{
"network": "website",
"url": "theswarm.com"
},
{
"network": "facebook",
"url": "www.facebook.com/olivier.roth.14"
}
],
"latest_role_change_at": "2022-01-01",
"latest_company_change_at": "2021-12-01",
"last_refresh_at": "2026-03-23T15:20:37.976Z"
}
```
Successful response will return the most up-to-date information about the given profile. The model and schema are the same as in the [fetch endpoint](/docs/enrichment-data/profile).
## OpenAPI
````yaml openapi.json GET /v2/profiles/fetch/refresh
openapi: 3.1.0
info:
title: Swarm API
version: 1.0.0
contact:
name: The Swarm
url: https://theswarm.com
email: hello@theswarm.com
servers:
- url: https://bee.theswarm.com
security:
- ApiKeyAuth: []
tags:
- name: profiles
description: Operations related to profiles
- name: companies
description: Operations related to companies
- name: teams
description: Operations for managing teams and connectors
- name: social
description: Operations related to social media posts and interactions
- name: mcp
description: Model Context Protocol endpoint for AI assistant integrations
- name: credits
description: Operations related to credit usage
- name: network-mapper
description: Operations for mapping connections and relationships across your network
paths:
/v2/profiles/fetch/refresh:
get:
tags:
- profiles
summary: Fetch a refreshed profile
description: Fetch up-to-date profile data for a given LinkedIn URL slug
operationId: getRefreshedProfile
parameters:
- name: linkedinName
in: query
required: true
description: LinkedIn URL slug of the profile
schema:
type: string
responses:
'200':
description: Refreshed profile data
content:
application/json:
schema:
$ref: '#/components/schemas/ProfileInfo'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
description: Profile not found
5XX:
$ref: '#/components/responses/5XX'
security:
- ApiKeyAuth: []
components:
schemas:
ProfileInfo:
type: object
properties:
id:
type: string
description: The unique identifier of the profile
format: uuid
full_name:
type: string
description: The full name of the profile
first_name:
type: string
description: The first name of the profile
last_name:
type: string
description: The last name of the profile
headline:
type: string
description: The title of the current job
about:
type: string
description: The industry of the profile
linkedin_url:
type: string
description: The LinkedIn URL of the profile
work_email:
type: string
description: The work email of the profile
personal_emails:
type: array
items:
type: string
description: The personal emails of the profile
current_title:
type: string
description: The title of the current job
current_function:
type: string
description: The role of the title in the current job
current_seniority:
type: array
items:
type: string
description: The person's seniority in the current job
current_company_id:
type: string
description: The unique identifier of the company in the current job
format: uuid
current_company_name:
type: string
description: The name of the company in the current job
current_company_logo_url:
type: string
description: The logo URL of the company in the current job
current_company_website:
type: string
description: The website of the company in the current job
current_company_size:
$ref: '#/components/schemas/SizeClass'
current_company_industry:
type: string
description: The industry of the company in the current job
current_company_location:
type: string
description: The location name of the company in the current job
current_company_linkedin_url:
type: string
description: The LinkedIn URL of the company in the current job
experience:
type: array
items:
$ref: '#/components/schemas/Job'
description: The experience of the profile
current_location:
type: string
description: The location name of the profile
other_locations:
type: array
items:
type: string
description: The location names of the profile
skills:
type: array
items:
type: string
description: The skills of the profile
education:
type: array
items:
$ref: '#/components/schemas/Education'
description: The education of the profile
linkedin_experience_count:
type: integer
description: Total number of experience entries on LinkedIn
linkedin_education_count:
type: integer
description: Total number of education entries on LinkedIn
social_media:
type: array
items:
$ref: '#/components/schemas/SocialMedia'
description: Social media profiles
investor_data:
$ref: '#/components/schemas/InvestorData'
description: Investor-related data
smart_tags:
type: array
items:
type: string
description: AI-generated tags for the profile
latest_role_change_at:
type: string
format: date
description: The date of the latest role change
latest_company_change_at:
type: string
format: date
description: The date of the latest company change
current_job_updated_at:
type: string
format: date-time
description: The update date of current job in the profile
updated_at:
type: string
format: date-time
description: The update date of the profile
created_at:
type: string
format: date-time
description: The creation date of the profile
last_refresh_at:
type: string
format: date-time
description: The last refresh date of the profile
current_company_websites:
type: array
items:
type: string
description: The websites of the company in the current job
current_company_industries:
type: array
items:
type: string
description: The industries of the company in the current job
certifications:
type: array
items:
$ref: '#/components/schemas/Certification'
description: The certifications of the profile
image_url:
type: string
description: Profile image URL (CDN)
required:
- id
SizeClass:
type: object
properties:
min:
type: integer
description: The minimum size of the class
max:
type: integer
description: The maximum size of the class
Job:
type: object
properties:
is_current:
type: boolean
description: Whether the job is primary or not
company_id:
type: string
description: The unique identifier of the company in the job
format: uuid
company:
$ref: '#/components/schemas/ProfileCompany'
title:
type: string
description: The title of the job
seniority:
type: array
items:
type: string
description: The person's seniority in the job
function:
type: string
description: The role/function in the job
location:
type: array
items:
type: string
description: Job location names
description:
type: string
description: The description of the job
start_date:
type: string
format: date
description: The start date of the job
end_date:
type: string
format: date
description: The end date of the job
status:
type: string
description: Experience status enum
enum:
- unknown
- past
- ongoing
Education:
type: object
properties:
school:
$ref: '#/components/schemas/School'
start_date:
type: string
format: date
description: The start date of the education
end_date:
type: string
format: date
description: The end date of the education
degrees:
type: array
items:
type: string
description: The degrees of the education
majors:
type: array
items:
type: string
description: The majors of the education
minors:
type: array
items:
type: string
description: The minors of the education
activities:
type: string
description: The activities of the education
grade:
type: string
description: The grade of the education
description:
type: string
description: The description of the education
SocialMedia:
type: object
properties:
network:
type: string
description: Social media network name
id:
type: string
description: Identifier on the social network
slug:
type: string
description: Slug / handle on the social network
url:
type: string
description: Full profile URL
url_status:
type: string
description: Status of the resolved URL
enum:
- ''
- unknown
- active
InvestorData:
type: object
properties:
description:
type: string
description: Investor description
type:
type: array
items:
type: string
description: Types (e.g. Angel, VC)
industry_focus:
type: array
items:
type: string
description: Industries of focus
stage_focus:
type: array
items:
type: string
description: Investment stages of focus
geo_focus:
type: array
items:
type: string
description: Geographies of focus
check_size:
type: array
items:
type: string
description: Typical check sizes
portfolio_companies:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
description: Portfolio company id
required:
- id
description: Portfolio companies
Certification:
type: object
properties:
end_date:
type: string
description: The end / expiry date of the certification
name:
type: string
description: The name of the certification
organization:
type: string
description: The issuing organization
start_date:
type: string
description: The start / issue date of the certification
ErrorResponse:
type: object
properties:
code:
description: Error status code
type: integer
errors:
type: array
items:
type:
- string
- object
required:
- code
ProfileCompany:
type: object
properties:
id:
type: string
format: uuid
description: The unique identifier of the company
canonical_name:
type: string
description: The canonical name of the company
name:
type: string
description: The name of the company
founded:
type: string
format: date-time
description: The founding date of the company
industry:
type: string
description: The industry of the company
website:
type: string
description: The website of the company
size:
$ref: '#/components/schemas/SizeClass'
social_media:
type: array
items:
$ref: '#/components/schemas/SocialMedia'
description: The networks of the company
locations:
type: array
items:
$ref: '#/components/schemas/CompanyLocation'
description: The locations of the company
industries:
type: array
items:
type: string
description: The industries of the company
websites:
type: array
items:
type: string
description: The websites of the company
workforce:
type: object
properties:
headcount:
type: integer
description: Current headcount
School:
type: object
properties:
name:
type: string
description: The name of the school
location:
$ref: '#/components/schemas/Location'
website:
type: string
description: The website of the school
linkedin_url:
type: string
description: Linkedin profile URL of the school
linkedin_id:
type: string
description: Linkedin numeric id of the school
social_media:
type: array
items:
$ref: '#/components/schemas/SocialMedia'
description: Social media profiles of the school
CompanyLocation:
type: object
properties:
name:
type: string
description: The name of the location
city:
type: string
description: The city of the location
state:
type: string
description: The state of the location
country:
type: string
description: The country of the location
street_address:
type: string
description: The street address of the location
postal_code:
type: string
description: The postal code of the location
headquarter:
type: boolean
description: Whether the location is the headquarter
Location:
type: object
properties:
name:
type: string
description: The name of the location
city:
type: string
description: The city of the location
state:
type: string
description: The state of the location
country:
type: string
description: The country of the location
street_address:
type: string
description: The street address of the location
postal_code:
type: string
description: The postal code of the location
responses:
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Unauthorized
'403':
description: Forbidden
5XX:
description: Unexpected error
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
````