---
title: "Count companies"
method: GET
path: "/api/v1/companies/count"
tags: ["Companies"]
---

# Count companies

`GET /api/v1/companies/count`

## Request

- Base URL: `https://app.argorant.com`
- URL: `https://app.argorant.com/api/v1/companies/count`
- Auth: HTTP bearer

How many companies match your filters. Free.

| Cost | What it does | Key scopes |
| --- | --- | --- |
| Free | Reads only | `argorant:read_counts` |

## Query parameters

- `q` string
- `industries` string
- `industry` string
- `keywords` string
- `technologies` string
- `employee_range` '1-10' | '11-50' | '51-200' | '201-500' | '501-1000' | '1001-5000' | '5001-10000' | '10000+' | 'unknown'
- `company_name` string
- `company_domain` string
- `country` string
- `state` string
- `city` string
- `exclude_industries` string
- `exclude_industry` string
- `exclude_keywords` string
- `keyword_scope` 'company' | 'people' | 'any'
- `exclude_company_domain` string
- `exclude_country` string
- `exclude_state` string
- `exclude_city` string

## Headers

- `X-Request-Id` string

## Response `200`

OK

- object
  - `count` integer

## Other responses

- `401`: 401 Unauthorized. `unauthorized` when the API key is missing, wrong or revoked.
- `403`: 403 Forbidden. `scope_missing` when the key lacks argorant:read_counts.
- `429`: 429 Too many requests. `rate_limited` when too many requests this minute.

---

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