Two crawls of a site compared, filter by filter
Two crawls of one site side by side: every filter's URL count in the newer and the older crawl with Added, New, Removed and Missing, the URL totals (after URL mapping when the site has one) and Change Detection over the pages present in both. Defaults to the newest accepted v2 crawl against the one before it; an explicit pair may run either way. When state.status is not built, there is nothing to read yet: call comparisons_start, then read again (a build takes seconds to minutes). A site with fewer than two comparable crawls answers comparable_crawls and no pair. For what an agent fixes next (issues appeared, gone, moved), read changes_get.
Request
- Base URL: https://frontshelf.io/api
- URL: https://frontshelf.io/api/v1/sites/{site}/comparison
- Auth: HTTP bearer
Path parameters
Site ID (site_…), origin (https://example.com), or bare domain, resolved server-side; the response carries the canonical ID.
Query parameters
The earlier crawl; omit for the accepted v2 crawl before the current one.
The later crawl; omit for the site's newest accepted v2 crawl.
Most filters answered (default 100, at most 400); filters with any movement come first.
Response
Two crawls of a site compared, filter by filter
Changes
No recorded changes to this operation across all 1 revision of this API.