## on_page/page

`GET /v1/on_page/page`

On-page SEO audit of one URL: title and meta description checks, heading structure, image alt coverage, internal/external links, canonical, robots meta, social tags, HTTPS, word count, and a severity-ranked findings list.

*On-page SEO audit*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Page URL to audit (http/https, public hosts only) — e.g. `https://example.com` |
| `timeout` | no | Fetch budget in milliseconds, clamped to 1000-15000 — e.g. `10000` |
| `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:** 3 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/on_page/page?url=https%3A%2F%2Fexample.com" \
  -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
{
  "_warnings": [
    "example"
  ],
  "final_url": "https://example.com/example",
  "findings": [
    {
      "id": "example",
      "message": "example",
      "severity": "example"
    }
  ],
  "headings": {
    "counts": {
      "h1": 0,
      "h2": 0,
      "h3": 0,
      "h4": 0,
      "h5": 0,
      "h6": 0
    },
    "h1_count": 0,
    "outline": [
      {
        "level": 0,
        "text": "example"
      }
    ],
    "structure_ok": false
  },
  "https": false,
  "images": {
    "total": 0,
    "with_alt": 0,
    "without_alt": 0
  },
  "language": "example",
  "links": {
    "external": 0,
    "internal": 0,
    "total": 0
  },
  "meta_description": {
    "length": 0,
    "present": false
  },
  "open_graph": {
    "complete": false,
    "missing": [
      "example"
    ],
    "present": 0
  },
  "redirected": false,
  "robots": {
    "nofollow": false,
    "noindex": false
  },
  "status": 0,
  "title": {
    "length": 0,
    "present": false,
    "text": "example"
  },
  "twitter_card": {
    "complete": false,
    "missing": [
      "example"
    ],
    "present": 0
  },
  "url": "https://example.com/example",
  "viewport_meta": false,
  "word_count": 0
}
```

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