Search the web
Search the public web and return ranked results with snippets.
Headers
Get your API keyAPI key (`sfk_...`)
Search query text to run against the public web.
min 1 chars · max 500 chars
Search depth: basic (default), fast, ultra-fast, or advanced.
one of: basic, fast, ultra-fast, advanced
Maximum number of search results to return (1–20).
≥ 1 · ≤ 20
Search topic category. Defaults to general.
one of: general, news, finance
Optional time range filter based on publish or last-updated date.
one of: day, week, month, year
Optional start date filter in YYYY-MM-DD format.
pattern: ^\d{4}-\d{2}-\d{2}$
Optional end date filter in YYYY-MM-DD format.
pattern: ^\d{4}-\d{2}-\d{2}$
Domains to include in results. Repeat includeDomain for multiple values (max 20).
Domains to exclude from results. Repeat excludeDomain for multiple values (max 20).
Endpoint-specific response payload.
Search query that was executed.
Ranked search results.
Result page title.
Result page URL.
Relevant text snippet extracted from the result.
Relevance score between 0 and 1.
≥ 0 · ≤ 1
Favicon URL when available.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/web/search?query=social media scraping API" \
-H "x-api-key: YOUR_API_KEY"Responses
Ranked web search results for the requested query.