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
- convert webpage to markdown
- extract structured website metadata and contacts
- populate Clay or Notion tables from a URL
Access
- REST:
POST https://api.rafidsystem.com/api/v1/websites/extract - x402:
POST https://api.rafidsystem.com/api/v1/x402/websites/extract - MCP tool:
web_extract - Free preview:
POST https://api.rafidsystem.com/api/v1/preview/web_extract
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
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