/search
POST/search
Search the web and optionally scrape result pages. Accepts a query, performs a web search via SearXNG, and optionally scrapes each result URL — returning structured, LLM-ready data (markdown, HTML, links, or screenshots).
Request
Query Parameters
Possible values: [datacenter, residential]
Possible values: [0, 1, false, true]
Possible values: [0, 1, false, true]
Body
- Schema
- Example (auto)
The search query string.
Maximum number of results per source. Defaults to 10. Capped by plan limits.
Language code for results (e.g., "en", "es", "de"). Defaults to "en".
City or region to narrow geo-targeting (e.g., "San Francisco"). Use with country.
ISO 3166-1 alpha-2 country code for geo-targeted results (e.g., "us", "gb", "de").
Proxy network to route result scraping through: "residential" (default) or "datacenter".
Possible values: [datacenter, residential]
Time-based filter. Accepts "day", "week", "month", "year", or raw Google TBS syntax ("qdr:d", "qdr:w", "qdr:m", "qdr:y").
Possible values: [day, month, qdr:d, qdr:m, qdr:w, qdr:y, week, year]
Content category filters. Restricts results to "github" repos, "research" papers, or "pdf" documents.
Possible values: [github, pdf, research]
Sources to search. Defaults to ["web"]. Also supports "news" and "images".
Possible values: [images, news, web]
Request timeout in milliseconds.
scrapeOptions object
When provided, fetches and processes each result URL into structured content.
Possible values: [html, links, markdown, screenshot]
{
"query": "string",
"limit": 0,
"lang": "string",
"location": "string",
"country": "string",
"proxy": "datacenter",
"tbs": "day",
"categories": [
"github"
],
"sources": [
"images"
],
"timeout": 0,
"scrapeOptions": {
"formats": [
"html"
],
"stripNonContentTags": true,
"onlyMainContent": true,
"removeBase64Images": true,
"includeTags": [
"string"
],
"excludeTags": [
"string"
]
}
}
Responses
- 200
- 400
- 401
- 403
- 404
- 408
- 429
- 500
- 503
Schema
- Fields
- Example (auto)
- Array [
- ]
- Array [
- ]
- Array [
- ]
- Array [
- ]
data objectrequired
web object[]
metadata object
news object[]
metadata object
images object[]
Possible values: [no_results, upstream_timeout, upstream_unavailable]
unresponsiveEngines object[]
Possible values: [access_denied, captcha, rate_limited, timeout, unknown]
{
"success": true,
"data": {
"web": [
{
"title": "string",
"url": "string",
"description": "string",
"position": 0,
"markdown": "string",
"html": "string",
"links": [
"string"
],
"screenshot": "string",
"metadata": {
"statusCode": 0,
"strategy": "string",
"error": "string"
}
}
],
"news": [
{
"date": "string",
"imageUrl": "string",
"title": "string",
"url": "string",
"description": "string",
"position": 0,
"markdown": "string",
"html": "string",
"links": [
"string"
],
"screenshot": "string",
"metadata": {
"statusCode": 0,
"strategy": "string",
"error": "string"
}
}
],
"images": [
{
"title": "string",
"imageUrl": "string",
"imageWidth": 0,
"imageHeight": 0,
"url": "string",
"position": 0
}
]
},
"totalResults": 0,
"error": "string",
"errorCode": "no_results",
"unresponsiveEngines": [
{
"engine": "string",
"reason": "access_denied"
}
]
}
The request contains errors or didn't properly encode content.
The request is missing, or contains bad, authorization credentials.
The request targets a destination that is not allowed.
Resource couldn't be found.
The request took has taken too long to process.
Too many requests are currently being processed.
An internal error occurred when handling the request.
Service is unavailable.