---
title: "Discover companies"
method: POST
path: "/v1/data/agnt/companies/discover"
tags: ["superagnt_ Lead APIs: Companies — Discover"]
---

# Discover companies

`POST /v1/data/agnt/companies/discover`

## Request

- Base URL: `https://api.superagnt.com`
- URL: `https://api.superagnt.com/v1/data/agnt/companies/discover`
- Auth: API key in header `Authorization`

Find companies matching a set of criteria. Pass either a natural-language `query` or structured `filters` (industry, headcount, location, technology, funding, keywords, …). Returns paginated company summaries.

## Request body

- CompaniesDiscoverRequest (unresolved $ref)

## Response `200`

Discovery results.

- object
  - `success` true, required
  - `data` CompaniesDiscoverResponse, required (unresolved $ref)
  - `meta` AgntMeta (unresolved $ref)

## Other responses

- `400`: Validation error.
- `401`: Unauthorized.

---

[API](https://skmtc.dev/superagnt/apis/superagnt-api.md) · [All operations](https://skmtc.dev/superagnt/apis/superagnt-api/llms.txt) · [OpenAPI document](https://skmtc.dev/superagnt/apis/superagnt-api/revisions/b2d8de30ccf0?raw)