API Reference
API Reference
Complete documentation for all Searlo API endpoints, parameters, response schemas, and error handling.
Base URL
https://api.searlo.techEndpoints
GET
/v1/search/webSearch the web for relevant results
1 credit per requestGET
/v1/search/imagesSearch for images across the web
1 credit per requestGET
/v1/search/newsSearch for recent news articles
1 credit per requestQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | Yes | The search query string |
limit | integer | No | Number of results to return (default: 10, max: 100) |
offset | integer | No | Number of results to skip for pagination (default: 0) |
country | string | No | Two-letter country code for localized results (e.g., 'us', 'gb') |
language | string | No | Two-letter language code (e.g., 'en', 'es') |
safe_search | boolean | No | Enable safe search filtering (default: true) |
Response Schema
response.json200 OK
{
"success": true,
"query": "machine learning",
"results": [
{
"title": "Introduction to Machine Learning",
"url": "https://example.com/ml-intro",
"description": "A comprehensive guide...",
"score": 0.95
}
],
"total": 1250,
"responseTime": 45
}Error Codes
400Bad RequestInvalid request parameters
401UnauthorizedMissing or invalid API key
403ForbiddenInsufficient permissions
429Too Many RequestsRate limit exceeded
500Internal ErrorServer-side error
Rate Limits
Your tier is automatically assigned based on total credits purchased. All tiers use sliding-window limits.
| Tier | Per Second | Per Minute | Per Day |
|---|---|---|---|
| Free | 5 req/s | 10/min | 1,000/day |
| Micro | 7 req/s | 20/min | 2,500/day |
| Starter | 10 req/s | 40/min | 5,000/day |
| Builder | 14 req/s | 75/min | 10,000/day |
| Scale | 18 req/s | 150/min | 25,000/day |
| Pro | 24 req/s | 300/min | 60,000/day |
| Enterprise | 30 req/s | 600/min | 150,000/day |
Ready to integrate?
Start building with Searlo API today. Get 3,000 free credits to begin.