Read the results of a crawl
Issues, pages and reports of a crawl, and the comparison with the previous one.
The issue summary
curl "https://api.nessflow.com/v1/crawls/$CRAWL_ID/issues/summary" \
-H "Authorization: Bearer $NESSFLOW_TOKEN"The summary returns issue families with their number of occurrences and the totals by severity. Findings that describe a firewall or interstitial page, rather than the site, leave every total; their number is returned separately (protection_occurrences).
Occurrences, filtered
One line per issue and per URL, filterable by severity, category or name:
curl "https://api.nessflow.com/v1/crawls/$CRAWL_ID/issues?severity=error&limit=50" \
-H "Authorization: Bearer $NESSFLOW_TOKEN"Pages
The list of crawled pages, or one page by its URL:
curl "https://api.nessflow.com/v1/crawls/$CRAWL_ID/pages/by-url?url=https%3A%2F%2Fexemple.fr%2F" \
-H "Authorization: Bearer $NESSFLOW_TOKEN"Reports
Each crawl carries frozen reports: pagespeed, geo, accessibility, eeat and structure. Each declares its status (ready, pending or unavailable) and the scoring version that produced it:
curl "https://api.nessflow.com/v1/crawls/$CRAWL_ID/geo" \
-H "Authorization: Bearer $NESSFLOW_TOKEN"A missing report is never returned as zeros: score: null means "not measured".
Compare with the previous crawl
curl "https://api.nessflow.com/v1/crawls/$CRAWL_ID/compare" \
-H "Authorization: Bearer $NESSFLOW_TOKEN"Without a parameter, the baseline is the previous comparable crawl of the same project. A truncated crawl never is one: when no baseline exists, the API answers 404 crawl.no_baseline.