Social Fetch
Web

Generate web page HTML

Fetch and return cleaned HTML for a web page.

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

API key (`sfk_...`)

Parameters
1
url*stringquery

Web page URL to fetch.

min 1 chars · max 2083 chars

Response fields
10

Endpoint-specific response payload.

datalookupStatus
string

Whether page content could be extracted. Restricted means bot protection or similar access controls blocked automated fetching.

one of: found, restricted

dataurl
string

URL that was fetched.

datastatus
integernullable

HTTP status code reported for the page fetch when available; null when restricted.

datahtml
stringnullable

Cleaned or processed HTML when lookupStatus is found; null when restricted.

datametadata
objectoptional

Page metadata such as title when available.

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/html?url=https://www.socialfetch.dev" \
  -H "x-api-key: YOUR_API_KEY"

Responses

HTML extraction result. Check data.lookupStatus: found returns html; restricted means bot or access protection blocked the fetch (html is null).

On this page

No Headings