Fetch endpoint

These examples target the Fetch Profile and Fetch Company endpoints.

Identifier types

You can fetch a profile using any of the following identifiers, or a combination of them:

ids — Profile IDs previously returned by the Search endpoint
linkedin_names — LinkedIn usernames (public profile URL slugs)
linkedin_ids — LinkedIn numeric member IDs
linkedin_entity_ids — LinkedIn alphanumeric entity IDs

Combining identifiers is supported and returns a unified list of results.

curl --location 'https://bee.theswarm.com/v3/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"
    ],
    "linkedin_names": [
      "michal-bil"
    ],
    "linkedin_ids": [
      "7125957"
    ],
    "linkedin_entity_ids": [
      "ACoAAABsu8UBWktgug9TYQMXLNK3ypLlA0tWUuY"
    ]
  }'

Selecting fields

By default, only basic profile data is returned. Use the fields array to request additional data — pass profile_info for the full record, plus tags or lists as needed.

Fetch full profile data

curl --location 'https://bee.theswarm.com/v3/profiles/fetch' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: $API_KEY' \
  --data '{
    "ids": ["569a18b6-6a04-4728-9034-ad6ae0537f09"],
    "fields": ["profile_info"]
  }'

Fetch with tags and lists

curl --location 'https://bee.theswarm.com/v3/profiles/fetch' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: $API_KEY' \
  --data '{
    "ids": ["569a18b6-6a04-4728-9034-ad6ae0537f09"],
    "fields": ["profile_info", "tags", "lists"]
  }'

Bulk fetch

Fetch up to 1000 profiles per call. Each returned profile counts as 1 credit — see Credits & Usage.

curl --location 'https://bee.theswarm.com/v3/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",
      "41dfd52f-e9da-4381-80a2-b514cf75c134"
    ],
    "fields": ["profile_info"]
  }'

Fetching companies

The Company Fetch endpoint follows the same pattern with company_info as the default field.

curl --location 'https://bee.theswarm.com/v3/companies/fetch' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: $API_KEY' \
  --data '{
    "ids": ["09d9c510-c9f6-4c6e-9e62-fe5fedbeda87"],
    "fields": ["company_info", "tags"]
  }'

Example queries

Sample data

Tools

Identifier types

Selecting fields

Fetch full profile data

Fetch with tags and lists

Bulk fetch

Fetching companies

​Identifier types

​Selecting fields

​Fetch full profile data

​Fetch with tags and lists

​Bulk fetch

​Fetching companies

Identifier types

Selecting fields

Fetch full profile data

Fetch with tags and lists

Bulk fetch

Fetching companies