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

{
  "success": true,
  "total": 156,
  "hits": [
    {
      "doc_id": "abc123",
      "score": 8.5,
      "name": "Café Central",
      "category": "Coffee Shop",
      "rating": 4.7,
      "reviews_count": 234,
      "address": "12 Grand Rue, Luxembourg",
      "phone": "+352 123 456",
      "website": "https://cafecentral.lu",
      "email": "info@cafecentral.lu",
      "location": {
        "lat": 49.6117,
        "lon": 6.1319
      }
    }
  ],
  "facets": {
    "categories": [
      {"name": "Coffee Shop", "count": 45},
      {"name": "Café", "count": 32}
    ],
    "avg_rating": 4.2
  },
  "page": 1,
  "per_page": 20
}

​
Overview

Search businesses from SpiderMaps results with full-text search, geo-distance filtering, and faceted results. Use cases: VayaPin restaurant search, Gun Guard retailer finder, local business directories.

​
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 name, description, category. Max 500 characters.
​
category
string
Filter by business category (e.g., “restaurant”, “coffee shop”).
​
min_rating
number
Minimum rating filter. Range: 0-5.
​
lat
number
Latitude for geo search. Range: -90 to 90.
​
lon
number
Longitude for geo search. Range: -180 to 180.
​
radius_km
integer
default:"50"
Search radius in kilometers. Range: 1-500.
​
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. Options: _score, rating, reviews_count, newest.

​
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/businesses?query=coffee" \
  -H "Authorization: Bearer cli_xxx:key:secret"

{
  "success": true,
  "total": 156,
  "hits": [
    {
      "doc_id": "abc123",
      "score": 8.5,
      "name": "Café Central",
      "category": "Coffee Shop",
      "rating": 4.7,
      "reviews_count": 234,
      "address": "12 Grand Rue, Luxembourg",
      "phone": "+352 123 456",
      "website": "https://cafecentral.lu",
      "email": "info@cafecentral.lu",
      "location": {
        "lat": 49.6117,
        "lon": 6.1319
      }
    }
  ],
  "facets": {
    "categories": [
      {"name": "Coffee Shop", "count": 45},
      {"name": "Café", "count": 32}
    ],
    "avg_rating": 4.2
  },
  "page": 1,
  "per_page": 20
}