SUsuprsonic
Suprsonic

Web Search

Changed on

Search the web with SERP, AI synthesis, or both. Returns, by mode: serp the organic results (title, url, snippet, position) with any knowledge graph and featured snippet; ai a written answer with the URLs it cites; deep both. Use for current facts, news and finding pages. To read one page in full use scrape; for a report built from many sources use research. Cost: serp 1 credit, ai 2 credits, deep 3 credits, charged only when a call succeeds.

post/v1/search

Request

Request body

querystring required
modestring
num_resultsinteger
countrystring
freshnessstring

Response

The call's envelope: success, data (the capability's result), metadata, and credits_used (0 when the call did not succeed).

successboolean required
credits_usedinteger

Changes

  • 120f2dd4c855Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • 9edc3bfe1b9cRevision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status