web_extract

Fetch a public webpage and extract clean LLM-ready Markdown, metadata, contacts, links, and optional custom-projected tableRow columns.

When to use

Use when an agent needs clean Markdown and structured JSON from a webpage (Firecrawl-style) with optional fields/outputSchema projection for Clay, Notion, or n8n.

Selection guidance

Role: supporting. Use when an agent needs clean Markdown and structured JSON from a webpage (Firecrawl-style) with optional fields/outputSchema projection for Clay, Notion, or n8n.

Use cases

Access

Price: $0.05 USD per call. Payment options are deployment-configured; inspect /api/v1/payment-methods. Prices and payment semantics are unchanged from the canonical registry.

Get the full result

0.05 USD per call

Save with Monthly Plans & API Key Billing: Pay $0.05 per call, or get an instant API key at https://api.rafidsystem.com/get-started and save with monthly plans starting at $10/mo (1,000 calls) and Growth $50/mo (10,000 calls). See https://api.rafidsystem.com/api/v1/subscription-plans. View monthly plans · Payment methods
Try free preview · limited information, no charge
curl -X POST 'https://api.rafidsystem.com/api/v1/preview/web_extract' -H 'Content-Type: application/json' --data '{"url":"https://example.com","includeMarkdown":true,"includeLinks":true}'
Pay with USDC · request an x402 challenge
curl -X POST 'https://api.rafidsystem.com/api/v1/x402/websites/extract' -H 'Content-Type: application/json' --data '{"url":"https://example.com","includeMarkdown":true,"includeLinks":true}'
Authorized x402 client · signed retry request
curl -X POST 'https://api.rafidsystem.com/api/v1/x402/websites/extract' -H 'Content-Type: application/json' -H 'PAYMENT-SIGNATURE: <PAYMENT_SIGNATURE_FROM_AUTHORIZED_CLIENT>' -H 'X-Rafid-Payment-Journey: <PAYMENT_JOURNEY_FROM_CHALLENGE>' -H 'Idempotency-Key: <UNIQUE_REQUEST_ID>' --data '{"url":"https://example.com","includeMarkdown":true,"includeLinks":true}'

Use an x402-compatible client to parse PAYMENT-REQUIRED and authorize payment before retrying the same input with PAYMENT-SIGNATURE. Copying a request does not pay.

No crypto wallet? Use Rafid Credits
curl -X POST 'https://api.rafidsystem.com/api/v1/websites/extract' -H 'Content-Type: application/json' -H 'Authorization: Bearer <RAFID_API_KEY>' -H 'X-Rafid-Payment-Method: credits' -H 'Idempotency-Key: <UNIQUE_REQUEST_ID>' -H 'X-Rafid-Payment-Journey: <PAYMENT_JOURNEY_FROM_CHALLENGE>' --data '{"url":"https://example.com","includeMarkdown":true,"includeLinks":true}'

Create an API key instantly via POST https://api.rafidsystem.com/api/v1/account/signup or at https://api.rafidsystem.com/get-started, then fund by card (Stripe) or USDC and save with monthly plans ($10–$500/mo).

Existing account balance: GET https://api.rafidsystem.com/api/v1/account/balance.

MCP Credits integration
POST https://api.rafidsystem.com/mcp/credits
Authorization: Bearer <OAUTH_ACCESS_TOKEN>
Idempotency-Key: <UNIQUE_REQUEST_ID>
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "web_extract",
    "arguments": {
      "url": "https://example.com",
      "includeMarkdown": true,
      "includeLinks": true
    }
  }
}

OAuth metadata: authorization server · protected resource. Operator authorization and an existing funded account are required; OAuth does not grant credits.

Payment instructions and onboarding · API docs and schemas

These are copyable API integration requests. They do not open a checkout or execute a paid tool.

Related tools

Example input

{
  "url": "https://example.com",
  "includeMarkdown": true,
  "includeLinks": true
}

Example output

{
  "url": "https://example.com",
  "finalUrl": "https://example.com/",
  "statusCode": 200,
  "title": "Example Domain",
  "description": null,
  "language": "en",
  "markdown": "# Example Domain\n\nThis domain is for use in illustrative examples in documents.",
  "contacts": {
    "emails": [],
    "phones": []
  },
  "links": [
    {
      "text": "More information...",
      "href": "https://www.iana.org/domains/example"
    }
  ],
  "wordCount": 12
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2048,
      "format": "uri"
    },
    "includeMarkdown": {
      "type": "boolean"
    },
    "includeLinks": {
      "type": "boolean"
    },
    "maxLinks": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "fields": {
      "minItems": 1,
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 120
      }
    },
    "outputSchema": {
      "type": "object",
      "propertyNames": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80
      },
      "additionalProperties": {
        "type": "string",
        "minLength": 1,
        "maxLength": 120
      }
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    },
    "finalUrl": {
      "type": "string"
    },
    "statusCode": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "title": {
      "type": [
        "string",
        "null"
      ]
    },
    "description": {
      "type": [
        "string",
        "null"
      ]
    },
    "language": {
      "type": [
        "string",
        "null"
      ]
    },
    "markdown": {
      "type": "string"
    },
    "contacts": {
      "type": "object",
      "properties": {
        "emails": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "phones": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "emails",
        "phones"
      ],
      "additionalProperties": false
    },
    "links": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string"
          },
          "href": {
            "type": "string"
          }
        },
        "required": [
          "text",
          "href"
        ],
        "additionalProperties": false
      }
    },
    "wordCount": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "tableRow": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  },
  "required": [
    "url",
    "finalUrl",
    "statusCode",
    "title",
    "description",
    "language",
    "markdown",
    "contacts",
    "links",
    "wordCount"
  ],
  "additionalProperties": false
}

Category: Website Intelligence · hierarchy: supporting · idempotent: yes · side effects: no