List, search or read a run's pages
list_pagesList the pages a project run stored; with q, find the pages whose text or markup matches; with url, read one page in full, with its versions across runs. Use it for what a project's runs stored: what a run covered, which pages say something, one page's text. search_web searches the live web instead, get_job reads a crawl_site crawl, scrape_urls fetches a live copy, and get_changes lists only what changed. Inputs: project_id from list_projects. q='free trial' needs both words, q='"free trial"' the phrase; mode='selector' takes CSS such as 'form#signup' and needs a run that kept html (the rawHtml format); a selector search names the pages it could not search. url is an address, not a search term: scheme and trailing slash may differ or be left out, and a path alone is the project's own site; the rest must match, query string included. Give q or url, not both. run_id from list_runs picks the run; empty is the latest full run, and a newer re-crawl of listed pages is named as newerPartialRun. Limits: a listing has up to 500 rows, shallowest first, so use q to reach pages past them. A page read in full has each body capped at 12,000 characters, and a URL the runs did not store answers 404. Read-only and free: it reads stored data and never fetches.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"project_id": "<project_id>"
},
"name": "list_pages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Text to find, 1 to 200 characters: words or a "quoted phrase", or with mode='selector' a CSS selector or an XPath starting with / or (. Omit to list every page. | |
| url | No | One page's full URL, as a listing shows it, to read that page in full; omit to list. | |
| mode | No | With q: 'content' (default) searches the markdown, 'selector' the stored html. | content |
| run_id | No | A run's id, from list_runs; empty means the latest finished run, or with url the newest copy across the project's last 50 runs. | |
| project_id | Yes | The project's 32-character hex id, from list_projects. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | With url: the page's URL as stored. | |
| code | No | Only on a failure: a machine-readable reason, e.g. read_only, validation, plan_limit or not_found. | |
| head | No | With url: {title, description, canonical, h1, ...}. | |
| hits | No | With q: up to 500 matches, each {url, count (matches on the page), snippet}. | |
| html | No | With url: the raw html, when the run kept it. | |
| text | No | With url: plain text, when kept. | |
| error | No | Only when the call failed: what went wrong, in words an assistant can act on. | |
| pages | No | Listing: up to 500 rows, shallowest first, each {url, path, status, depth, words, changed, title, crawledAt}. | |
| runId | No | The run these pages are from (with url, the run this copy is from); null when the project has no finished run. | |
| words | No | With url: words in its markdown. | |
| detail | No | Only on a failure: the API's own wording, when the error was rephrased. | |
| fields | No | With url: fields the project's json_schema extracted, or null. | |
| noBody | No | With q: pages skipped because the body the mode needs was not kept (rawHtml for selector). | |
| status | No | With url: the HTTP status the site answered. On an error, the API's status code. | |
| scanned | No | With q: pages searched. | |
| markdown | No | With url: its main content as markdown, capped at 12,000 characters. | |
| versions | No | With url: every stored copy across runs, newest first, each {runId, crawledAt, contentHash, words, status}; a changed contentHash is a changed page. | |
| cleanHtml | No | With url: simplified html, when kept. | |
| crawledAt | No | With url: when this copy was read (ISO 8601). | |
| linkGraph | No | Listing: the run's link-graph summary (orphans, unlisted pages, dead ends), or null. | |
| truncated | No | With q: true when more pages matched than are listed. | |
| pageStatus | No | With url: ok, blocked, captcha, missing (404/410), unreachable (no such site), timeout, redirect, robots or skipped. |