> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parserouter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Working with the response

> Use the returned Markdown, or filter the structured content blocks and their bounding boxes.

A parse returns the document two ways: a ready-to-use `markdown` string, and a `content_list` of typed **blocks** in reading order for when you need structure or position. Pick whichever fits.

## The shape, recapped

```json theme={null}
{
  "markdown": "# Quarterly Report\n\n...",
  "page_count": 1,
  "content_list": [
    {
      "type": "text",
      "text": "Quarterly Report",
      "text_level": 1,
      "page_idx": 0,
      "bbox": [80, 60, 620, 110]
    }
  ]
}
```

`content_list` is a flat list across the whole document; each block carries a `type`, type-specific content fields, a `page_idx` (which page it's on, 0-based), and a `bbox` (position). See the [API reference](/parse) for the full field list.

## Just use the Markdown

For most uses — feeding an LLM, indexing for search, displaying the document — you don't need the blocks at all. The `markdown` field is the whole document already assembled, with headings, inline tables and equations, and image links:

```python theme={null}
markdown = data["markdown"]
```

Reach for `content_list` only when you need to filter by block type or work with positions.

## Filter blocks by type

Because every block is typed, pulling out one kind of content is a filter. For example, collect every table (table content comes through as HTML in `table_body`):

```python theme={null}
tables = [
    block["table_body"]
    for block in data["content_list"]
    if block["type"] == "table"
]
```

The field you read depends on the type: `text` blocks (and titles, headers, footers) use `text`; `equation` uses `text` (LaTeX); `image`/`chart` use `img_path` and `content`; `list` uses `list_items`; `code` uses `code_body`. Headings are `text` blocks that also carry a `text_level` (1–4), so you can pull just the titles:

```python theme={null}
titles = [b["text"] for b in data["content_list"] if b.get("text_level")]
```

## Use bounding boxes

Each `bbox` is `[x_min, y_min, x_max, y_max]`, scaled to **0–1000 of the page** (not pixels), with the origin at the top-left. Because they're relative, they work at any resolution — divide by 1000 and multiply by your rendered page's pixel size, for example to crop a figure:

```python theme={null}
x_min, y_min, x_max, y_max = block["bbox"]
left, top = x_min / 1000 * page_width, y_min / 1000 * page_height
right, bottom = x_max / 1000 * page_width, y_max / 1000 * page_height
# crop = image.crop((left, top, right, bottom))
```

Coordinates are relative to the block's own page, so use `block["page_idx"]` to pick the right rendered page before applying them.