Intellimatch

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.

Rate limit: 50 simultaneous requests.

Credit cost (credit-based plans), charged once the export is generated:

  • Companies: 1 finder credit per 10 companies returned, rounded up, in broad mode; 1 finder credit per company in targeted mode
  • 1 finder credit per contact found (find_contact)
  • 1 finder credit per email found (find_email)
  • 10 finder credits per phone number found (find_phone)
post/api/intellimatch/search

Request

  • Base URL
    https://app.findymail.com
  • URL
    https://app.findymail.com/api/intellimatch/search
  • Auth
    HTTP bearer

Request body

querystring required

The search query describing target companies.

limitinteger

The maximum number of companies to export (default: 100, max: 5000).

Example request

{
  "query": "SaaS companies in US with 50-200 employees",
  "limit": 100,
  "config": {
    "find_contact": true,
    "find_email": true,
    "target_job_titles": [
      [
        "RevOps"
      ],
      [
        "CEO",
        "CTO"
      ]
    ],
    "mode": "broad"
  }
}

Response

Ok

hashstring

Unique hash to track the export progress and retrieve results.

Example response

{
  "hash": "74ebbec924a9666053d234eecc685a1d73c699d1"
}

Changes