Search All

GET/api/v1/search/all

Overview

Search across all indexed job results regardless of type. Use this endpoint when you need to search across multiple job types simultaneously.

Use cases: Universal search, cross-source queries, combined business and lead search.

Authentication

Authorizationstringrequired

Bearer token in format: Bearer client_id:api_key:api_secret

Query Parameters

querystring

Search query for full-text search. Max 500 characters.

job_typestring

Filter by job type (e.g., spiderMaps, spiderSite).

categorystring

Filter by category.

min_ratingnumber

Minimum rating filter. Range: 0-5.

latnumber

Latitude for geo search. Range: -90 to 90.

lonnumber

Longitude for geo search. Range: -180 to 180.

radius_kmintegerdefault: 50

Search radius in kilometers. Range: 1-500.

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 from all job types.

Hit object

doc_idstring

Document ID.

scorenumber

Relevance score.

namestring

Business/lead name.

descriptionstring

Description.

categorystring

Category.

ratingnumber

Rating (if applicable).

addressstring

Address.

phonestring

Phone number.

websitestring

Website URL.

emailstring

Email address.

locationobject

Geo coordinates (if applicable).

job_typestring

Source job type (spiderMaps, spiderSite, etc.).

job_idstring

Source job ID.

facetsobject

Aggregated facets for filtering.

Facets object

categoriesarray

Category facets.

job_typesarray

Job type facets with counts.

pageinteger

Current page number.

per_pageinteger

Results per page.

Examples

Request Example

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

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

curl -X GET "https://spideriq.ai/api/v1/search/all?lat=49.6117&lon=6.1319&radius_km=25&category=restaurant" \
  -H "Authorization: Bearer cli_xxx:key:secret"

Response Example

{
  "success": true,
  "total": 245,
  "hits": [
    {
      "doc_id": "biz_123",
      "score": 9.1,
      "name": "Tech Solutions Inc",
      "description": "IT consulting and software development",
      "category": "Technology",
      "rating": 4.5,
      "address": "100 Tech Park, Luxembourg",
      "phone": "+352 123 456",
      "website": "https://techsolutions.lu",
      "email": "info@techsolutions.lu",
      "job_type": "spiderMaps",
      "job_id": "job-maps-001"
    },
    {
      "doc_id": "lead_456",
      "score": 8.7,
      "name": "TechStart Ventures",
      "description": "Startup accelerator",
      "category": "Venture Capital",
      "website": "https://techstart.vc",
      "email": "hello@techstart.vc",
      "job_type": "spiderSite",
      "job_id": "job-site-002"
    }
  ],
  "facets": {
    "job_types": [
      {"name": "spiderMaps", "count": 156},
      {"name": "spiderSite", "count": 89}
    ],
    "categories": [
      {"name": "Technology", "count": 78},
      {"name": "Consulting", "count": 45}
    ]
  },
  "page": 1,
  "per_page": 20
}