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

{
  "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
}

​
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

​
Authorization
string
required
Bearer token in format: Bearer client_id:api_key:api_secret

​
Query Parameters

​
query
string
Search query for full-text search on company name, description, compendium. Max 500 characters.
​
email_verified
boolean
Filter by email verification status.
​
min_icp_score
integer
Minimum ICP (Ideal Customer Profile) score. Range: 0-100.
​
industry
string
Filter by industry/category.
​
page
integer
default:"1"
Page number for pagination.
​
per_page
integer
default:"20"
Results per page. Range: 1-100.
​
sort_by
string
default:"_score"
Sort field. Default is relevance score.

​
Response

​
success
boolean
Whether the request was successful.
​
total
integer
Total number of matching documents.
​
hits
array
Array of search results.
​
facets
object
Aggregated facets for filtering.
​
page
integer
Current page number.
​
per_page
integer
Results per page.

​
Examples

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

{
  "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
}