Skip to main content
POST
/
v2
/
profiles
/
fetch
Fetch profiles with corresponding data
curl --request POST \
  --url https://bee.theswarm.com/v2/profiles/fetch \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "linkedinNames": [
    "<string>"
  ],
  "linkedinIds": [
    123
  ],
  "linkedinEntityIds": [
    "<string>"
  ],
  "fields": [
    "profile_info"
  ]
}
'
{
  "results": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "connections": [
        {
          "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "user_email": "<string>",
          "user_linkedin_name": "<string>",
          "created_at": "2023-11-07T05:31:56Z",
          "sources": [
            {
              "origin": "<string>",
              "network": "<string>"
            }
          ],
          "connection_strength": 123,
          "strength_normalized": 123,
          "manual_strength": 123
        }
      ],
      "lists": [
        {
          "id": "<string>",
          "name": "<string>",
          "status": "<string>"
        }
      ],
      "notes": [
        {
          "id": "<string>",
          "content": "<string>"
        }
      ],
      "tags": [
        {
          "id": "<string>",
          "name": "<string>"
        }
      ],
      "profile_info": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "full_name": "<string>",
        "first_name": "<string>",
        "last_name": "<string>",
        "headline": "<string>",
        "about": "<string>",
        "linkedin_url": "<string>",
        "work_email": "<string>",
        "personal_emails": [
          "<string>"
        ],
        "current_title": "<string>",
        "current_function": "<string>",
        "current_seniority": [
          "<string>"
        ],
        "current_company_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "current_company_name": "<string>",
        "current_company_logo_url": "<string>",
        "current_company_website": "<string>",
        "current_company_size": {
          "min": 123,
          "max": 123
        },
        "current_company_industry": "<string>",
        "current_company_location": "<string>",
        "current_company_linkedin_url": "<string>",
        "experience": [
          {
            "is_current": true,
            "company_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "company": {
              "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "canonical_name": "<string>",
              "name": "<string>",
              "founded": "2023-11-07T05:31:56Z",
              "industry": "<string>",
              "website": "<string>",
              "size": {
                "min": 123,
                "max": 123
              },
              "social_media": [
                {
                  "network": "<string>",
                  "id": "<string>",
                  "slug": "<string>",
                  "url": "<string>"
                }
              ],
              "locations": [
                {
                  "name": "<string>",
                  "city": "<string>",
                  "state": "<string>",
                  "country": "<string>",
                  "street_address": "<string>",
                  "postal_code": "<string>",
                  "headquarter": true
                }
              ],
              "industries": [
                "<string>"
              ],
              "websites": [
                "<string>"
              ],
              "workforce": {
                "headcount": 123
              }
            },
            "title": "<string>",
            "seniority": [
              "<string>"
            ],
            "function": "<string>",
            "location": [
              "<string>"
            ],
            "description": "<string>",
            "start_date": "2023-12-25",
            "end_date": "2023-12-25"
          }
        ],
        "current_location": "<string>",
        "other_locations": [
          "<string>"
        ],
        "skills": [
          "<string>"
        ],
        "education": [
          {
            "school": {
              "name": "<string>",
              "location": {
                "name": "<string>",
                "city": "<string>",
                "state": "<string>",
                "country": "<string>",
                "street_address": "<string>",
                "postal_code": "<string>"
              },
              "website": "<string>",
              "linkedin_url": "<string>",
              "linkedin_id": "<string>",
              "social_media": [
                {
                  "network": "<string>",
                  "id": "<string>",
                  "slug": "<string>",
                  "url": "<string>"
                }
              ]
            },
            "start_date": "2023-12-25",
            "end_date": "2023-12-25",
            "degrees": [
              "<string>"
            ],
            "majors": [
              "<string>"
            ],
            "minors": [
              "<string>"
            ],
            "activities": "<string>",
            "grade": "<string>",
            "description": "<string>"
          }
        ],
        "linkedin_experience_count": 123,
        "linkedin_education_count": 123,
        "social_media": [
          {
            "network": "<string>",
            "id": "<string>",
            "slug": "<string>",
            "url": "<string>"
          }
        ],
        "investor_data": {
          "description": "<string>",
          "type": [
            "<string>"
          ],
          "industry_focus": [
            "<string>"
          ],
          "stage_focus": [
            "<string>"
          ],
          "geo_focus": [
            "<string>"
          ],
          "check_size": [
            "<string>"
          ],
          "portfolio_companies": [
            {
              "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
            }
          ]
        },
        "smart_tags": [
          "<string>"
        ],
        "latest_role_change_at": "2023-12-25",
        "latest_company_change_at": "2023-12-25",
        "current_job_updated_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "created_at": "2023-11-07T05:31:56Z",
        "last_refresh_at": "2023-11-07T05:31:56Z",
        "current_company_websites": [
          "<string>"
        ],
        "current_company_industries": [
          "<string>"
        ],
        "certifications": [
          {
            "end_date": "<string>",
            "name": "<string>",
            "organization": "<string>",
            "start_date": "<string>"
          }
        ],
        "image_url": "<string>"
      },
      "found_by": {
        "ids": [
          "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        ],
        "linkedinNames": [
          "<string>"
        ],
        "linkedinIds": [
          123
        ],
        "linkedinEntityIds": [
          "<string>"
        ]
      }
    }
  ],
  "notFound": [
    "<string>"
  ]
}
Deprecated — July 15, EOD UTC. Migrate to Fetch Profile (v3).During the transition window, this endpoint reads from the legacy Postgres database. Some IDs returned by v2 search may not resolve here — fetch from v3 instead. Additional fields (e.g. tags) are not maintained in v2 during the transition. See the Migrating to v3 guide.
By default, the response contains the profile connections or team members that are connected to the profile. The API user may specify additional data about the profile in the fields object that accepts the following values:
connectionsList of team members who are connected to the given profile. The connection details are included (see Models > Profile)
tagsTags assigned to the profile
listsLists the profile is assigned to
notesList of notes assigned to the profile. Private notes are not included.
profile_infoDetailed profile data, e.g. work experience, education, etc.
Please note that investorData is no longer a valid field in fetch requests. This information is now available as investor_data nested within the profile_info object. For more details on this structure change, please refer to the Models > Profile. documentation.
To see a full response of the Fetch endpoint see Models > Profile

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
ids
string<uuid>[]
required

The Swarm profile IDs

​
linkedinNames
string[]

LinkedIn profile URL slugs

​
linkedinIds
integer[]

LinkedIn numeric profile IDs

​
linkedinEntityIds
string[]

LinkedIn alphanumeric entity IDs

​
fields
enum<string>[]
Minimum array length: 1
Available options:
profile_info,
connections,
tags,
lists,
notes,
investor_data

Response

A list of profiles with corresponding data

​
results
object[]
required

List of profiles with corresponding data

​
notFound
string[]

Identifiers (ids / linkedinNames / linkedinIds / linkedinEntityIds) not found