Search Leads

GET/api/v1/search/leads

Overview

Search leads from SpiderSite results with full-text search on company name, description, and compendium data.

Use cases: Di-Atomic Lead Stream search, B2B lead filtering, email campaign targeting.

Authentication

Authorizationstringrequired

Bearer token in format: Bearer client_id:api_key:api_secret

Query Parameters

querystring

Search query for full-text search on company name, description, compendium. Max 500 characters.

email_verifiedboolean

Filter by email verification status.

min_icp_scoreinteger

Minimum ICP (Ideal Customer Profile) score. Range: 0-100.

industrystring

Filter by industry/category.

pageintegerdefault: 1

Page number for pagination.

per_pageintegerdefault: 20

Results per page. Range: 1-100.

sort_bystringdefault: _score

Sort field. Default is relevance score.

Response

successboolean

Whether the request was successful.

totalinteger

Total number of matching documents.

hitsarray

Array of search results.

Hit object

doc_idstring

Document ID.

scorenumber

Relevance score.

namestring

Company/lead name.

descriptionstring

Company description.

categorystring

Industry category.

websitestring

Website URL.

emailstring

Contact email address.

phonestring

Phone number.

icp_scoreinteger

ICP match score (0-100).

job_idstring

Source job ID.

indexed_atstring

Timestamp when indexed.

facetsobject

Aggregated facets for filtering.

Facets object

categoriesarray

Industry facets with name and count.

job_typesarray

Job type facets.

pageinteger

Current page number.

per_pageinteger

Results per page.

Examples

Request Example

curl -X GET "https://spideriq.ai/api/v1/search/leads?query=software" \
  -H "Authorization: Bearer cli_xxx:key:secret"

curl -X GET "https://spideriq.ai/api/v1/search/leads?email_verified=true&min_icp_score=70" \
  -H "Authorization: Bearer cli_xxx:key:secret"

curl -X GET "https://spideriq.ai/api/v1/search/leads?industry=SaaS&per_page=50" \
  -H "Authorization: Bearer cli_xxx:key:secret"

Response Example

{
  "success": true,
  "total": 89,
  "hits": [
    {
      "doc_id": "lead_xyz789",
      "score": 7.2,
      "name": "TechCorp Solutions",
      "description": "Enterprise software development company",
      "category": "SaaS",
      "website": "https://techcorp.com",
      "email": "contact@techcorp.com",
      "phone": "+1 555 123 4567",
      "icp_score": 85,
      "job_id": "job-abc123",
      "indexed_at": "2026-01-21T10:30:00Z"
    }
  ],
  "facets": {
    "categories": [
      {"name": "SaaS", "count": 34},
      {"name": "Consulting", "count": 22}
    ]
  },
  "page": 1,
  "per_page": 20
}