Skip to main content
POST
/
lead_finder
/
async
cURL
curl --request POST \
  --url https://app.bettercontact.rocks/api/v2/lead_finder/async \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "filters": {
    "company": {
      "include": [
        "<string>"
      ],
      "exclude": [
        "<string>"
      ]
    },
    "company_industry": {
      "include": [
        "<string>"
      ],
      "exclude": [
        "<string>"
      ]
    },
    "company_technology": {
      "include": [
        "<string>"
      ],
      "exclude": [
        "<string>"
      ]
    },
    "company_headcount_min": 5000000,
    "company_headcount_max": 5000000,
    "lead_fullname": {
      "include": [
        "<string>"
      ],
      "exclude": [
        "<string>"
      ]
    },
    "lead_linkedin_profile": {
      "include": [
        "<string>"
      ],
      "exclude": [
        "<string>"
      ]
    },
    "lead_department": {
      "include": [
        "<string>"
      ],
      "exclude": [
        "<string>"
      ]
    },
    "lead_function": {
      "include": [
        "<string>"
      ],
      "exclude": [
        "<string>"
      ]
    },
    "lead_skills": {
      "include": [
        "<string>"
      ],
      "exclude": [
        "<string>"
      ]
    },
    "lead_job_title": {
      "include": [
        "<string>"
      ],
      "exclude": [
        "<string>"
      ],
      "exact_match": true
    },
    "lead_location": {
      "include": [
        "<string>"
      ],
      "exclude": [
        "<string>"
      ]
    }
  },
  "max_leads": 100,
  "webhook": "<string>"
}
'
{
  "success": true,
  "message": "Lead finder request accepted.",
  "request_id": "bc39ffbfc24cf043b748"
}

Authorizations

X-API-Key
string
header
required

Body

application/json

Filters and parameters for lead finding

filters
object
required
max_leads
integer

Maximum number of leads to return

Example:

100

webhook
string | null

Optional URL to receive results automatically

Response

Lead finder request accepted

success
boolean
Example:

true

message
string
Example:

"Lead finder request accepted."

request_id
string
Example:

"bc39ffbfc24cf043b748"