Search Contacts API

curl -X POST "https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-contacts?api_key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": 10}'

{
    "success": true,
    "message": "Contacts searched successfully",
    "data": {
        "list": [
            {
                "id": "5f22b0e8cff47e0001616f81",
                "firstName": "Orhan",
                "lastName": "Demiri",
                "fullName": "Orhan Demiri",
                "title": "Generalagentur Agenturleiter",
                "company": {
                    "name": "Gothaer",
                    "website": "gothaer.de"
                },
                "department": ["Sales"],
                "level": "Staff",
                "industry": "Financial Services",
                "subIndustry": "",
                "companyHeadCount": "1K - 10K",
                "companyRevenue": "> $1B",
                "country": "Germany",
                "state": "",
                "city": "",
                "email": "random@example.com",
                "linkedin": "linkedin.com/random_data",
                "emailDeliverability": 0.95,
                "address": "Germany"
            },
            {
                "id": "5f22b1a0cff47e000161b01f",
                "firstName": "Tim",
                "lastName": "Ziegler",
                "fullName": "Tim Ziegler",
                "title": "Director of Sales and Business Development",
                "company": {
                    "name": "soluzione Script GmbH",
                    "website": "soluzione.de"
                },
                "department": ["Sales"],
                "level": "Director-Level",
                "industry": "Education",
                "subIndustry": "E-Learning",
                "companyHeadCount": "25 - 100",
                "companyRevenue": "$1 - 10M",
                "country": "Germany",
                "state": "Bavaria",
                "city": "Bavaria",
                "email": "random@example.com",
                "linkedin": "linkedin.com/random_data",
                "emailDeliverability": 0.95,
                "address": "Bavaria"
            }
        ],
        "scroll_id": "FGluY2x1ZGVfY29udGV4dF91dWlkDXF1ZXJ5QW5kRmV0Y2gBFkh5d0FSVjZaUXlpbzdWYWkxRV9DNGcAAAAAADUQGhZlT2V0Z0ptSVNyYWQwbk9kYTFsRXhB",
        "filter_id": 327105,
        "total_count": 16064669
    }
}

{
    "statusCode": 401,
    "success": false,
    "message": "Unauthorized",
    "error": "API key is required"
}

POST

api

search-email-leads

search-contacts

curl -X POST "https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-contacts?api_key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": 10}'

{
    "success": true,
    "message": "Contacts searched successfully",
    "data": {
        "list": [
            {
                "id": "5f22b0e8cff47e0001616f81",
                "firstName": "Orhan",
                "lastName": "Demiri",
                "fullName": "Orhan Demiri",
                "title": "Generalagentur Agenturleiter",
                "company": {
                    "name": "Gothaer",
                    "website": "gothaer.de"
                },
                "department": ["Sales"],
                "level": "Staff",
                "industry": "Financial Services",
                "subIndustry": "",
                "companyHeadCount": "1K - 10K",
                "companyRevenue": "> $1B",
                "country": "Germany",
                "state": "",
                "city": "",
                "email": "random@example.com",
                "linkedin": "linkedin.com/random_data",
                "emailDeliverability": 0.95,
                "address": "Germany"
            },
            {
                "id": "5f22b1a0cff47e000161b01f",
                "firstName": "Tim",
                "lastName": "Ziegler",
                "fullName": "Tim Ziegler",
                "title": "Director of Sales and Business Development",
                "company": {
                    "name": "soluzione Script GmbH",
                    "website": "soluzione.de"
                },
                "department": ["Sales"],
                "level": "Director-Level",
                "industry": "Education",
                "subIndustry": "E-Learning",
                "companyHeadCount": "25 - 100",
                "companyRevenue": "$1 - 10M",
                "country": "Germany",
                "state": "Bavaria",
                "city": "Bavaria",
                "email": "random@example.com",
                "linkedin": "linkedin.com/random_data",
                "emailDeliverability": 0.95,
                "address": "Bavaria"
            }
        ],
        "scroll_id": "FGluY2x1ZGVfY29udGV4dF91dWlkDXF1ZXJ5QW5kRmV0Y2gBFkh5d0FSVjZaUXlpbzdWYWkxRV9DNGcAAAAAADUQGhZlT2V0Z0ptSVNyYWQwbk9kYTFsRXhB",
        "filter_id": 327105,
        "total_count": 16064669
    }
}

{
    "statusCode": 401,
    "success": false,
    "message": "Unauthorized",
    "error": "API key is required"
}

This endpoint requires authentication via API key passed as a query parameter (api_key).

Query Parameters

api_key

string

required

Your SmartLead API key for authentication

Request Body

The request body must be JSON. limit is required and must be between 1 and 500. All array parameters have a maximum of 2000 items each.

limit

number

required

Number of contacts to return (1–500)

name

string[]

Filter by full name (max 2000 items)

firstName

string[]

Filter by first name (max 2000 items)

lastName

string[]

Filter by last name (max 2000 items)

title

string[]

Filter by job title (max 2000 items)

excludeTitle

string[]

Exclude contacts with these titles (max 2000 items)

excludeCompany

string[]

Exclude these companies (max 2000 items)

excludeCompanyDomain

string[]

Exclude these company domains (max 2000 items)

includeTitle

string[]

Include only these titles (max 2000 items)

includeCompany

string[]

Include only these companies (max 2000 items)

includeCompanyDomain

string[]

Include only these company domains (max 2000 items)

department

string[]

Filter by department (max 2000 items)

level

string[]

Filter by seniority level (max 2000 items)

companyName

string[]

Filter by company name (max 2000 items)

companyDomain

string[]

Filter by company domain (max 2000 items)

companyKeyword

string[]

Filter by company keyword (max 2000 items)

companyHeadCount

string[]

Filter by company headcount range (max 2000 items)

companyRevenue

string[]

Filter by company revenue (max 2000 items)

companyIndustry

string[]

Filter by industry (max 2000 items)

companySubIndustry

string[]

Filter by sub-industry (max 2000 items)

city

string[]

Filter by city (max 2000 items)

state

string[]

Filter by state (max 2000 items)

country

string[]

Filter by country (max 2000 items)

dontDisplayOwnedContact

boolean

Exclude contacts already owned

scroll_id

string

Pagination scroll ID for next page

titleExactMatch

boolean

Match title exactly

companyExactMatch

boolean

Match company exactly

companyDomainExactMatch

boolean

Match company domain exactly

curl -X POST "https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-contacts?api_key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": 10}'

Response Codes

200

Success

Request successful

400

Bad Request

401

Unauthorized

500

Internal Server Error

{
    "success": true,
    "message": "Contacts searched successfully",
    "data": {
        "list": [
            {
                "id": "5f22b0e8cff47e0001616f81",
                "firstName": "Orhan",
                "lastName": "Demiri",
                "fullName": "Orhan Demiri",
                "title": "Generalagentur Agenturleiter",
                "company": {
                    "name": "Gothaer",
                    "website": "gothaer.de"
                },
                "department": ["Sales"],
                "level": "Staff",
                "industry": "Financial Services",
                "subIndustry": "",
                "companyHeadCount": "1K - 10K",
                "companyRevenue": "> $1B",
                "country": "Germany",
                "state": "",
                "city": "",
                "email": "random@example.com",
                "linkedin": "linkedin.com/random_data",
                "emailDeliverability": 0.95,
                "address": "Germany"
            },
            {
                "id": "5f22b1a0cff47e000161b01f",
                "firstName": "Tim",
                "lastName": "Ziegler",
                "fullName": "Tim Ziegler",
                "title": "Director of Sales and Business Development",
                "company": {
                    "name": "soluzione Script GmbH",
                    "website": "soluzione.de"
                },
                "department": ["Sales"],
                "level": "Director-Level",
                "industry": "Education",
                "subIndustry": "E-Learning",
                "companyHeadCount": "25 - 100",
                "companyRevenue": "$1 - 10M",
                "country": "Germany",
                "state": "Bavaria",
                "city": "Bavaria",
                "email": "random@example.com",
                "linkedin": "linkedin.com/random_data",
                "emailDeliverability": 0.95,
                "address": "Bavaria"
            }
        ],
        "scroll_id": "FGluY2x1ZGVfY29udGV4dF91dWlkDXF1ZXJ5QW5kRmV0Y2gBFkh5d0FSVjZaUXlpbzdWYWkxRV9DNGcAAAAAADUQGhZlT2V0Z0ptSVNyYWQwbk9kYTFsRXhB",
        "filter_id": 327105,
        "total_count": 16064669
    }
}

{
    "statusCode": 401,
    "success": false,
    "message": "Unauthorized",
    "error": "API key is required"
}

Manage Client API Keys Get Contacts API

⌘I

Campaign Management

Campaign Leads

Campaign Webhooks

Campaign Statistics

Lead Management

Lead Notes

Lead Tasks

Lead Tags

Lead Lists

Email Account Management

Email Account Tags

Master Inbox

Smart Delivery

Smart Senders

Webhooks

Global Analytics

Utilities

Client Management

Smart Prospect

Query Parameters

Request Body

Response Codes

​Query Parameters

​Request Body

​Response Codes

Query Parameters

Request Body

Response Codes