Skip to main content
GET
/
v1
/
lead-database
/
searches
/
{id}
/
results
curl -X GET "https://api.sendpilot.ai/v1/lead-database/searches/search_abc123xyz/results?limit=50" \
  -H "X-API-Key: your-api-key"
{
  "leads": [
    {
      "id": "lead_xyz789",
      "first_name": "John",
      "last_name": "Doe",
      "full_name": "John Doe",
      "email": "john.doe@example.com",
      "phone": "+1-555-123-4567",
      "linkedin_url": "https://www.linkedin.com/in/johndoe",
      "job_title": "CEO",
      "company": "TechCorp Inc",
      "location": "San Francisco, CA",
      "country": "United States",
      "industry": "Technology",
      "seniority": "C-Level",
      "company_linkedin_url": "https://www.linkedin.com/company/techcorp",
      "website": "https://techcorp.com",
      "employees": "51-200"
    }
  ],
  "pagination": {
    "total": 100,
    "offset": 0,
    "limit": 50,
    "has_more": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.sendpilot.ai/llms.txt

Use this file to discover all available pages before exploring further.

Returns the leads found by a completed lead database search.

Request

X-API-Key
string
required
Your API key

Path Parameters

id
string
required
The search ID returned from the create search endpoint

Query Parameters

offset
number
default:"0"
Number of leads to skip (for pagination)
limit
number
default:"100"
Maximum number of leads to return (1-1000)

Response

leads
array
Array of found leads
pagination
object
curl -X GET "https://api.sendpilot.ai/v1/lead-database/searches/search_abc123xyz/results?limit=50" \
  -H "X-API-Key: your-api-key"
{
  "leads": [
    {
      "id": "lead_xyz789",
      "first_name": "John",
      "last_name": "Doe",
      "full_name": "John Doe",
      "email": "john.doe@example.com",
      "phone": "+1-555-123-4567",
      "linkedin_url": "https://www.linkedin.com/in/johndoe",
      "job_title": "CEO",
      "company": "TechCorp Inc",
      "location": "San Francisco, CA",
      "country": "United States",
      "industry": "Technology",
      "seniority": "C-Level",
      "company_linkedin_url": "https://www.linkedin.com/company/techcorp",
      "website": "https://techcorp.com",
      "employees": "51-200"
    }
  ],
  "pagination": {
    "total": 100,
    "offset": 0,
    "limit": 50,
    "has_more": true
  }
}

Authorizations

X-API-Key
string
header
required

API key for authentication

Path Parameters

id
string
required

Search ID

Query Parameters

page
integer
default:1

Page number

Required range: x >= 1
limit
integer
default:50

Items per page

Required range: 1 <= x <= 100

Response

Search results

id
string
required

Search ID

status
enum<string>
required

Current status of the search

Available options:
pending,
processing,
completed,
failed
results
object[]
required

Array of lead results

pagination
object
required