ToolsXpo
ToolsXpo

Writing

URL to Markdown API

GET request to /v1/url-to-markdown, returning json in the standard envelope.

GET/v1/url-to-markdown40 credits / call Paid

Authentication

Send your API key as a bearer token. Create one free in the dashboard.

Authorization: Bearer $TOOLSXPO_KEY

Parameters

Sent as query-string parameters (or a JSON body with POST). Fields marked required must be present; everything else has a sensible default.

NameTypeDefaultDescription
urlrequiredstring—Page URL to render and convert to Markdown, e.g. https://example.com.

Example request

curl "https://api.toolsxpo.com/v1/url-to-markdown?url=https%3A%2F%2Fexample.com" \
  -H "Authorization: Bearer $TOOLSXPO_KEY"

Response

Every endpoint answers with the same envelope: the result in data, what the call cost and your standing in meta.

{
  "ok": true,
  "data": { /* json */ },
  "meta": { "credits": 40 }
}

meta fields (every tool)

FieldTypeDescription
meta.toolstringThe tool id that ran.
meta.authstringHow the call authenticated — `key` for an API key.
meta.creditsnumberEverything this call cost, in credits (both currencies together).
meta.baseCreditsnumberThe tool's own price — the compute-credit part of `credits`.
meta.aiCreditsnumberAI credits spent on a model step. Present only when non-zero.
meta.billedFromstringWhich balance paid: the plan allowance or the purchased credit balance.
meta.pricing.mode"flat" | "metered"Flat price per call, or metered by usage.
meta.pricing.meterUnitstringMetered tools: what is counted (e.g. `megapixel`).
meta.pricing.creditsPerUnitnumberMetered tools: credits per unit counted.
meta.quota.limitnumberYour plan's allowance for the current period.
meta.quota.usednumberAllowance used so far this period.
meta.quota.remainingnumberAllowance left this period.
meta.quota.resetsAtstring (ISO 8601)When the allowance resets.
meta.quota.creditBalancenumberPurchased credits remaining, used after the allowance.
meta.quota.scopestringWhat the quota belongs to — `account` (your workspace) for API keys.
meta.quota.planstringYour plan id.

Errors

Failures use the same envelope with ok: false and a machine-readable code.

StatusCodeMeaning
400invalid_inputA parameter failed validation. `details` lists which.
401unauthorizedMissing or invalid API key.
402quota_exceededOut of credits on this workspace.
404not_foundNo such tool.
429rate_limitedToo many requests. Retry after `Retry-After` seconds.
503service_unavailableTemporarily disabled by an administrator.

How to use the URL → Markdown API

Render a page in a real browser and get clean Markdown of its main content back in data.markdown — ideal for feeding pages into an LLM, a RAG index, or a content pipeline without shipping a headless browser yourself.

Bash
curl "https://api.toolsxpo.com/v1/url-to-markdown?url=https://example.com" \
  -H "Authorization: Bearer $TOOLSXPO_KEY"

Why Markdown (not raw HTML)

  • It's already stripped of boilerplate, scripts and styling, so it's far cheaper to send to a model.
  • Headings, lists, links and code blocks survive, so structure is preserved for chunking and retrieval.

Pairs well with

Tips & gotchas

  • Single-page apps that render everything client-side work here (unlike a plain fetch), because a real browser executes the JS first.
  • data.length gives the character count, handy for budgeting model tokens.