Search companies
curl --request POST \
--url https://api.metal.ai/v1/companies/search \
--header 'Content-Type: application/json' \
--header 'x-metal-api-key: <api-key>' \
--header 'x-metal-client-id: <api-key>' \
--data '
{
"query": "industrial automation suppliers",
"page": 1,
"limit": 20
}
'{
"data": [
{
"id": "665f1c2a9b1e4a0012a3b4c5",
"canonicalName": "Acme Industrials",
"alternativeNames": [
"<string>"
],
"website": "https://acme.example",
"description": "<string>",
"shortDescription": "<string>",
"sector": "Industrials",
"subsector": "<string>",
"industry": "<string>",
"location": {
"city": "<string>",
"state": "<string>",
"country": "<string>"
},
"companyType": "operating",
"externalId": "<string>",
"externalReference": {
"source": "<string>",
"id": "<string>"
},
"tags": [
"<string>"
],
"assignees": [
{
"id": "<string>",
"type": "<string>"
}
],
"custom": {},
"employeeCount": 450,
"ownershipStatus": "private",
"lastValuation": 123,
"lastRoundDate": "2023-12-25",
"lastAmountRaised": 123,
"totalMoneyRaised": 123,
"lastFinancials": {},
"enrichment": {
"subsector": [
{
"value": "Self-Funded Health Insurance / Third Party Administrator (TPA)",
"source": "CIM",
"confidence": 100,
"pinned": true,
"discoveredAt": "2026-02-14T10:00:00Z"
},
{
"value": "Third-Party Administrators (TPAs)",
"source": "Market Report",
"confidence": 57,
"pinned": false,
"discoveredAt": "2026-01-20T10:00:00Z"
}
]
},
"lastEnrichedAt": "2023-11-07T05:31:56Z",
"lastEnrichmentStartedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"metadata": {
"page": 1,
"limit": 20,
"totalCount": 134,
"totalPages": 7
}
}Search companies
Returns companies ranked by relevance to a query.
POST
/
v1
/
companies
/
search
Search companies
curl --request POST \
--url https://api.metal.ai/v1/companies/search \
--header 'Content-Type: application/json' \
--header 'x-metal-api-key: <api-key>' \
--header 'x-metal-client-id: <api-key>' \
--data '
{
"query": "industrial automation suppliers",
"page": 1,
"limit": 20
}
'{
"data": [
{
"id": "665f1c2a9b1e4a0012a3b4c5",
"canonicalName": "Acme Industrials",
"alternativeNames": [
"<string>"
],
"website": "https://acme.example",
"description": "<string>",
"shortDescription": "<string>",
"sector": "Industrials",
"subsector": "<string>",
"industry": "<string>",
"location": {
"city": "<string>",
"state": "<string>",
"country": "<string>"
},
"companyType": "operating",
"externalId": "<string>",
"externalReference": {
"source": "<string>",
"id": "<string>"
},
"tags": [
"<string>"
],
"assignees": [
{
"id": "<string>",
"type": "<string>"
}
],
"custom": {},
"employeeCount": 450,
"ownershipStatus": "private",
"lastValuation": 123,
"lastRoundDate": "2023-12-25",
"lastAmountRaised": 123,
"totalMoneyRaised": 123,
"lastFinancials": {},
"enrichment": {
"subsector": [
{
"value": "Self-Funded Health Insurance / Third Party Administrator (TPA)",
"source": "CIM",
"confidence": 100,
"pinned": true,
"discoveredAt": "2026-02-14T10:00:00Z"
},
{
"value": "Third-Party Administrators (TPAs)",
"source": "Market Report",
"confidence": 57,
"pinned": false,
"discoveredAt": "2026-01-20T10:00:00Z"
}
]
},
"lastEnrichedAt": "2023-11-07T05:31:56Z",
"lastEnrichmentStartedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"metadata": {
"page": 1,
"limit": 20,
"totalCount": 134,
"totalPages": 7
}
}Authorizations
The Client ID of your API key.
The secret value of your API key.
Body
application/json
⌘I