Surf

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

get/api/surf

Request

Query parameters

querystring required

Search query

limitinteger

Max results to return

imagesboolean

Include image search results

keystring

API key

Response

Search results

urlsstring[]

Web search result URLs

querystring
imagesstring[]

Image URLs (only when images=true)

Changes

    • breaking

      for the query request parameter images, default value was changed from false to false

    • breaking

      removed the enum value false from the query request parameter images

    • breaking

      removed the enum value true from the query request parameter images

    • breaking

      for the query request parameter images, the type changed from string to boolean

    • breaking

      the response's property type changed from no type to string for status

    • info

      api operation id surfGet removed and replaced with surf

    • info

      added the new optional query request parameter key

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      removed subschema #1 subschema #2 from the response property oneOf list for the response status

    • breaking

      the query request parameter images was restricted to a list of enum values

    • breaking

      for the query request parameter images, default value was changed from false to false

    • breaking

      added subschema #1 subschema #2 to the response property oneOf list for the response status

    • breaking

      the response's property type changed from string to no type for status

    • warning

      deleted the query request parameter key

    • info

      api operation id surf removed and replaced with surfGet

    • info

      added the new enum value false to the query request parameter images

    • info

      added the new enum value true to the query request parameter images

    • info

      for the query request parameter images, the type was generalized from boolean to string

    • info

      added the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status