API Reference

Complete documentation for all Searlo API endpoints, parameters, response schemas, and error handling.

Base URL

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

Endpoints

GET/search/web

Search the web for ranked results (alias: GET /search)

1 credit per request

GET/search/images

Search for images with thumbnails and source URLs

1 credit per request

GET/search/news

Search recent news articles

1 credit per request

GET/search/videos

Search for videos across the web

1 credit per request

GET/search/site

Search restricted to a single site or domain

1 credit per request

GET / POST/search/advanced

Filtered search: date range, file type, exact / excluded terms, site

1 credit per request

GET/search/shopping

Search product / shopping results

1 credit per request

GET/search/simple

Legacy web search with a simplified result format

1 credit per request

GET/search/suggestions

Autocomplete suggestions for a partial query

0.5 credits per request

GET/search/trending

Trending / popular search queries by region

Free

POST/search/batch

Run up to 10 web searches in one request

1 credit per query (max 10)

GET/search/analytics

Your own search usage analytics

Free

POST/email-verifier/verify

Verify an email address's deliverability

5 credits per request

GET/email-verifier/history

Your past email verifications (paginated)

Free

Query Parameters

Parameter	Type	Required	Description
`q`	string	Yes	Search query, 1–500 chars (1–200 for suggestions). Advanced search also accepts 'query'.
`limit`	integer	No	Results per page. 1–10 (default 10) for search; 1–55 (default 55) for shopping.
`page`	integer	No	Page number for pagination (default: 1)
`gl`	string	No	Country code for localized results, e.g. 'us', 'gb' (max 5 chars)
`hl`	string	No	Interface language code, e.g. 'en' (max 5 chars)
`lr`	string	No	Language restriction for web search, e.g. 'lang_en' (max 50 chars)
`safe`	string	No	Safe search for web/video: 'active' or 'off'
`site`	string	No	Domain/URL to restrict to. Required for /search/site; optional for /search/advanced.

Response Schema

response.json200 OK

{
  "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"
    }
  ]
}

Error Codes

400Bad RequestInvalid parameters or validation error (includes errors[])

401UnauthorizedMissing or invalid API key

402Payment RequiredInsufficient credits (code: INSUFFICIENT_CREDITS)

403ForbiddenAccount disabled or removed

404Not FoundRoute or user not found

429Too Many RequestsRate limit exceeded

500Internal ErrorServer-side error

503Service UnavailableWarming up / temporarily unavailable (retryable: true)

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	10 req/s	30/min	5,000/day
Starter	10 req/s	50/min	10,000/day
Builder	20 req/s	80/min	30,000/day
Scale	30 req/s	100/min	40,000/day
Pro	50 req/s	300/min	60,000/day
Enterprise	300 req/s	10,000/min	200,000/day

Ready to integrate?

Start building with Searlo API today. Get 3,000 free credits to begin.

Get API Key View Full Docs