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>",
        "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>"
          }
        ],
        "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",
                "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",
                  "name": "<string>",
                  "crunchbase_id": "<string>",
                  "crunchbase_slug": "<string>"
                }
              ]
            }
          ],
          "total_funding_amount_usd": 123
        },
        "updated_at": "2023-11-07T05:31:56Z",
        "data_updated_at": "2023-11-07T05:31:56Z",
        "industries": [
          "<string>"
        ],
        "websites": [
          "<string>"
        ],
        "Size": {
          "class": "<string>"
        }
      },
      "tags": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>"
        }
      ],
      "found_by": {
        "ids": [
          "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        ],
        "linkedinNames": [
          "<string>"
        ],
        "linkedinIds": [
          123
        ]
      }
    }
  ],
  "notFound": [
    "<string>"
  ]
}
Deprecated β€” July 15, EOD UTC. Migrate to Fetch Company (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 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