Skip to main content
The Live Enrichment endpoint gives you on-demand access to the freshest possible data for any profile in The Swarm. While profiles in the index are enriched and maintained on an ongoing basis, there are moments in a workflow where you need the absolute latest snapshot — and this endpoint lets you trigger that enrichment in real time.
This endpoint is in beta. Please report any issues to support@theswarm.com
To use it, send a GET request to: 
GET http://bee.theswarm.com/v2/profiles/fetch/refresh
The only required parameter is linkedinName — the LinkedIn username of the profile you want to refresh. You can find the full list of supported parameters on the Fetch endpoint page, as both endpoints share the same schema. Example: 
https://bee.theswarm.com/v2/profiles/fetch/refresh?linkedinName=davidconnors
Learn more how to use the “Refresh a Profile” endpoint here.

​
Ongoing enrichment vs. live enrichment

The Swarm continuously maintains and refreshes profile data in the background — so in most cases, the data you get from a standard search or fetch will already be reasonably fresh. Live Enrichment is for situations where that isn’t enough, and you need to guarantee the data reflects the current state of a person’s LinkedIn profile at the time of your request. Think of it as the difference between pulling from a well-maintained index and making a live call to verify. Both have their place, and knowing when to use each is key to building reliable workflows.

​
Where to use this in your workflow

A refresh is most valuable at moments where stale data could cause a problem:
  • Before outreach — confirm a contact’s current role and employer before sending a message, so you’re not referencing a job they left months ago
  • CRM sync — trigger a refresh when importing contacts or periodically updating records to catch role changes and new contact information
  • Automated pipelines — add a refresh step in Airtable automations or similar workflows before any action that depends on accurate profile data

​
Beta

This endpoint is currently in beta. The response model and schema are identical to the Fetch endpoint, and support for additional identifiers (email, Swarm ID, etc.) is on the roadmap. Please report any issues to support@theswarm.com.