Scrape

Firecrawl

Read a public web page as Markdown, HTML or links.

Capability: Web page extraction
Current price: $0.0070/page
Availability: Ready to run

What this API does

Extract one public HTTPS page as Markdown, HTML, raw HTML or links. Costs one page event on success. Each text format is capped at 100,000 characters and links at 1,000, with truncation reported. PDF parsing, X/Twitter, screenshots, JSON extraction, custom headers and browser actions are excluded. Failed or empty page extraction is not charged.

Agents select this operation with tool ID firecrawl.scrape, then inspect its current executable contract before a run.

Public input and output shape

Input

formatsarray · optional

Value supplied for formats.

minItems: 1 · maxItems: 4

onlyMainContentboolean · optional

Value supplied for only main content.

urlstring · required

Public HTTPS web page. PDF files and X/Twitter URLs are excluded.

format: uri · maxLength: 2048

Output

markdownstring

Returned markdown value.

statusnumber

Returned status value.

titlestring

Returned title value.

truncatedboolean

Returned truncated value.

urlstring

Returned url value.

Example request and output

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

Request

{
  "tool_id": "firecrawl.scrape",
  "input": {
    "url": "https://example.com/",
    "formats": [
      "markdown"
    ]
  }
}

Output

{
  "url": "https://example.com/",
  "title": "Example Domain",
  "status": 200,
  "markdown": "# Example Domain\n\nThis domain is for use in documentation examples without needing permission. Avoid use in operations.\n\n[Learn more](https://iana.org/domains/example)",
  "truncated": false
}

Teaching errors and limitations

invalid_input: The URL, query or limits are outside this tool's supported inputs.example: {"url":"https://example.com/","formats":["markdown"]}
upstream_error: The provider could not return usable results; the wallet was not charged.Check the target page and retry with a smaller limit if necessary.

Use Scrape with Scrollport

Use Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.