Skip to main content
POST
/
companies
/
fetch
Fetch companies with corresponding data
curl --request POST \
  --url https://bee.theswarm.com/companies/fetch \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "linkedinNames": [
    "<string>"
  ],
  "linkedinIds": [
    123
  ],
  "fields": [
    "company_info"
  ]
}
'
{
  "results": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "company_info": {
        "id": "<string>",
        "linkedin_slugs": [
          "<string>"
        ],
        "name": "<string>",
        "alternative_names": [
          "<string>"
        ],
        "description": "<string>",
        "summary": "<string>",
        "contact_info": {
          "email": "<string>",
          "phone": "<string>",
          "url": "<string>"
        },
        "canonical_name": "<string>",
        "founded": "2023-11-07T05:31:56Z",
        "industry": "<string>",
        "website": "<string>",
        "size": {
          "class": "<string>"
        },
        "workforce": [
          {
            "headcount": 123,
            "historical_headcount": [
              {
                "timestamp": 123,
                "count": 123
              }
            ],
            "size_class": "<string>"
          }
        ],
        "tech_stack": {
          "products": [
            "<string>"
          ]
        },
        "business_data": {
          "identifiers": {
            "stock_ticker": "<string>",
            "duns_code": "<string>",
            "cage_code": "<string>",
            "naics_code": "<string>"
          },
          "customer_types": [
            "<string>"
          ],
          "stock_exchange": "<string>",
          "is_acquired": true,
          "is_exited": true,
          "is_government": true,
          "is_non_profit": true,
          "is_shut_down": true,
          "is_startup": true,
          "is_stealth": true,
          "ownership_status": "<string>",
          "ownership_status_detailed": "<string>",
          "patent_count": 123,
          "financing_profile": {
            "status": "<string>",
            "ipo_date": "2023-11-07T05:31:56Z",
            "outstanding_shares": 123,
            "market_cap": 123
          }
        },
        "social_media": [
          {
            "network": "<string>",
            "id": "<string>",
            "slug": "<string>",
            "url": "<string>",
            "url_status": "<string>"
          }
        ],
        "locations": [
          {
            "name": "<string>",
            "country": "<string>",
            "is_primary": true
          }
        ],
        "logo_url": "<string>",
        "type": [
          "<string>"
        ],
        "specialities": [
          "<string>"
        ],
        "investments": [
          "<string>"
        ],
        "geography_focus": [
          "<string>"
        ],
        "funding": {
          "last_round": {
            "last_round_type": "<string>",
            "last_round_amount_usd": 123,
            "last_round_date": "2023-11-07T05:31:56Z",
            "last_round_investors": [
              {
                "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
                "kind": "<string>",
                "name": "<string>",
                "crunchbase_id": "<string>",
                "crunchbase_slug": "<string>"
              }
            ]
          },
          "rounds": [
            {
              "type": "<string>",
              "amount_usd": 123,
              "date": "2023-11-07T05:31:56Z",
              "investors": [
                {
                  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
                  "kind": "<string>",
                  "name": "<string>",
                  "crunchbase_id": "<string>",
                  "crunchbase_slug": "<string>"
                }
              ]
            }
          ],
          "total_funding_amount_usd": 123
        },
        "updated_at": "2023-11-07T05:31:56Z",
        "created_at": "2023-11-07T05:31:56Z",
        "data_updated_at": "2023-11-07T05:31:56Z"
      },
      "tags": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>"
        }
      ]
    }
  ],
  "notFound": [
    "<string>"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.theswarm.com/llms.txt

Use this file to discover all available pages before exploring further.

By default, the response contains basic company info and firmographic data. The API user may specify additional data about the company in the fields object that accepts the following values:
company_infoBasic company information and firmograhpic data (returned by default if no field is specified)
tagsTags assigned to the company
Please note that associated_profiles is no longer a valid field in fetch requests.
For more details see Models > Company.

Authorizations

​
x-api-key
string
header
required

Body

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

The Swarm company IDs

​
linkedinNames
string[]

LinkedIn company URL slugs

​
linkedinIds
integer[]

LinkedIn numeric company IDs

​
fields
enum<string>[]
Minimum array length: 1
Available options:
company_info,
tags

Response

A list of companies with corresponding data

​
results
object[]
required

List of companies with corresponding data

​
notFound
string[]

List of company identifiers (ids / linkedinNames / linkedinIds) that were not found