Access to The Swarm API is secured using an API key mechanism, ensuring only authorized users can interact with the endpoints. Each API key is tied to a specific Team within The Swarm, so you must be an owner or admin of a Team and on the appropriate plan to use it.

​

​
Create an account

  • Sign up at https://app.theswarm.com
  • During onboarding, add your company’s LinkedIn URL to activate the AI Network Mapper, which maps your team’s network.
  • After onboarding, you’ll get a 30-day free trial of our Premium plan, including API access.
  • Add your connectors, team, partners, customers, investors, advisors, and search through everyone’s combined networks. The Swarm Relationship Strength Score automatically evaluates connection quality.
  • Explore plans and pricing to find the best fit for you.

​
Get Your API Key

  1. Navigate to Team Settings by clicking your Team name in the top-left corner of the sidebar.
  2. Go to the API tab.
  3. Click Generate API Key to create your key.
  4. Copy the generated key to your clipboard for use.

​
Using Your API Key

Include your API key in the headers of each request by adding it as the x-api-key header. This authenticates your API calls and allows access to Team-specific data, such as profiles, lists, and tags.

​
Security Best Practices

Your API key is a powerful credential—treat it like a password:

  • Keep it private: Never share your API key in public spaces, such as GitHub or client-side code.
  • Protect your access: Unauthorized use of your API key can compromise your data and system integrity.
  • Start small: When using the API, we suggest testing with a small batch of inputs first. This allows you to validate your setup and ensure everything works smoothly before scaling your processes.
  • Rate Limits: Be mindful of rate limits to avoid unnecessary throttling (learn more here).

With your API key in hand, you’re ready to securely access The Swarm API and its capabilities!