Skip to main content
POST
/
v1
/
data
/
agnt
/
companies
/
search
Search companies
curl --request POST \
  --url https://api.agntdata.dev/v1/data/agnt/companies/search \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": {
    "industry": "fintech",
    "headcount": [
      "51-200"
    ]
  },
  "page": 1
}
'
{
  "success": true,
  "data": {},
  "meta": {
    "costCents": 123,
    "purchasedBalanceCents": 123,
    "subscriptionRemainingCents": 123,
    "cached": true,
    "latencyMs": 123,
    "priceRange": {
      "minCents": 123,
      "maxCents": 123
    },
    "budgetCents": 123,
    "budgetCentsPerRecord": 123,
    "providersAttempted": 123,
    "fieldsReturned": [
      "<string>"
    ],
    "fieldsMissing": [
      "<string>"
    ],
    "records": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://agnt.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer token. Pass your agntdata API key as: Authorization: Bearer agnt_live_...

Body

application/json
​
filters
object

Filter object. Each entry is keyed by filter name and takes either { include?: string[], exclude?: string[] } for categorical filters or { min?, max? } for ranges. Searches that contain ONLY exclude filters are rejected — always pair with at least one positive filter. Common keys: company_industry ({ include/exclude } — e.g. { "include": ["Software Development"] }); company_headcount ({ min, max } — numeric employee count range, e.g. { "min": 1000 }); company_country ({ include/exclude } — ISO country names or codes); company_funding ({ stage: string[], funding_date: number-of-days, last_funding: { min, max }, total_funding: { min, max } }; amounts use suffix notation like "1M", "10M", "100M"); company_type ({ include/exclude } — e.g. ["Privately Held", "Public Company"]). For convenience, flat aliases are accepted and translated server-side: industry/industries → company_industry.include, country/countries → company_country.include, headcount_min/headcount_max → company_headcount.{min,max}. Top-level keys other than filters/page (e.g. limit) are ignored. Example: { "company_industry": { "include": ["Software Development"] }, "company_headcount": { "min": 1000 } }.

​
page
integer

Page number (25 results per page; max page = 1000).

Required range: x > 0
​
max_cost_cents
number
Required range: x >= 0

Response

Company search results.

​
success
enum<boolean>
required
Available options:
true
​
data
object
required
​
meta
object