Search the web

30 DeepSFetch credits per successful search request, including zero matches, up to 20 results. Failed provider calls are not charged. Scraping is a separate operation. Use Idempotency-Key to replay without an additional charge.

post/v2/search

Request

  • Base URL: https://api.deepsfetch.com
  • URL: https://api.deepsfetch.com/v2/search
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Request body

asyncboolean
device'desktop' | 'mobile' | 'tablet'

Legacy common option. Not forwarded by the HTML adapter or recognized by the current browser runtime. Do not rely on it to customize execution.

querystring required
limitinteger
scrapeResultsfalse

Use /v2/scrape separately. Combined search and scraping is not supported.

source'web' | 'news' | 'images'

Web pages, news articles or images. One provider request per search.

category'general' | 'developer' | 'research'

Domain allowlist for Web results; use general with News or Images. No additional DeepSFetch credits.

sourcesstring[]

Combine Web, News, Images, Developer and Research. Developer and Research use domain filters without additional DeepSFetch credits.

Response

Completed

idstring required
kind'scrape' | 'extract' | 'search' | 'map' | 'crawl' | 'interact' | 'watch' required
status'queued' | 'running' | 'completed' | 'failed' | 'cancelled' required
resultobject nullable

Provider-specific output. V1 adapter: provider, operation, providerJobId, status, statusUrl, result, meta. Inspect inner status for partial completion; browser shape differs.

createdAtstring date-time required
startedAtstring nullable
completedAtstring nullable
cancelledAtstring nullable

Changes

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