The Swarm
Connect to The Swarm to search profiles and companies, fetch social posts, map networks, and inspect credits usage.
Authentication
| Method | Kind | Status | Details |
|---|---|---|---|
| API Key | api_key | available | — |
Call a tool
import { createClient } from "@open-connector/sdk";const oc = createClient({ baseUrl: "https://api.openconnector.dev", apiKey: process.env.OPEN_CONNECTOR_API_KEY!,});const result = await oc.executeTool({ slug: "THE_SWARM_ADD_CONNECTOR", connectedAccountId: "conn_...", arguments: { /* match this tool's input schema */ },});import Composio from "@composio/client";const composio = new Composio({ baseURL: "https://api.openconnector.dev/composio", apiKey: process.env.OPEN_CONNECTOR_API_KEY!,});const result = await composio.tools.execute("THE_SWARM_ADD_CONNECTOR", { connected_account_id: "conn_...", arguments: { /* match this tool's input schema */ },});oc tools execute THE_SWARM_ADD_CONNECTOR --data '{ }'Tool catalog
Available tools
26 callable operations
Add connector(s) to the teamTHE_SWARM_ADD_CONNECTORAdd one or more LinkedIn users as connectors to the teamConnection
Add one or more LinkedIn users as connectors to the team
Authentication
Connected account requiredTags
Aggregate profile field valuesTHE_SWARM_AGGREGATE_PROFILESReturn distinct values for a single profile field matching a text query (e.g. autocomplete for locations or current job titles).Connection
Return distinct values for a single profile field matching a text query (e.g. autocomplete for locations or current job titles).
Authentication
Connected account requiredTags
Create a child teamTHE_SWARM_CREATE_TEAMCreate a new child team under the authenticated teamConnection
Create a new child team under the authenticated team
Authentication
Connected account requiredTags
Fetch companies with corresponding dataTHE_SWARM_FETCH_COMPANIESFetch companies with corresponding data (e.g. tags)Connection
Fetch companies with corresponding data (e.g. tags)
Authentication
Connected account requiredTags
Fetch companies with corresponding dataTHE_SWARM_FETCH_COMPANIES_V3Fetch companies with corresponding data (e.g. tags)Connection
Fetch companies with corresponding data (e.g. tags)
Authentication
Connected account requiredTags
Fetch profiles with corresponding dataTHE_SWARM_FETCH_PROFILESFetch profiles with corresponding data (e.g. connections, lists, tags)Connection
Fetch profiles with corresponding data (e.g. connections, lists, tags)
Authentication
Connected account requiredTags
Fetch profiles with corresponding dataTHE_SWARM_FETCH_PROFILES_V3Fetch profiles with corresponding data (e.g. lists, tags)Connection
Fetch profiles with corresponding data (e.g. lists, tags)
Authentication
Connected account requiredTags
Get company postsTHE_SWARM_GET_COMPANY_POSTSFetch LinkedIn posts published by a companyConnection
Fetch LinkedIn posts published by a company
Authentication
Connected account requiredTags
Get credits usageTHE_SWARM_GET_CREDITS_USAGERetrieve your team's current billing period credit usage. The API identifies your team from the API key, fetches the meter usage for the active billing period, and returns the number of credits already consumed.Connection
Retrieve your team's current billing period credit usage. The API identifies your team from the API key, fetches the meter usage for the active billing period, and returns the number of credits already consumed.
Authentication
Connected account requiredTags
Get partner network mapping statusTHE_SWARM_GET_PARTNER_NETWORK_STATUSCheck the status of an async partner network mapping taskConnection
Check the status of an async partner network mapping task
Authentication
Connected account requiredTags
Network Mapper (Partner) StatusTHE_SWARM_GET_PARTNER_NETWORK_STATUS_V3Poll the status of a long-running Network Mapper (Partner) v3 task. Partner permission required.Connection
Poll the status of a long-running Network Mapper (Partner) v3 task. Partner permission required.
Authentication
Connected account requiredTags
Get post commentsTHE_SWARM_GET_POST_COMMENTSFetch comments on a LinkedIn postConnection
Fetch comments on a LinkedIn post
Authentication
Connected account requiredTags
Get post reactionsTHE_SWARM_GET_POST_REACTIONSFetch reactions on a LinkedIn postConnection
Fetch reactions on a LinkedIn post
Authentication
Connected account requiredTags
Get post resharesTHE_SWARM_GET_POST_RESHARESFetch reshares of a LinkedIn postConnection
Fetch reshares of a LinkedIn post
Authentication
Connected account requiredTags
Get profile postsTHE_SWARM_GET_PROFILE_POSTSFetch LinkedIn posts published by a personConnection
Fetch LinkedIn posts published by a person
Authentication
Connected account requiredTags
Fetch a refreshed profileTHE_SWARM_GET_REFRESHED_PROFILEFetch up-to-date profile data for a given LinkedIn URL slugConnection
Fetch up-to-date profile data for a given LinkedIn URL slug
Authentication
Connected account requiredTags
MCP endpointTHE_SWARM_MCPModel Context Protocol (MCP) endpoint for AI assistant integrationsConnection
Model Context Protocol (MCP) endpoint for AI assistant integrations
Authentication
Connected account requiredTags
Find connected profiles (network mapper)THE_SWARM_NETWORK_MAPPERFind connected profiles, with it's connection detailsConnection
Find connected profiles, with it's connection details
Authentication
Connected account requiredTags
Get network mapper task statusTHE_SWARM_NETWORK_MAPPER_TASK_STATUSCheck the status of a network mapper task started by POST /v2/profiles/network-mapperConnection
Check the status of a network mapper task started by POST /v2/profiles/network-mapper
Authentication
Connected account requiredTags
Trigger partner network mappingTHE_SWARM_POST_PARTNER_NETWORKInitiate network mapping for a given company. Returns data immediately if already mapped, or returns a task ID to poll for results.Connection
Initiate network mapping for a given company. Returns data immediately if already mapped, or returns a task ID to poll for results.
Authentication
Connected account requiredTags
Network Mapper (Partner) — v3THE_SWARM_POST_PARTNER_NETWORK_V3Partner-permission endpoint for mapping connections across the partner network. Calls from API keys not tied to a team with the partner permission in Stripe return 403 Forbidden. Costs 1 credit per non-empty response.Connection
Partner-permission endpoint for mapping connections across the partner network. Calls from API keys not tied to a team with the partner permission in Stripe return 403 Forbidden. Costs 1 credit per non-empty response.
Authentication
Connected account requiredTags
RelationshipsTHE_SWARM_RELATIONSHIPS_V3Find connected profiles with their connection details. Renamed from Network Mapper in v3.Connection
Find connected profiles with their connection details. Renamed from Network Mapper in v3.
Authentication
Connected account requiredTags
Search for companies idsTHE_SWARM_SEARCH_COMPANIESSearch for companies ids using the [ElasticSearch Query DSL](https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl.html) formatConnection
Search for companies ids using the [ElasticSearch Query DSL](https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl.html) format
Authentication
Connected account requiredTags
Search for companies idsTHE_SWARM_SEARCH_COMPANIES_V3Search for companies ids using the [ElasticSearch Query DSL](https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl.html) formatConnection
Search for companies ids using the [ElasticSearch Query DSL](https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl.html) format
Authentication
Connected account requiredTags
Search for profiles idsTHE_SWARM_SEARCH_PROFILESSearch for profiles ids using the [ElasticSearch Query DSL](https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl.html) formatConnection
Search for profiles ids using the [ElasticSearch Query DSL](https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl.html) format
Authentication
Connected account requiredTags
Search for profiles idsTHE_SWARM_SEARCH_PROFILES_V3Search for profiles ids using the [ElasticSearch Query DSL](https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl.html) formatConnection
Search for profiles ids using the [ElasticSearch Query DSL](https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl.html) format
Authentication
Connected account requiredTags