Search people

Returns people ranked by relevance to a query.

post/v1/people/search

Request

Base URL
https://api.metal.ai
Auth
API key in header x-metal-client-id and API key in header x-metal-api-key

Request body

querystring required

The search query.

pageinteger

Page number, starting at 1.

limitinteger

Results per page.

Example request

{
  "query": "industrial automation suppliers"
}

Response

Ranked people results.

Example response

{
  "data": [
    {
      "id": "665f1c2a9b1e4a0012a3b4c5",
      "firstName": "Jordan",
      "lastName": "Rivera",
      "email": "jordan@example.com",
      "currentTitle": "Chief Executive Officer",
      "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"
          }
        ]
      }
    }
  ],
  "metadata": {
    "page": 1,
    "limit": 20,
    "totalCount": 134,
    "totalPages": 7
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.