Get lead search

Check an Intellimatch lead search and read its results once it is done.

GET https://cotlet.dev/api/v1/findymail/lead-search

read

Returns the status first: pending, processing, success, failed or not_found. While it is processing, it adds progress and the counts of finished and pending jobs. When the status is success, it also returns the rows with company, domain, description, employee count range, industries, country, match score and the contact found, with page numbers. Checking the status and reading results are free.

Parameters

Parameters: get_lead_search
NameTypeDescription
hash string required string Hash returned by start_lead_search.
page integer integer Results page, starting at 1.
per_page integer integer Rows per page, up to 500.

Request

cURL
curl "https://cotlet.dev/api/v1/findymail/lead-search?hash=hash" \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("findymail", "get_lead_search", {"hash":"hash"})
Node.js
const result = await cotlet.call('findymail', 'get_lead_search', {"hash":"hash"});
CLI
cotlet call findymail get_lead_search --data '{"hash":"hash"}'

Example response

JSON

{
  "hash": "f3b9a1c27d5e4086",
  "status": "success",
  "data": [
    {
      "company_name": "Northwind Logistics",
      "domain": "northwind.com",
      "employee_count_range": "51-200",
      "industries": [
        "Marketing services"
      ],
      "country": "DE",
      "match_score": 94,
      "contact_name": "Dana Whitfield",
      "contact_email": "dana@northwind.com",
      "contact_job_title": "Head of Growth"
    },
    {
      "company_name": "Globex",
      "domain": "globex.co",
      "employee_count_range": "11-50",
      "industries": [
        "Advertising"
      ],
      "country": "NL",
      "match_score": 88,
      "contact_name": "Luis Ortega",
      "contact_email": "luis@globex.co",
      "contact_job_title": "VP Marketing"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 100,
    "total": 200
  }
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.