Skip to main content
There are several identifiers you can use to fetch a profile from The Swarm database:
  • Profile IDs (ids) previously received from Search endpoint
  • LinkedIn usernames (linkedinNames) - also known as public profile URL slugs
  • LinkedIn numeric IDs (linkedinIds) - also known as member IDs
  • LinkedIn alphanumeric entity IDs (linkedinEntityIds)
Fetching profiles using a combination of different identifiers is supported and returns a unified list of results. 
curl \
--location 'https://bee.theswarm.com/v2/profiles/fetch' \
--header 'Content-Type: application/json' \
--header 'x-api-key: $API_KEY' \
--data \
`{
  "ids": [
    "569a18b6-6a04-4728-9034-ad6ae0537f09",
    "41dfd52f-e9da-4381-80a2-b514cf75c134"
  ],
  "linkedinNames": [
    "michal-bil"
  ],
  "linkedinIds": [
    "7125957"
  ],
  "linkedinEntityIds": [
    "ACoAAABsu8UBWktgug9TYQMXLNK3ypLlA0tWUuY"
  ]
}`
By default the Fetch endpoint returns the connectors or team members connected to a given profile. If there is no team members connected to a profile the connections object is an empty array. In the example below, the first profile is connected to one of the team members; the second one has no connectors. 
curl \
--location 'https://bee.theswarm.com/v2/profiles/fetch' \
--header 'Content-Type: application/json' \
--header 'x-api-key: $API_KEY' \
--data \
`{
  "ids": [
    "569a18b6-6a04-4728-9034-ad6ae0537f09",
    "b8d4ba05-5158-4d80-a0a7-c8e650f7c95c"
  ]
}` 

{
  "results": [
    {
      "id": "b8d4ba05-5158-4d80-a0a7-c8e650f7c95c",
      "connections": [
        {
          "user_id": "68576a63-c8c3-4c92-88e8-b89a532ae3fa",
          "user_email": "[email protected]",
          "user_linkedin_name": "",
          "created_at": "2024-03-22T15:15:17.525907Z",
          "sources": [
            {
              "origin": "plugin",
              "network": "linkedin"
            }
          ],
          "connection_strength": 0.1084125480166015,
          "manual_strength": null,
          "strength_normalized": 1
        }
      ]
    },
    {
      "id": "569a18b6-6a04-4728-9034-ad6ae0537f09",
      "connections": []
    }
  ]
}