Contact

Find people and enrich their emails (async)

Search for people matching your filters and enrich their emails in a single async job.

How it works:

  1. Submit search filters + max_contacts (how many contacts with emails you want, max 500 per call)
  2. Receive a task_id immediately
  3. Poll the GET endpoint with task_id for progress (with eta_seconds) and results
  4. For more than max_contacts, call again with the previous response's next_cursor

Pricing:

  • Search is free — you are never charged for people searched.
  • basic: 1.5 credits per found email · premium: 5 credits per found email.
  • You are charged ONLY for emails actually found. Worst-case credits are held up front (402 if insufficient).

Deduplication: pass exclude_lists to skip people you already own — they are not enriched and not charged. A companies list skips everyone at its domains.

post/public/api/v1/find-and-enrich

Request

  • Base URL: https://api.explee.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.explee.com/public/api/v1/find-and-enrich
  • Auth: APIKeyHeader (a scheme the document does not define)

Request body

company_linkedin_idsinteger[] nullable

Optional list of company LinkedIn IDs to restrict the search to these companies.

max_contactsinteger required

How many enriched contacts (found emails) you want. The search runs as wide as needed to reach this many found emails — you are charged ONLY for emails actually found, never for the search. Capped by your plan export limit.

preset'basic' | 'premium'

Quality preset: basic (1.5 credits per found email) or premium (5 credits per found email).

exclude_listsstring[] nullable

Ids of your dedup lists (see Deduplication endpoints). Results already present in these lists are excluded and never charged. People endpoints also accept companies lists: every person at a listed domain is excluded. When set, the free results zone does not apply. Max 100 lists / 500000 values combined per request.

cursorstring nullable

Pagination cursor. Omit for the first page; on later pages pass the next_cursor returned by the previous completed job (with the SAME filters/preset) to fetch the next batch.

Example request

{
  "company_filters": {
    "definition": "B2B SaaS company"
  },
  "max_contacts": 500,
  "people_filters": {
    "geo": [
      "US",
      "GB"
    ],
    "job_titles": [
      "Head of Sales",
      "VP Sales"
    ]
  },
  "preset": "basic"
}

Response

Successful Response

task_idstring required

Unique job identifier. Poll the GET endpoint with this ID for progress and results.

Example response

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000"
}

Changes

No recorded changes to this operation across all 1 revision of this API.