Web: Search

Search the web

Runs a web search and returns result URLs + snippets — cheap; use this first and read the snippets. Add scrapeOptions ONLY when you actually need the full text of the pages, because it then downloads and bills EVERY result — keep limit small when you do (a few results, not dozens). To read specific pages, prefer searching first and then scraping just the one or two URLs you chose. Supports web, news, and image sources.

post/v1/data/web/search

Request

  • Base URL: https://api.superagnt.com
  • URL: https://api.superagnt.com/v1/data/web/search
  • Auth: API key in header Authorization

Request body

querystring required

The search query.

limitinteger

Number of results per source. Default 10.

categoriesstring[]

Restrict results to these categories.

tbsstring

Time-based search filter (e.g. 'qdr:d' for past day).

locationstring

Geo-target for the search (e.g. 'San Francisco, California, United States').

countrystring

ISO country code. Default 'US'.

includeDomainsstring[]

Only return results from these hostnames (mutually exclusive with excludeDomains).

excludeDomainsstring[]

Exclude results from these hostnames (mutually exclusive with includeDomains).

timeoutinteger

Request timeout in milliseconds. Default 60000.

Response

Search results, optionally including scraped page content.

object required

Changes

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