Web

Search the web

Search the public web and return ranked organic results with snippets.

GET/v1/web/search
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
4
query*stringquery

Search query text to run against the public web.

min 1 chars · max 500 chars

regionstringoptionalquery

ISO 3166-1 country code for localized results (e.g. US, GB, CA).

datePostedstringoptionalquery

Optional filter by when results were posted.

one of: last-hour, last-day, last-week, last-month, last-year

pageoptionalquery

Page number (1-based). Defaults to 1 when omitted.

Response fields
10

Endpoint-specific response payload.

dataquery
string

Search query that was executed.

Ranked search results.

dataresults[]title
string

Result page title.

dataresults[]url
string

Result page URL.

dataresults[]content
string

Relevant text snippet extracted from the result.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

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.