---
title: "Surf"
method: GET
path: "/api/surf"
tags: ["Surf"]
---

# Surf

`GET /api/surf`

Lightweight search — returns raw URLs and optionally image URLs.
No LLM synthesis, no answer generation. Fast.

## Query parameters

- `query` string, required
- `limit` integer
- `images` boolean
- `key` string

## Response `200`

Search results

- SurfResponse
  - `urls` string[] — Web search result URLs
  - `query` string
  - `images` string[] — Image URLs (only when images=true)

## Other responses

- `400` — Invalid request
- `401` — API key required
- `403` — Invalid API key

## Changes

- **2026-04-06** `1b4365f47b75` — 5 breaking, 6 info
  - for the `query` request parameter `images`, default value was changed from `false` to `false`
  - removed the enum value `false` from the `query` request parameter `images`
  - removed the enum value `true` from the `query` request parameter `images`
  - for the `query` request parameter `images`, the type changed from `string` to `boolean`
  - …7 more
- **2026-03-17** `2486dd6cc627` — 4 breaking, 1 warning, 7 info
  - the `query` request parameter `images` was restricted to a list of enum values
  - for the `query` request parameter `images`, default value was changed from `false` to `false`
  - added `subschema #1, subschema #2` to the `error` response property `oneOf` list for the response status `400`
  - the `error` response's property type changed from `string` to no type for status `400`
  - …8 more

[Change history](https://skmtc.dev/elixpo/apis/lixsearch-api/changes/api/surf/get.md)

---

[API](https://skmtc.dev/elixpo/apis/lixsearch-api.md) · [All operations](https://skmtc.dev/elixpo/apis/lixsearch-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/elixpo/lixsearch-api/revisions/c3fcd0edadf8/schema)