Introduction

Searlo is a fast, developer-friendly search API. Get web, image, and news results with a single API key.

Base URL

https://api.searlo.tech/api/v1

Features

•Web Search — Full-text web results with snippets
•Image Search — High-quality image results with thumbnails
•News Search — Real-time news from thousands of sources
•Suggestions — Autocomplete and trending queries
•Simple Auth — One API key, no OAuth complexity

Web Search

Search the web and get ranked results with titles, URLs, and snippets.

Endpoint

GET /search/web

Parameters

Parameter	Type	Required	Description
`q`	string	Yes	Search query (max 500 chars)
`limit`	number	No	Results per page (1-10, default: 10)
`page`	number	No	Page number (default: 1)
`safe`	string	No	Safe search: `active` or `off`
`lr`	string	No	Language restriction (e.g., `lang_en`)
`gl`	string	No	Country code (e.g., `us`, `gb`)

Response

{
  "success": true,
  "searchInformation": {
    "totalResults": "1250000",
    "searchTime": 0.42,
    "query": "machine learning",
    "currentPage": 1,
    "hasNextPage": true
  },
  "items": [
    {
      "rank": 1,
      "title": "Introduction to Machine Learning",
      "link": "https://example.com/ml-intro",
      "snippet": "Machine learning is a subset of AI...",
      "domain": "example.com",
      "displayLink": "example.com"
    }
  ]
}

Image Search

Search for images with thumbnails and source URLs.

Endpoint

GET /search/images

Parameters

Parameter	Type	Required	Description
`q`	string	Yes	Search query (max 500 chars)
`limit`	number	No	Results per page (1-10, default: 10)
`page`	number	No	Page number (default: 1)
`size`	string	No	`small`, `medium`, `large`, `xlarge`
`imgType`	string	No	Image type filter
`imgColorType`	string	No	Color type filter

Response

{
  "success": true,
  "searchInformation": {
    "totalResults": "50000",
    "searchTime": 0.35,
    "query": "sunset"
  },
  "items": [
    {
      "rank": 1,
      "title": "Beautiful Sunset",
      "link": "https://example.com/sunset.jpg",
      "type": "image",
      "image": {
        "src": "https://example.com/sunset.jpg",
        "thumbnail": "https://example.com/thumb.jpg",
        "width": 1920,
        "height": 1080,
        "contextLink": "https://example.com/gallery"
      }
    }
  ]
}

News Search

Search news articles from thousands of sources worldwide.

Endpoint

GET /search/news

Parameters

Parameter	Type	Required	Description
`q`	string	Yes	Search query (max 500 chars)
`limit`	number	No	Results per page (1-10, default: 10)
`page`	number	No	Page number (default: 1)
`dateRestrict`	string	No	Time range: `d1` (day), `w1` (week), `m1` (month)

Response

{
  "success": true,
  "searchInformation": {
    "totalResults": "12500",
    "searchTime": 0.28,
    "query": "technology"
  },
  "items": [
    {
      "rank": 1,
      "title": "Tech News Article",
      "link": "https://news.example.com/article",
      "snippet": "Article summary...",
      "type": "news",
      "news": {
        "source": "Example News",
        "publishedDate": "2024-01-15T10:30:00Z",
        "author": "John Doe"
      }
    }
  ]
}

Search Suggestions

Get autocomplete suggestions and trending queries.

Autocomplete Endpoint

GET /search/suggestions

Parameter	Type	Required	Description
`q`	string	Yes	Partial query (1-200 chars)

Response

{
  "success": true,
  "data": [
    "machine learning",
    "machine learning python",
    "machine learning course",
    "machine learning vs ai"
  ],
  "message": "Suggestions retrieved successfully"
}

Trending Endpoint

GET /search/trending

Parameter	Type	Required	Description
`region`	string	No	2-letter country code (default: `US`)

Trending Response

{
  "success": true,
  "data": ["trending topic 1", "trending topic 2"],
  "message": "Trending searches retrieved successfully"
}

Rate Limiting

API requests are rate-limited per user to ensure fair usage. Limits scale automatically with your tier — the more credits you purchase, the higher your tier and rate limits.

Rate Limits by Tier

Tier	Per Second	Per Minute	Per Hour	Per Day
Free	5	10	200	1,000
Micro	7	20	400	2,500
Starter	10	40	750	5,000
Builder	14	75	1,500	10,000
Scale	18	150	3,000	25,000
Pro	24	300	6,000	60,000
Enterprise	30	600	15,000	150,000

> Tip: Your tier upgrades automatically based on total credits purchased. Buy any credit pack to unlock higher limits instantly.

Rate Limit Headers

Every response includes rate limit info:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1705312800

Handling Rate Limits

When you hit the limit, you'll get a 429 Too Many Requests response:

{
  "success": false,
  "message": "Too many requests. Please slow down.",
  "retryAfter": 60
}

Error Handling

All errors return a consistent JSON format.

Error Response Format

{
  "success": false,
  "message": "Error description",
  "error": "Technical error details (optional)"
}

For validation errors, an errors array may be included:

{
  "success": false,
  "message": "Validation Error",
  "errors": ["field must be a string", "limit must be between 1 and 100"]
}

HTTP Status Codes

Status	Meaning
400	Bad Request — Invalid parameters or validation error
401	Unauthorized — Invalid or missing API key
402	Payment Required — Insufficient credits
404	Not Found — Route not found
429	Too Many Requests — Rate limit exceeded
500	Server Error — Something went wrong

Common Error Messages

Message	Cause	Solution
Search query is required	Missing `q` parameter	Add `?q=...` to URL
Invalid or expired API key	Bad API key	Check your API key in headers
Insufficient credits	Out of credits	Top up your account
Too many requests	Rate limit hit	Wait and retry
Route Not Found	Invalid endpoint	Check endpoint URL

MCP Server

Connect AI agents like Claude, Cursor, VS Code Copilot, and Windsurf to Searlo via Model Context Protocol (MCP).

Endpoint

https://api.searlo.tech/api/v1/mcp

Transport

Streamable HTTP — the latest MCP specification. No stdio, no Docker, no proxy needed.

Authentication

Use your API key in the X-API-Key header. The same key works for both MCP and REST API.

Available Tools

Tool	Credits	Description
`web_search`	1	Google web search with organic results, knowledge panels, featured snippets

More tools (image search, news search, suggestions) coming soon.

web_search Parameters

Parameter	Type	Required	Description
`query`	string	Yes	The search query
`num`	number	No	Results count (1-10, default 10)
`page`	number	No	Page number (default 1)
`gl`	string	No	Country code (us, gb, de...)
`lr`	string	No	Language (en, fr, de...)
`safe`	string	No	Safe search (off, medium, high)

Quick Setup

Paste the config into your AI client's MCP settings file and replace sk_your_api_key with your key.

Introduction

Base URL

Features

Quick Start

1. Get Your API Key

2. Make Your First Request

Authentication

Getting Your API Key

Using Your API Key

Web Search

Endpoint

Parameters

Response

Image Search

Endpoint

Parameters

Response

News Search

Endpoint

Parameters

Response

Search Suggestions

Autocomplete Endpoint

Response

Trending Endpoint

Trending Response

Rate Limiting

Rate Limits by Tier

Rate Limit Headers

Handling Rate Limits

Error Handling

Error Response Format

HTTP Status Codes

Common Error Messages

MCP Server

Endpoint

Transport

Authentication

Available Tools

web_search Parameters

Quick Setup