Skip to main content

​
GET /api/v1/public/lead-lists/:id/leads/

Retrieve leads from a specific lead list with optional filtering, sorting, and pagination. Returns prospects for PEOPLE lists or companies for COMPANY lists. Auth: X-API-Key

​
Path Parameters

  • id (integer, required): Lead list ID

​
Query Parameters

ParameterTypeRequiredDefaultDescription
pageintegerNo1Page number for pagination
page_sizeintegerNo25Number of results per page
sort_fieldstringNoidField to sort by
sort_directionstringNoascSort direction (asc or desc)
You can also add any filter parameters as query strings (e.g., ?job_title=CEO&location=US).

​
Response (People List)

{
  "success": true,
  "search_type": "PEOPLE",
  "total_count": 150,
  "page": 1,
  "page_size": 25,
  "prospects": [
    {
      "id": 12345,
      "first_name": "John",
      "last_name": "Doe",
      "email": "john.doe@company.com",
      "phone_number": "+1234567890",
      "linkedin_profile_url": "https://linkedin.com/in/johndoe",
      "job_title": "CEO",
      "location": "San Francisco, CA",
      "headline": "CEO at Tech Company",
      "company": {
        "id": 678,
        "name": "Tech Company",
        "website_url": "https://techcompany.com",
        "linkedin_url": "https://linkedin.com/company/techcompany",
        "industry": "Technology",
        "location": "San Francisco, CA",
        "amount_of_employees": "51-200"
      }
    }
  ]
}

​
Response (Company List)

{
  "success": true,
  "search_type": "COMPANY",
  "total_count": 75,
  "page": 1,
  "page_size": 25,
  "companies": [
    {
      "id": 678,
      "name": "Tech Company",
      "website_url": "https://techcompany.com",
      "linkedin_url": "https://linkedin.com/company/techcompany",
      "logo_url": "https://logo.clearbit.com/techcompany.com",
      "industry": "Technology",
      "location": "San Francisco, CA",
      "amount_of_employees": "51-200",
      "revenue": "$10M-$50M"
    }
  ]
}

​
Sortable Fields

​
For People Lists

  • id - Prospect ID
  • first_name - First name
  • last_name - Last name
  • job_title - Job title
  • location - Location
  • created_at - Date added to list

​
For Company Lists

  • id - Company ID
  • name - Company name
  • industry - Industry
  • location - Location
  • amount_of_employees - Company size
  • revenue - Revenue

​
Error Responses

​
404 Not Found

{
  "error": "Lead list not found"
}

​
Example Usage

# Get all prospects from a lead list
curl -X GET "https://api.seleqt.ai/api/v1/public/lead-lists/123/leads/?page=1&page_size=25" \
  -H "X-API-Key: <your-api-key>"

# Get prospects with filters and sorting
curl -X GET "https://api.seleqt.ai/api/v1/public/lead-lists/123/leads/?job_title=CEO&sort_field=last_name&sort_direction=asc" \
  -H "X-API-Key: <your-api-key>"

# Get companies from a company list
curl -X GET "https://api.seleqt.ai/api/v1/public/lead-lists/456/leads/?page=1" \
  -H "X-API-Key: <your-api-key>"

import requests

# Get all leads from a lead list with pagination
response = requests.get(
    "https://api.seleqt.ai/api/v1/public/lead-lists/123/leads/",
    headers={"X-API-Key": "<your-api-key>"},
    params={
        "page": 1,
        "page_size": 50,
        "sort_field": "last_name",
        "sort_direction": "asc"
    }
)

data = response.json()
print(f"Total leads: {data['total_count']}")
print(f"Retrieved {len(data['prospects'])} leads on page {data['page']}")

# Iterate through all pages
all_prospects = []
page = 1
while True:
    response = requests.get(
        f"https://api.seleqt.ai/api/v1/public/lead-lists/123/leads/",
        headers={"X-API-Key": "<your-api-key>"},
        params={"page": page, "page_size": 100}
    )
    data = response.json()
    all_prospects.extend(data["prospects"])

    if len(data["prospects"]) < 100:
        break
    page += 1

print(f"Retrieved all {len(all_prospects)} prospects")