Search the web
Search the public web and return ranked organic 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
Silent alias for query when query is omitted.
min 1 chars · max 500 chars
ISO 3166-1 country code for localized results (e.g. US, GB, CA).
Optional filter by when results were posted.
one of: last-hour, last-day, last-week, last-month, last-year
Page number (1-based). Default: 1.
≥ 1
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.
Best-effort pagination state. The upstream search provider reports no result total and no explicit end-of-results signal, so `hasMore` is true when this page came back full.
Current page number (1-based).
≥ 0
Whether another page is available.
Next page number when more pages exist; null on the last page.
≥ 0
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
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
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.