AI Leads Engine

Find people and companies

Search the ZicReach directory. A search returns a count and a preview without contact details; import turns it into a new list, within your plan's row limit.

GET/v1/search/peopleSearch people POST/v1/search/people/importImport a people search GET/v1/search/companiesSearch companies POST/v1/search/companies/importImport a company search

Search people

GET/api/v1/search/people

Count and a 25-row preview. Filters are arrays: titles[]=CEO&countries[]=United Kingdom.

Any API key, read-only included.

Parameters

Name	Type	Description
`q` query	string	Free text: name, title or company.
`titles` query	string[]	Job titles, up to 12.
`seniorities` query	string[]	Any of owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern.
`countries` query	string[]	Countries, up to 12.
`industries` query	string[]	Industries, up to 12 (on plans with People search).
`companies` query	string[]	Company names or domains, up to 25.
`company_mode` query	string	With companies: current, previous or either. Default current.
`total` query	integer	How many people to take, up to your plan limit. Default 100.
`per_company` query	integer	At most this many per company. Default 10.

Errors

401Missing or invalid key
422Invalid input, or not ready; the body has message and an errors object, one entry per field
429More than 120 requests a minute

Request

curl https://app.zicreach.com/api/v1/search/people \
  -H "Authorization: Bearer zk_your_key"

Response200

{
    "data": {
        "total": 1840,
        "preview": [
            {
                "first_name": "Jane",
                "last_name": "Doe",
                "job_title": "Founder & CEO",
                "seniority": "Owner / founder",
                "company": "Example Ltd",
                "domain": "example.com",
                "location": "London, United Kingdom",
                "has_email": true
            }
        ]
    }
}

Import a people search

POST/api/v1/search/people/import

Runs the search and saves the results as a new list. Same filters as Search people, in the body.

Needs a read and write API key.

Body

Name	Type	Description
`list_name`	string	Name for the new list.
`q`	string	Free text: name, title or company.
`titles`	string[]	Job titles, up to 12.
`seniorities`	string[]	Any of owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern.
`countries`	string[]	Countries, up to 12.
`industries`	string[]	Industries, up to 12 (on plans with People search).
`companies`	string[]	Company names or domains, up to 25.
`company_mode`	string	With companies: current, previous or either. Default current.
`total`	integer	How many people to take, up to your plan limit. Default 100.
`per_company`	integer	At most this many per company. Default 10.

Errors

401Missing or invalid key
403Read-only key used for a change, or a key made by someone who is no longer an owner or admin
422Invalid input, or not ready; the body has message and an errors object, one entry per field
429More than 120 requests a minute

Request

curl -X POST https://app.zicreach.com/api/v1/search/people/import \
  -H "Authorization: Bearer zk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"list_name":"UK SaaS founders","q":"example"}'

Response201

{
    "data": {
        "list_id": "9d1c6a2e-4b7f-4e0a-9a51-2f8c3b6d7e10",
        "list_name": "UK SaaS founders",
        "matched": 100,
        "imported": 91,
        "duplicate": 4,
        "suppressed": 1,
        "unsendable": 4
    }
}

Search companies

GET/api/v1/search/companies

Count and a 25-row preview.

Any API key, read-only included.

Parameters

Name	Type	Description
`q` query	string	Free text: company name or domain.
`industries` query	string[]	Industries.
`countries` query	string[]	Countries.
`job_title` query	string	Companies hiring for this title.
`sizes` query	string[]	Employee bands: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.
`total` query	integer	How many companies to take, up to your plan limit. Default 100.

Errors

401Missing or invalid key
422Invalid input, or not ready; the body has message and an errors object, one entry per field
429More than 120 requests a minute

Request

curl https://app.zicreach.com/api/v1/search/companies \
  -H "Authorization: Bearer zk_your_key"

Response200

{
    "data": {
        "total": 312,
        "preview": [
            {
                "name": "Example Ltd",
                "domain": "example.com",
                "industry": "Software",
                "size": "51-200",
                "location": "London, United Kingdom",
                "open_roles": 6
            }
        ]
    }
}

Import a company search

POST/api/v1/search/companies/import

Saves the matching companies as a new list, one row per company.

Needs a read and write API key.

Body

Name	Type	Description
`list_name`	string	Name for the new list.
`q`	string	Free text: company name or domain.
`industries`	string[]	Industries.
`countries`	string[]	Countries.
`job_title`	string	Companies hiring for this title.
`sizes`	string[]	Employee bands: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.
`total`	integer	How many companies to take, up to your plan limit. Default 100.

Errors

401Missing or invalid key
403Read-only key used for a change, or a key made by someone who is no longer an owner or admin
422Invalid input, or not ready; the body has message and an errors object, one entry per field
429More than 120 requests a minute

Request

curl -X POST https://app.zicreach.com/api/v1/search/companies/import \
  -H "Authorization: Bearer zk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"list_name":"UK SaaS founders","q":"example"}'

Response201

{
    "data": {
        "list_id": "9d1c6a2e-4b7f-4e0a-9a51-2f8c3b6d7e10",
        "list_name": "Hiring SaaS companies",
        "matched": 100,
        "imported": 100,
        "duplicate": 0,
        "failed": 0
    }
}