Search API

Privacy-first web search. Two backends: Google Search API & Bing Search API.

Overview

MK Search provides two search API endpoints that return clean JSON results. No API key required. Both support GET and POST requests. Max 100 results per query.

Endpoints

GET POST /api/v1/search Google Search API

Returns search results via the Google Search API backend. Supports pagination with max_results parameter (default 10, max 100).

Parameters

Parameter	Type	Required	Description
`q`	string	Required	Search query
`max_results`	integer	Optional	Number of results (default: 10, max: 100)

Example

# GET request
curl "https://grexlabs.in/api/v1/search?q=artificial+intelligence&max_results=5"

# POST request
curl -X POST "https://grexlabs.in/api/v1/search" \
  -d "q=artificial+intelligence&max_results=5"

GET POST /api/search Bing Search API

Returns search results via the Bing Search API backend. Supports pagination with n parameter (default 10, max 100).

Parameters

Parameter	Type	Required	Description
`q`	string	Required	Search query
`n`	integer	Optional	Number of results (default: 10, max: 100)

Example

# GET request
curl "https://grexlabs.in/api/search?q=artificial+intelligence&n=5"

# POST request
curl -X POST "https://grexlabs.in/api/search" \
  -d "q=artificial+intelligence&n=5"

Response Format

Both endpoints return JSON in the following format:

{
  "success": true,
  "engine": "Google Search API",
  "query": "artificial+intelligence",
  "count": 5,
  "results": [
    {
      "rank": 1,
      "title": "Wikipedia - AI",
      "url": "https://en.wikipedia.org/wiki/Artificial_intelligence",
      "domain": "en.wikipedia.org",
      "favicon": "https://www.google.com/s2/favicons?domain=en.wikipedia.org&sz=64",
      "snippet": "Artificial intelligence is intelligence demonstrated by machines..."
    }
  ]
}

Error Codes

Code	Description
400	Missing query parameter `q`
500	Search backend error
503	Backend temporarily unavailable (rate limited)

Rate Limits

Free tier: 100 requests/day per IP. No API key required. For higher limits, get an API key from the Dashboard.