## web/agent

`GET /v1/web/agent`

Start an asynchronous browser agent: a hosted browser opens the page and the platform's model chooses navigate, click, type or done for up to eight steps. Returns a job; poll /v1/web/jobs/{job_id} for the final page, the extracted answer and every step taken.

*Browser agent*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Page to start from (http/https) — e.g. `https://www.gov.uk/bank-holidays` |
| `prompt` | yes | What the agent should do or find (up to 2,000 characters) — e.g. `Find the date of the next bank holiday in England and Wales` |
| `max_steps` | no | Most actions to take, 1 to 8 (default 8) — e.g. `6` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. — e.g. `1` |

**Cost:** 10 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/web/agent?url=https%3A%2F%2Fwww.gov.uk%2Fbank-holidays&prompt=Find%20the%20date%20of%20the%20next%20bank%20holiday%20in%20England%20and%20Wales" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "id": "job_example",
  "status": "queued"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/web/agent#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/web/agent.json)