For AI agents: a documentation index is available at /llms.txt
Skip to main content

/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

    timeout number
    token string
    allowedDomains string[]
    credentials object
    externalProxyServer string
    integrationId string
    proxy ProxyType

    Possible values: [datacenter, residential]

    proxyCity string
    proxyCountry string
    proxyLocaleMatch string

    Possible values: [0, 1, false, true]

    proxyPreset string
    proxyState string
    proxySticky string

    Possible values: [0, 1, false, true]

Body

    querystringrequired

    The search query string.

    limitnumber

    Maximum number of results per source. Defaults to 10. Capped by plan limits.

    langstring

    Language code for results (e.g., "en", "es", "de"). Defaults to "en".

    locationstring

    City or region to narrow geo-targeting (e.g., "San Francisco"). Use with country.

    countrystring

    ISO 3166-1 alpha-2 country code for geo-targeted results (e.g., "us", "gb", "de").

    proxystring

    Proxy network to route result scraping through: "residential" (default) or "datacenter".

    Possible values: [datacenter, residential]

    tbsstring

    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]

    categoriesstring[]

    Content category filters. Restricts results to "github" repos, "research" papers, or "pdf" documents.

    Possible values: [github, pdf, research]

    sourcesstring[]

    Sources to search. Defaults to ["web"]. Also supports "news" and "images".

    Possible values: [images, news, web]

    timeoutnumber

    Request timeout in milliseconds.

    scrapeOptions object

    When provided, fetches and processes each result URL into structured content.

    formatsstring[]required

    Possible values: [html, links, markdown, screenshot]

    stripNonContentTagsboolean
    onlyMainContentboolean
    removeBase64Imagesboolean
    includeTagsstring[]
    excludeTagsstring[]

Responses​

Schema
    successbooleanrequired
    data objectrequired
    web object[]
  • Array [
  • titlestringrequired
    urlstringrequired
    descriptionstringrequired
    positionnumber
    markdownstring
    htmlstring
    linksstring[]
    screenshotstring
    metadata object
    statusCodenumberrequired
    strategystring
    errorstring
  • ]
  • news object[]
  • Array [
  • datestring
    imageUrlstring
    titlestringrequired
    urlstringrequired
    descriptionstringrequired
    positionnumber
    markdownstring
    htmlstring
    linksstring[]
    screenshotstring
    metadata object
    statusCodenumberrequired
    strategystring
    errorstring
  • ]
  • images object[]
  • Array [
  • titlestring
    imageUrlstring
    imageWidthnumber
    imageHeightnumber
    urlstring
    positionnumber
  • ]
  • totalResultsnumberrequired
    errorstring
    errorCodeSearchFailureCode

    Possible values: [no_results, upstream_timeout, upstream_unavailable]

    unresponsiveEngines object[]
  • Array [
  • enginestringrequired
    reasonUnresponsiveEngineReasonrequired

    Possible values: [access_denied, captcha, rate_limited, timeout, unknown]

  • ]
Was this page helpful?