Crawl pages

GET /api/v1/crawl/{id}/pages

Every URL discovered in a crawl, each carrying its complete single-page audit — the same score, grade and full set of on-page checks as GET /api/v1/audit — paginated, so one crawl audits a whole site in full.

Path & query

NameTypeDescription
jobId requiredstringThe crawl job id.
limit optionalintegerMax pages to return. Default 100, max 1000.
offset optionalintegerNumber of pages to skip (pagination). Default 0.
fields optionalstringfull (default) includes each page's complete audit; summary omits the heavy audit object and returns score/grade/issues only.

Request

Response

200 · application/json
  1. {
  2. "jobId": "crw_7Hk29fQ",
  3. "startUrl": "https://example.com",
  4. "host": "example.com",
  5. "status": "done",
  6. "maxPages": 50,
  7. "createdAt": "2026-06-02T13:24:49.414Z",
  8. "finishedAt": "2026-06-02T13:24:52.055Z",
  9. "limit": 100,
  10. "offset": 0,
  11. "count": 1,
  12. "items": [
  13. {
  14. "url": "https://example.com/about",
  15. "statusCode": 200,
  16. "score": 88,
  17. "grade": "B",
  18. "title": "About — Example",
  19. "metaDescription": "Learn more about Example.",
  20. "h1": "About us",
  21. "wordCount": 540,
  22. "internalLinks": 28,
  23. "depth": 1,
  24. "issues": ["Meta description is long (>160 chars)"],
  25. "audit": { "score": 88, "grade": "B", "checks": { "title": { }, "readability": { }, "techStack": [ ], "...": "the full audit — same as GET /api/v1/audit" } }
  26. }
  27. ]
  28. }

Response fields

FieldTypeDescription
countintegerNumber of items in this page of results.
limit / offsetintegerPagination echo of the values used for this request.
items[].urlstringThe page URL.
items[].statusCodeintegerHTTP status code returned for the page.
items[].score / gradeinteger / stringOn-page SEO score (0–100) and grade (A–F) for the page.
items[].auditobjectThe page's complete single-page audit — the exact same score, grade, issues and full checks object returned by GET /api/v1/audit. Every crawled page is audited in full. Omitted when fields=summary.
items[].titlestringThe page's <title> text.
items[].metaDescriptionstringThe page's meta description.
items[].h1stringThe page's first <h1> text.
items[].wordCountintegerNumber of words in the page body.
items[].internalLinksintegerCount of internal links found on the page.
items[].depthintegerLink distance from the start URL (0 = start page).
items[].issuesarrayThe page's audit issues — the same human-readable strings as GET /api/v1/audit (e.g. Missing meta description, No canonical URL), or ["broken"] for non-200 pages.

See Errors for status codes.

← Previous
Crawl summary