---
title: "Search Leads"
method: POST
path: "/v1/search"
tags: ["search"]
---

# Search Leads

`POST /v1/search`

## Request

- Base URL: `https://leads.compuute.se` (the document declares no server; this is the origin it was published from)
- URL: `https://leads.compuute.se/v1/search`
- Auth: none declared

Search and retrieve enriched leads matching ICP criteria.

Supports idempotent retries via the `Idempotency-Key` header (UUID).
Same key within 24 h returns the cached result without re-charging quota.

## Headers

- `Idempotency-Key` string, nullable
- `X-API-Key` string, nullable

## Request body

- SearchRequest
  - `criteria` SearchCriteria, required
    - `industries` Industry[], nullable
    - `stages` Stage[], nullable
    - `regions` Region[], nullable
    - `min_employees` integer, nullable
    - `min_icp_score` integer
    - `min_buying_intent` integer
    - `tech_stack_contains` string[], nullable
    - `max_age_days` integer
  - `limit` integer
  - `offset` integer
  - `sort_by` string

## Response `200`

Successful Response

- SearchResponse
  - `leads` Lead[], required
    - `lead_id` string, uuid, required
    - `company_name` string, required
    - `website` string, nullable
    - `industry` 'AI' | 'Blockchain' | 'Fintech' | 'Security' | 'Healthcare' | 'DevTools' | 'Other', required
    - `sub_industry` string, nullable
    - `stage` 'Pre-seed' | 'Seed' | 'Series A' | 'Series B' | 'Series C+' | 'Public' | 'Unknown', required
    - `estimated_employees` string, nullable
    - `location` Location, required
      - `country` string, required
      - `region` 'EU' | 'US' | 'APAC' | 'MENA' | 'Other', required
      - `city` string, nullable
    - `tech_stack_signals` string[]
    - `funding_signals` FundingSignals
      - `last_round_type` string, nullable
      - `estimated_amount` string, nullable
      - `date` string, nullable
    - `buying_signals` BuyingSignals
      - `hiring` boolean
      - `recent_funding` boolean
      - `product_launch` boolean
      - `expansion` boolean
    - `icp_score` integer, required
    - `buying_intent_score` integer, required
    - `icp_tags` string[]
    - `summary` string, nullable
    - `confidence` integer, required
    - `data_sources` string[]
    - `enriched_at` string, date-time, required
  - `total_count` integer, required
  - `returned_count` integer, required
  - `cost` CostInfo, required
    - `leads_charged` integer, required
    - `price_per_lead` number, required
    - `total_usd` number, required
  - `pagination` Pagination, required
    - `offset` integer, required
    - `limit` integer, required
    - `has_more` boolean, required

## Other responses

- `422`: Validation Error

---

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