---
title: "Run a source (billed to your balance)"
method: POST
path: "/v1/run"
---

# Run a source (billed to your balance)

`POST /v1/run`

## Request

- Base URL: `https://prolevelmax.com`
- URL: `https://prolevelmax.com/v1/run`
- Auth: HTTP bearer

## Request body

- RunRequest
  - `scraper` string, required: Source id from discover
  - `input` object, required: Input fields (see inspect)
  - `maxItems` integer: Per-result sources: most results to return (default 100)
  - `timeout` integer: Seconds
  - `async` boolean: Return 202 with a runId at once

## Response `200`

Finished run with its results

- RunResult
  - `runId` string
  - `items` unknown[]
    - unknown
  - `count` integer: Records returned
  - `page` object: Per-call sources: cursor values for the next page
  - `capped` 'default_100' | 'balance' | 'source_max' | 'size'
  - `cappedNote` string
  - `cost` Cost
    - `type` string
    - `amount` number
    - `amountDisplay` string
    - `breakdown` string
    - `currency` 'USD'
  - `quote` Quote
    - `maxCharge` number: The most this run can cost, USD
    - `maxChargeDisplay` string
    - `maxResults` integer
    - `needsConfirmation` boolean: True above $0.10: ask the user before running
    - `basis` string
    - `balanceTooLow` boolean
    - `minBalanceToStart` string
    - `reducedByBalance` boolean
    - `currency` 'USD'
  - `wallet` object
    - `balance` number
    - `balanceDisplay` string
  - `download` Downloads
    - `json` string
    - `csv` string
    - `xlsx` string

## Other responses

- `202`: Async run started
- `400`: Error
- `401`: Error
- `402`: Error
- `404`: Error
- `409`: Error
- `422`: Error
- `429`: Error
- `502`: Error
- `503`: Error

---

[API](https://skmtc.dev/prolevelmax/apis/prolevelmax-api.md) · [All operations](https://skmtc.dev/prolevelmax/apis/prolevelmax-api/llms.txt) · [OpenAPI document](https://skmtc.dev/prolevelmax/apis/prolevelmax-api/revisions/79eea95313e9?raw)