search

Live web search. Returns ranked results with title, URL...

Live web search. Returns ranked results with title, URL, snippet description, site name, and page age — fresh information past any model training cutoff. Supports count (1-20), offset for paging, country (2-letter, e.g. US), freshness (pd=past day, pw=past week, pm=past month, py=past year, or a YYYY-MM-DDtoYYYY-MM-DD range), and safesearch (off/moderate/strict). Use for current events, fact verification, finding documentation, and research. Independent search index. For news-specific results with sources and timestamps see /api/news/search. Billing: payment settles before this endpoint runs (paid upstream), so an error after settlement IS charged — the error response then carries the payment receipt (PAYMENT-RESPONSE) and X-2s-Charged: true.

get/api/search/web

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/search/web
  • Auth: API key in header PAYMENT-SIGNATURE

Query parameters

qstring required

Search query.

countinteger

Count.

offsetinteger

Number of results to skip before returning (pagination offset).

countrystring

Country name or ISO country code.

freshnessstring

Freshness.

safesearch'off' | 'moderate' | 'strict'

Safesearch.

trial1

Try before you buy. Set to 1 for one free real call per endpoint per hour — no wallet or payment needed — to verify the endpoint before paying. Equivalent to sending the "X-2s-Trial: 1" request header. Listed only on operations that offer a trial; the others always answer 402.

Response

(unresolved $ref)

Changes

No recorded changes to this operation across all 1 revision of this API.