---
title: "Search leads"
method: POST
path: "/api/intellimatch/search"
tags: ["Intellimatch"]
---

# Search leads

`POST /api/intellimatch/search`

Create an Intellimatch search task.

Intellimatch is Findymail’s intelligent company search tool that lets you build highly targeted lead lists using plain language queries.

Instead of manually applying filters or reviewing websites one by one, Intellimatch uses real-time semantic search to find the best-fit companies and contacts.

The API responds immediately with a `hash` identifying the task for polling completion status.

Please check https://help.findymail.com/en/article/what-is-supported-in-intellimatch-15s0u10/ for more information about what is supported or not.

## Request body

- object
  - `query` string, required — The search query describing target companies.
  - `limit` integer — The maximum number of companies to export (default: 100, max: 5000).
  - `config` object — Export configuration (all fields are optional).
    - `find_contact` boolean — Whether to find contacts (default: false).
    - `find_email` boolean — Whether to enrich contacts with email. (1 credit per email found) (default: false).
    - `find_phone` boolean — Whether to enrich contacts with phone number (10 credits per phone number found) (default: false).
    - `target_job_titles` array[] — Ordered priority tiers of target job titles, each tier a list of equivalent titles: the search tries tier 1 first and falls back to the next tier only if no match is found (3 tiers max: a request with more is rejected). A flat list of titles is still accepted and treated as a single tier. Variations with the same intent (eg. "CEO" and "Chief Executive Officer") are already handled. (default: [["CEO"]]).
      - string[]
    - `lead_list_id` integer — Lead list ID to add contacts to.
    - `mode` string — Export mode: "broad" or "targeted" (default: "broad").
    - `require_email` boolean — Only return companies where an email was found. Requires find_contact and find_email to be true. Companies without email are excluded and not charged. (default: false).
    - `add_to_exclusion_list` boolean — Add exported companies to exclusion list (default: false).
    - `exclusion_list_id` integer — Exclusion list ID where to add domains when add_to_exclusion_list is true.
    - `exclusion_filter_list_ids` integer[] — List of exclusion list IDs to filter results (default: [0] = global exclusion list, [-1] = no filter).

## Response `200`

Ok

- object
  - `hash` string — Unique hash to track the export progress and retrieve results.

## Other responses

- `401` — Unauthenticated
- `422` — Validation failed
- `423` — Subscription issue
- `429` — Too Many Attempts

---

[API](https://skmtc.net/findymail/apis/findymail-api-documentation.md) · [All operations](https://skmtc.net/findymail/apis/findymail-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/findymail/findymail-api-documentation/revisions/ae7fddf16bf9/schema)