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>"
]
}Endpoints (v2 β deprecated June 30)
Fetch Company
This endpoint offers seamless access to detailed information about Companies stored in our internal database. Whether youβre looking to retrieve specific company details for analysis, integration, or other purposes, the Fetch Company endpoint provides a straightforward solution. Simply provide the company ID, and this endpoint will return comprehensive data about the specified Company.
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.fields object that accepts the following values:
company_info | Basic company information and firmograhpic data (returned by default if no field is specified) |
tags | Tags assigned to the company |
Please note that
associated_profiles is no longer a valid field in fetch requests.Authorizations
Body
application/json
Was this page helpful?
βI

