ASasksurf
Search

Web Search

Searches web pages, articles, and content by keyword.

Filters: domain via site (e.g. coindesk.com).

Included fields: titles, URLs, content snippets.

get/gateway/v1/search/web

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

qstring required

Search query like bitcoin price prediction 2026

Example:bitcoin price prediction 2026
limitinteger

Results per page

Example:20
offsetinteger

Pagination offset

sitestring

Comma-separated domain filter like coindesk.com or cointelegraph.com

Example:coindesk.com,cointelegraph.com
include_contentboolean

When false (default), search returns title/url/description only — fast (~2-3s) URL discovery. Set true to also include full markdown content for each result (~5-30KB per result, ~10-15s for limit=5). Use true only when the caller needs page content inline and won't follow up with /web/fetch.

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataResponseWebSearchResultItem.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.