---
title: "Count leads from supersearch"
method: POST
path: "/api/v2/supersearch-enrichment/count-leads-from-supersearch"
tags: ["SuperSearchEnrichment"]
---

# Count leads from supersearch

`POST /api/v2/supersearch-enrichment/count-leads-from-supersearch`

Count the number of leads matching a SuperSearch query without enriching them. This endpoint is intended to estimate lead availability before running an enrichment.


Requires one of the following scopes: `supersearch_enrichments:read`, `supersearch_enrichments:all`, `all:read`, `all:all`

## Request body

- object
  - `search_filters` object, required — Search filters to find leads.
    - `locations` union
      - union[] — Legacy format: Array of locations to include in the search. For new integrations, use the object format with include/exclude properties.
        - union
          - object
            - `place_id` string, required — Google Maps Place ID of the lead's location (https://developers.google.com/maps/documentation/places/web-service/place-id)
            - `label` string — Label of the lead's location
          - union
            - unknown
            - unknown
            - unknown
      - object — Locations to include or exclude in the search
        - `include` union[] — Locations to include in the search
          - union
            - object
              - …
            - union
              - …
        - `exclude` union[] — Locations to exclude from the search
          - union
            - object
              - …
            - union
              - …
    - `department` string[]
    - `level` string[]
    - `employeeCount` union[] — Employee count filters.
      - union
        - '0 - 25' | '25 - 100' | '100 - 250' | '250 - 1000' | '1K - 10K' | '10K - 50K' | '50K - 100K' | '> 100K' — Legacy format: Predefined employee count range
        - object — Custom employee count range
          - `op` string, required — Operation type.
          - `min` number — Minimum employee count (inclusive), used for "between" and "gte" operations
          - `max` number — Maximum employee count (inclusive), used for "between" and "lte" operations
    - `revenue` string[]
    - `news` string[]
    - `jobListing` string[] — Canonical filter for companies that are hiring for the specified job titles.
    - `jobListingFilter` string[] — Deprecated compatibility key for Job Listing filters. Use `jobListing` instead. If both keys are present, `jobListing` takes precedence.
    - `title` object
      - `include` string[] — Titles of the lead to include in the search
      - `exclude` string[] — Titles of the lead to exclude in the search
    - `name` string[] — Names of the lead to include in the search
    - `company_name` object
      - `include` string[] — Companies of the lead to include in the search
      - `exclude` string[] — Companies of the lead to exclude in the search
    - `look_alike` string — If set, the lead finder will find companies that are similar to the look-alike domain
    - `keyword_filter` object
      - `exclude` string
      - `include` string
    - `industry` object
      - `exclude` string[] — Industries of the lead company to exclude in the search
      - `include` string[]
    - `subIndustry` object
      - `exclude` string[] — Subindustries of the lead company to exclude in the search
      - `include` string[] — Subindustries of the lead company to include in the search
    - `domains` string[]
    - `funding_type` string[]
    - `signals` union[] — Filter leads by Autobound signal categories (e.g. job changes, traffic surges, LinkedIn activity). Leads matching ANY of the specified signals within the per-signal freshness window will be returned.
      - union
        - string — Signal category name. Uses the default 30-day freshness window.
        - object
          - `key` string, required — Signal category to filter by.
          - `period_days` number — Freshness window in days. Only leads whose most recent signal of this category is within this window are returned. Defaults to 30 if omitted.
          - `keywords` union
            - string[] — Legacy flat list of keyword tokens (OR-matched across every keyword index field for the category).
            - object — Per-field map of keyword tokens. Each property name is a keyword index field; each value is the list of tokens to OR-match within that field. Records must have at least one matching token in EACH selected field — fields act as additional filters. Example: `{ "objection_type": ["security"], "buying_stage": ["consideration"] }`.
    - `skip_owned_leads` boolean — If set, the lead finder will skip leads that are owned by the user
    - `show_one_lead_per_company` boolean — If set, the lead finder will show only one lead per company
    - `location_mode` 'contact' | 'company' — Whether to filter/display by contact location or company HQ location. Defaults to contact.
  - `skip_owned_leads` boolean — Skip leads that belong to the current workspace.
  - `show_one_lead_per_company` boolean — Return only one lead per company.

## Response `200`

Default Response

- object
  - `number_of_leads` number — Number of leads found for this specific search. A value of 0 indicates that no leads match the criteria. Values greater than 1,000,000 are returned as 1,000,000.

## Other responses

- `401` — This request is unauthorized (either the Authorization header is missing or invalid, or the API key has been revoked)
- `402` — Default Response
- `404` — The requested resource was not found
- `429` — Default Response

---

[API](https://skmtc.net/instantly/apis/api-explorer.md) · [All operations](https://skmtc.net/instantly/apis/api-explorer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instantly/api-explorer/versions/378d1e253fe7/schema)