The Swarm API lets you explore network connections using OpenSearch DSL, with results in JSON for seamless integration. Secure access via API key ensures reliable data retrieval.
The Swarm API ReferenceThe Swarm API is designed using the REST architectural style, employing standard HTTP methods for communication. Responses from the API are formatted in JSON (JavaScript Object Notation), a lightweight data-interchange format widely supported across various programming languages and platforms. This design choice ensures simplicity, flexibility, and ease of integration for developers utilizing the API.AuthenticationAccess to the API is authenticated using an API key mechanism. For now, each company needs an individual API key provided by The Swarm.The API key should be included in the request headers (as x-api-key header) for each API call to authorize access to the endpoints.EndpointURL: https://bee.theswarm.com/v2/profiles/network-mapperMethod: POSTDescription: This endpoint allows to query the relationship database using OpenSearch DSL to retrieve all connections in the network meeting the query criteria.
Key
Value
Content-Type
application/json
x-Api-Key
<YOUR_API_KEY>
Body ParametersThe request body must contain an OpenSearch DSL query to search for a subset of the network. In the example below, we query for connections working in a company identified by website domain.
profile_info.current_company_website - A valid website domain of the company you want to query relationships for. This is the key field that is used to filter connections.
You can include other fields and filters in the OpenSearch DSL query if you need to refine the results further (e.g., filtering by job title, location, etc.).Success Response (200 OK)When the query is successful, the API returns a list of connections in the following format.
connections: Team members who are connected to the profile.
connections.sources: Describes the ways the profile is connected to the team member. There can be multiple ways connecting two people. The type of connection is defined by connection.sources.origin and the schema of the elements depends on it. Below is the list of all values origin can currently take:
linkedin_connection
calendar_events
email_contact
manual_import
work_overlap
education_overlap
shared_investor
Filtering & Query CustomizationAs mentioned above, the endpoint accepts an OpenSearch query of any type, so it can be used to narrow the results down even further. E.g. you can refine the query to return only people with certain job titles at the company.For more information on The Swarm API search capabilities refer to our main documentation.Example OpenSearch DSL query: