Social Fetch
Web

Generate web page markdown

Convert a web page into clean markdown.

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

API key (`sfk_...`)

Parameters
4
url*stringquery

Web page URL to fetch.

min 1 chars · max 2083 chars

filterstringoptionalquery

Content filter strategy for markdown extraction.

one of: fit, raw, bm25

querystringoptionalquery

Optional query string used by the bm25 filter to rank relevant content.

max 500 chars

cacheModestringoptionalquery

Cache behavior. Defaults to enabled.

one of: enabled, bypass, write_only

Response fields
14

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.

Markdown content when lookupStatus is found; null when restricted.

datamarkdownraw
string

Primary markdown text extracted from the page.

datamarkdownfit
stringoptional

Filtered markdown optimized for LLM consumption.

datamarkdownwithCitations
stringoptional

Markdown with numbered citations for outbound links.

datamarkdownreferences
stringoptional

Reference list for cited links in the markdown output.

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

Responses

Markdown extraction result. Check data.lookupStatus: found returns markdown; restricted means bot or access protection blocked the fetch (content fields are null).

On this page

No Headings