search

Crawl a site and return clean page content.

Crawl a site and return clean page content. POST { url, limit?, maxDepth?, instructions? }. Follows links from the start URL (up to 10 pages, depth ≤2) and returns each page's extracted content. Optional natural-language instructions steer which pages to follow (e.g. "only pricing and docs pages"). For ingesting a small site/section in one call. 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.

post/api/search/crawl

Request

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

Query parameters

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.

Request body

urlstring uri required

Start URL to crawl.

limitinteger

Max pages (≤10).

maxDepthinteger

Max depth.

instructionsstring

Natural-language steering for which pages to follow.

Response

(unresolved $ref)

Changes

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