---
site: steel.dev
collection: docs
canonical_url: https://steel.dev/docs/reference/api/quick-actions
markdown_url: https://steel.dev/docs/reference/api/quick-actions.md
content_signal: ai-input=yes, ai-train=yes, search=yes
title: Quick actions API
description: Scrape a page, capture a screenshot or create a PDF with the Steel API, in one request and with no session to manage.
summary: Scrape a page, capture a screenshot or create a PDF with the Steel API, in one request and with no session to manage.
type: reference
reviewed: 2026-11-12
prerequisites: []
related:
  - https://steel.dev/docs/reference/api.md
  - https://steel.dev/docs/reference/api/sessions.md
  - https://steel.dev/docs/reference/api/profiles.md
  - https://steel.dev/docs/reference/api/credentials.md
  - https://steel.dev/docs/reference/api/files.md
agent_setup: https://setup.steel.dev/install.md
docs_index: https://steel.dev/docs/sitemap.md
---

# Quick actions API

A Quick action opens a web page and returns the result in one request, with no session to manage. These endpoints create a PDF, scrape a page and capture a screenshot. For the base URL and authentication, see [API conventions](https://steel.dev/docs/reference/api). For the error codes, see [Errors](https://steel.dev/docs/reference/errors).

The first example is a complete program. The later examples use its `client`.

## Endpoints

### Create a PDF

```http
POST /v1/pdf
```

Opens a web page and returns the URL of a PDF of it.

| Name | In | Type | Required | Default | Description |
| - | - | - | - | - | - |
| `url` | body | string (uri) | yes | | The URL of the page. |
| `delay` | body | number | no | | Milliseconds to wait before Steel creates the PDF. |
| `useProxy` | body | boolean | no | | Use a Steel residential proxy. |
| `projectId` | body | string (uuid) | no | | The project to run the action in. Required with an organization key. |

| Field | Type | Description |
| - | - | - |
| `url` | string (uri) | The URL of the PDF. |

**cURL**

```sh
curl -X POST https://api.steel.dev/v1/pdf \
  -H "steel-api-key: $STEEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'
```

**TypeScript**

```ts file=pdf.mts
import Steel from "steel-sdk";

const client = new Steel();
const result = await client.pdf({ url: "https://example.com" });

console.log(result.url);
```

**Python**

```python file=pdf.py
from steel import Steel

client = Steel()
result = client.pdf(url="https://example.com")

print(result.url)
```

**Go**

```go file=main.go
package main

import (
	"context"
	"fmt"
	"log"

	"github.com/steel-dev/sdk/go"
)

func main() {
	if err := run(context.Background()); err != nil {
		log.Fatal(err)
	}
}

func run(ctx context.Context) error {
	client := steel.NewClient()
	result, err := client.Pdf(ctx, steel.PdfParams{
		URL: steel.F("https://example.com"),
	})
	if err != nil {
		return err
	}

	fmt.Println(result.URL)
	return nil
}
```

**Rust**

```rust file=src/main.rs
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = steel_rs::Client::new();
    let result = client
        .pdf(steel_rs::PdfParams::new("https://example.com".to_owned()))
        .await?;

    println!("{}", result.url);
    Ok(())
}
```

See [PDF](https://steel.dev/docs/control/scrape#create-a-pdf).

### Scrape a page

```http
POST /v1/scrape
```

Opens a web page and returns its content in the formats that you ask for, with its metadata and links.

| Name | In | Type | Required | Default | Description |
| - | - | - | - | - | - |
| `url` | body | string | yes | | The URL of the page. A URL without a scheme is fetched over HTTPS. |
| `format` | body | string\[] | no | `["html"]` | The formats of the content: `html`, `readability`, `cleaned_html` or `markdown`. |
| `screenshot` | body | boolean | no | | Add a screenshot to the response. |
| `pdf` | body | boolean | no | | Add a PDF to the response. |
| `delay` | body | number | no | | Milliseconds to wait before Steel scrapes the page. |
| `useProxy` | body | boolean | no | | Use a Steel residential proxy. |
| `projectId` | body | string (uuid) | no | | The project to run the action in. Required with an organization key. |

| Field | Type | Description |
| - | - | - |
| `content` | object | The content in each format that you asked for: `html`, `cleaned_html`, `markdown` and `readability`. |
| `metadata` | object | The page metadata, such as `title`, `description`, `language`, `canonical`, the Open Graph fields, `jsonLd` and `statusCode`, the HTTP status of the page. |
| `links` | object\[] | The links on the page, each with `url` and `text`. |
| `screenshot` | object | With `screenshot: true`: the `url` of the screenshot. |
| `pdf` | object | With `pdf: true`: the `url` of the PDF. |

**cURL**

```sh
curl -X POST https://api.steel.dev/v1/scrape \
  -H "steel-api-key: $STEEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "format": ["markdown"]}'
```

**TypeScript**

```ts
const result = await client.scrape({
  url: "https://example.com",
  format: ["markdown"],
});

console.log(result.content.markdown);
```

**Python**

```python
result = client.scrape(
    url="https://example.com",
    format=["markdown"],
)

print(result.content.markdown)
```

**Go**

```go
result, err := client.Scrape(ctx, steel.ScrapeParams{
	URL:    steel.F("https://example.com"),
	Format: steel.F([]steel.ScrapeParamsFormat{steel.ScrapeParamsFormatMarkdown}),
})
if err != nil {
	return err
}

fmt.Println(result.Content.Markdown)
```

**Rust**

```rust
let result = client
    .scrape(steel_rs::ScrapeParams {
        format: Some(vec![steel_rs::ScrapeParamsFormat::Markdown]),
        ..steel_rs::ScrapeParams::new("https://example.com".to_owned())
    })
    .await?;

let markdown = result.content.markdown.unwrap_or_default();
println!("{markdown}");
```

See [Scrape](https://steel.dev/docs/control/scrape).

### Capture a screenshot

```http
POST /v1/screenshot
```

Opens a web page and returns the URL of a screenshot of it.

| Name | In | Type | Required | Default | Description |
| - | - | - | - | - | - |
| `url` | body | string (uri) | yes | | The URL of the page. |
| `fullPage` | body | boolean | no | `false` | Capture the whole page, not only the viewport. |
| `delay` | body | number | no | | Milliseconds to wait before Steel captures the screenshot. |
| `useProxy` | body | boolean | no | | Use a Steel residential proxy. |
| `projectId` | body | string (uuid) | no | | The project to run the action in. Required with an organization key. |

| Field | Type | Description |
| - | - | - |
| `url` | string (uri) | The URL of the screenshot. |

**cURL**

```sh
curl -X POST https://api.steel.dev/v1/screenshot \
  -H "steel-api-key: $STEEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "fullPage": true}'
```

**TypeScript**

```ts
const result = await client.screenshot({
  url: "https://example.com",
  fullPage: true,
});

console.log(result.url);
```

**Python**

```python
result = client.screenshot(
    url="https://example.com",
    full_page=True,
)

print(result.url)
```

**Go**

```go
result, err := client.Screenshot(ctx, steel.ScreenshotParams{
	URL:      steel.F("https://example.com"),
	FullPage: steel.F(true),
})
if err != nil {
	return err
}

fmt.Println(result.URL)
```

**Rust**

```rust
let result = client
    .screenshot(steel_rs::ScreenshotParams {
        full_page: Some(true),
        ..steel_rs::ScreenshotParams::new("https://example.com".to_owned())
    })
    .await?;

println!("{}", result.url);
```

See [Screenshot](https://steel.dev/docs/control/scrape#take-a-screenshot).
