API Reference
Complete documentation for all Searlo API endpoints, parameters, response schemas, and error handling.
Base URL
https://api.searlo.tech/api/v1Endpoints
/search/webOrganic results with position, title, link, snippet and domain, as JSON.
Credits: 1 per query/search/imagesImage results with source page, dimensions and thumbnail.
Credits: 1 per query/customsearch/v1Google Custom Search's parameters and JSON response; change the host and the key.
Credits: 1 per query/search/newsRecent articles with publisher, date and snippet.
Credits: 1 per query/search/videosVideo results with channel, duration and publish date.
Credits: 1 per query/search/shoppingProduct cards with price, seller and rating.
Credits: 1 per query/search/siteOne domain only — the site: operator, without the parsing.
Credits: 1 per query/search/advancedDate range, file type, exact and excluded terms in one call.
Credits: 1 per query/search/mapsLocal businesses with address, rating, hours and coordinates.
Credits: 1 per query/search/placesLocal businesses for a query in a named place, with contact details.
Credits: 1 per query/search/reviewsReviews for one business: rating, text, author, date, owner reply.
Credits: 1 per query/search/scholarPapers with authors, year, citation count and free PDF links.
Credits: 1 per query/search/patentsPatents with assignee, inventor, filing and grant dates.
Credits: 1 per query/search/webpageAny URL as clean markdown, with metadata — rendered when needed.
Credits: 1 per URL; 5 rendered from Nov 1/scrapeOne URL as markdown, html, links, tables and its own JSON-LD.
Credits: 1 per URL; 5 rendered from Nov 1/scrape/batchUp to 1000 URLs as one job, de-duplicated, with a webhook when it finishes.
Credits: 1 per URL in the batch; 5 rendered from Nov 1/mapEvery URL a site publishes, from its robots.txt and sitemaps.
Credits: 1 per site/crawlWhole sites as a job: depth, path filters, webhook on completion.
Credits: 1 per page crawled; 5 rendered from Nov 1/extractGive a field schema, get records — sourced from what pages declare.
Credits: 1 per page read; 5 rendered from Nov 1/search-and-scrapeSearch the web and fetch the pages it found, in one call.
Credits: 1 for the search + 1 per page; 5 per rendered page from Nov 1/search/batchUp to ten queries in one request.
Credits: 1 per query in the batch/serpAds, People Also Ask, related searches, knowledge graph and the AI Overview, as JSON.
Credits: 3 per page; 8 with a rendered AI Overview from Nov 1/serp/htmlGoogle's results page as HTML: as sent, or rendered with the AI Overview opened out. Desktop or iOS.
Credits: 2 per page; 8 rendered/serp/batchUp to 20 keywords' full SERPs in one request; larger jobs go async.
Credits: 3 per keyword per page; 8 with a rendered AI Overview from Nov 1/serp/featuresWhich features a query's results page shows: AI Overview, People Also Ask, ads.
Credits: 3 per query/rankings/checkWhere a domain ranks for a keyword, read from a live SERP, with the ranking URL.
Credits: 3 per 10 results of depth/search/ai/{engine}ChatGPT, Copilot and Gemini answers with the sources they cited.
Credits: 4-8 per answer/search/suggestionsThe suggestions Google offers as a query is typed.
Credits: 0.5 per query/search/countriesThe countries the AI answer endpoints accept as gl.
No credits/search/capabilitiesEvery endpoint this API serves, its price, whether it is on, and its last two hours.
No credits/credit/balanceCredits remaining on the key.
No credits/async/taskSubmit work now, poll or take a webhook when it finishes.
Credits: 1 per query/email-verifier/verifyDeliverability, disposable domains and mailbox status.
Credits: 5 per verification/mcp/infoThe Model Context Protocol handshake for AI assistants.
No creditsQuery 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
{
"searchParameters": {
"q": "machine learning",
"type": "search",
"gl": "us",
"hl": "en",
"num": 10,
"page": 1
},
"page": 1,
"nextPage": 2,
"previousPage": null,
"totalResults": 1250000,
"searchTime": 0.42,
"organic": [
{
"position": 1,
"title": "Introduction to Machine Learning",
"link": "https://example.com/ml-intro",
"snippet": "Machine learning is a subset of AI...",
"description": "An introduction to machine learning concepts and methods.",
"displayedLink": "example.com",
"domain": "example.com",
"favicon": "https://www.google.com/s2/favicons?domain=example.com&sz=32"
}
],
"credits": 1
}Error Codes
Rate Limits
Every account gets the same limits, free credits included. They are sliding windows, and every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
| Endpoints | Per Second | Per Minute | Per Day |
|---|---|---|---|
| Search, SERP, rank checks, AI answers, web data | 600 req/s | 20,000/min | 1,800,000/day |
| Maps, places and reviews (inside the search limit) | 20 req/s | 48/min | 16,000/day |
| Email verifier | 40 req/s | 200/min | 40,000/day |
| MCP server | 60 req/s | 1,200/min | 150,000/day |
Ready to integrate?
Start building with Searlo API today. Get 3,000 free credits to begin.
From the team behind Searlo
We also build RenderKit — the browser-rendering API for screenshots, PDFs, and LLM-ready markdown. Same billing model, same developer-first API design.