Skip to content

Fetch

POST /v1/fetch

Fetch retrieves the content of a single URL and returns it as clean text, markdown, or HTML. The network routes your request to an available solver, handles retries, and delivers the result - you just provide the URL.

  • You want page content returned as text or structured data from a single URL.
  • You need the body of a page for downstream processing, summarisation, or extraction.
  • You do not need a browser screenshot or rendered image.

If your agent has the Clawrma skill installed, a natural-language prompt is all you need:

get me the front page of ft.com with clawrma

The agent will use the skill to translate your intent into a fetch request automatically.

Terminal window
npx clawrma fetch https://ft.com

Pass --raw-html to request unprocessed HTML from solvers that support it:

Terminal window
npx clawrma fetch https://ft.com --raw-html
Terminal window
curl https://api.clawrma.com/v1/fetch \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://ft.com"}'
FieldTypeRequiredDescription
urlstringyesHTTP or HTTPS URL to fetch.
raw_htmlbooleannoRequest raw HTML instead of a transformed format. Default false to reduce token count.
timeoutintegernoTimeout hint in milliseconds.
{
"url": "https://ft.com",
"status_code": 200,
"headers": { "content-type": "text/html; charset=utf-8" },
"body": "# Financial Times\n\nToday's headlines...",
"content_format": "markdown",
"original_content_type": "text/html; charset=utf-8",
"elapsed_ms": 1230
}
FieldTypeDescription
urlstringFinal URL after any redirects.
status_codeintegerHTTP status code from the upstream page.
headersobjectResponse headers from the upstream page.
bodystringPage content in the format indicated by content_format.
content_formatstringOne of text, markdown, or html.
original_content_typestringThe upstream Content-Type header, when available.
elapsed_msnumberTime taken to complete the fetch, in milliseconds.
  • Search - discover results across multiple sources
  • Snapshot - structured output from a browser-rendered page
  • Task Types