Index onlineMerchant portal
Api Endpoint

SocialFetch

Convert a web page URL into clean markdown.

Open interactive test console

Offering

Provider
api.socialfetch.dev
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Web Search Research
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://api.socialfetch.dev/v1/web/markdown
MIME type
application/json
First seen
2026-10-16T01:51:51.176Z
Last seen
Tags
Web, social-data

Website

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.014 USDC
Atomic price: 14000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "14000",
    "payTo": "0x02C2fCAfCe36B4AAdB39625866Bc6B1699d83043"
  }
]

Observed health

Status
Healthy
Latest latency
34 ms
Average latency
149 ms
HTTP status
402
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "url": {
          "description": "Web page URL to fetch.",
          "type": "string",
          "minLength": 1,
          "maxLength": 2083
        },
        "filter": {
          "default": "fit",
          "type": "string",
          "enum": [
            "fit",
            "raw",
            "bm25"
          ],
          "description": "Markdown extraction filter. `fit`: strip boilerplate and extract the main readable content. `raw`: full unfiltered page markdown, no content pruning. `bm25`: rank and return only the content most relevant to `query`, using the BM25 keyword-relevance algorithm — requires `query` to be set."
        },
        "query": {
          "description": "Optional query string used by the bm25 filter to rank relevant content.",
          "type": "string",
          "maxLength": 500
        },
        "cacheMode": {
          "default": "enabled",
          "description": "Cache behavior. `enabled`: read from cache if present, else fetch and write to cache. `bypass`: always fetch fresh, ignoring and not updating the cache. `write_only`: always fetch fresh, but write the result to cache without reading from it first. Default: `enabled`.",
          "type": "string",
          "enum": [
            "enabled",
            "bypass",
            "write_only"
          ]
        },
        "scanFullPage": {
          "description": "When true, scroll the page to load dynamically appended content (infinite scroll). Default false.",
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "string",
              "enum": [
                "0",
                "1",
                "true",
                "false"
              ]
            }
          ]
        },
        "waitFor": {
          "type": "string",
          "maxLength": 200,
          "description": "Wait for a CSS selector before extraction. Must be prefixed with \"css:\" (e.g. css:main). JavaScript wait conditions are not supported."
        }
      },
      "required": [
        "url"
      ]
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "cacheMode": {
              "default": "enabled",
              "description": "Cache behavior. `enabled`: read from cache if present, else fetch and write to cache. `bypass`: always fetch fresh, ignoring and not updating the cache. `write_only`: always fetch fresh, but write the result to cache without reading from it first. Default: `enabled`.",
              "enum": [
                "enabled",
                "bypass",
                "write_only"
              ],
              "type": "string"
            },
            "filter": {
              "default": "fit",
              "description": "Markdown extraction filter. `fit`: strip boilerplate and extract the main readable content. `raw`: full unfiltered page markdown, no content pruning. `bm25`: rank and return only the content most relevant to `query`, using the BM25 keyword-relevance algorithm — requires `query` to be set.",
              "enum": [
                "fit",
                "raw",
                "bm25"
              ],
              "type": "string"
            },
            "query": {
              "description": "Optional query string used by the bm25 filter to rank relevant content.",
              "maxLength": 500,
              "type": "string"
            },
            "scanFullPage": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "enum": [
                    "0",
                    "1",
                    "true",
                    "false"
                  ],
                  "type": "string"
                }
              ],
              "description": "When true, scroll the page to load dynamically appended content (infinite scroll). Default false."
            },
            "url": {
              "description": "Web page URL to fetch.",
              "maxLength": 2083,
              "minLength": 1,
              "type": "string"
            },
            "waitFor": {
              "description": "Wait for a CSS selector before extraction. Must be prefixed with \"css:\" (e.g. css:main). JavaScript wait conditions are not supported.",
              "maxLength": 200,
              "type": "string"
            }
          },
          "required": [
            "url"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}