---
title: "Agent task canaries: four safe, read-only tasks run daily as an HTML-reading browsing agent on a frame of store sites (find a product page, read its price, search the catalogue, reach the cart; GET only, nothing submitted or bought). Without ?domain= the summary per task; with ?domain= the site's last runs and 14-run success rates. Resolve carries task_canaries for frame members. Signed (crawlcheck-task-canaries)"
method: GET
path: "/api/v1/task-canaries"
---

# Agent task canaries: four safe, read-only tasks run daily as an HTML-reading browsing agent on a frame of store sites (find a product page, read its price, search the catalogue, reach the cart; GET only, nothing submitted or bought). Without ?domain= the summary per task; with ?domain= the site's last runs and 14-run success rates. Resolve carries task_canaries for frame members. Signed (crawlcheck-task-canaries)

`GET /api/v1/task-canaries`

## Request

- Base URL: `https://crawlcheck.io`
- URL: `https://crawlcheck.io/api/v1/task-canaries`
- Auth: none required

## Query parameters

- `domain` string

## Response `200`

crawlcheck-task-canaries

- object, nullable
  - `kind` string, nullable
  - `v` number, nullable
  - `summary` object, nullable
    - `at` string, nullable
    - `frame` number, nullable
    - `measured` number, nullable
    - `all_tasks_ok` number, nullable
    - `no_task_ok` number, nullable
    - `by_task` object, nullable
      - `find_product` object, nullable
        - `sites` number, nullable
        - `ok` number, nullable
        - `success_rate` number, nullable
      - `read_price` object, nullable
        - `sites` number, nullable
        - `ok` number, nullable
        - `success_rate` number, nullable
      - `search_catalogue` object, nullable
        - `sites` number, nullable
        - `ok` number, nullable
        - `success_rate` number, nullable
      - `reach_cart` object, nullable
        - `sites` number, nullable
        - `ok` number, nullable
        - `success_rate` number, nullable
    - `candidates_checked` number, nullable
  - `tasks` string[], nullable
  - `method` unknown
  - `frame_rule` unknown
  - `lookup` string, nullable
  - `sha256` unknown
  - `signature` unknown

## Other responses

- `404`: not in the frame

---

[API](https://skmtc.dev/crawlcheck/apis/crawlcheck-api.md) · [All operations](https://skmtc.dev/crawlcheck/apis/crawlcheck-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlcheck/apis/crawlcheck-api/revisions/57acbd6d4489?raw)