Skip to main content
Glama

Get AI traffic

get_ai_traffic
Read-onlyIdempotent

AI crawler requests and AI-referred visits to the brand's site, from its tracking; connected is false when tracking is not set up. Visits are human page views; bots, crawlers and Cleotic's own fetches are never visits. AI share is AI-referred visits as a percentage of human visits; crawler requests are counted on their own. view summary: totals, providers, crawlers, search engines (listed, never counted), referral sources, pages to improve, by week. view pages: per-page traffic. view evidence: individual visits. Only pages and evidence are paged.

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": {
      "brand": "<brand>"
    },
    "name": "get_ai_traffic"
  }
}

Input Schema

NameRequiredDescriptionDefault
toNoEnd date, YYYY-MM-DD, inclusive; from equal to to is a single day. Defaults to today; a later date is treated as today.
fromNoStart date, YYYY-MM-DD. Defaults to 30 days before to. Windows are at most 180 days and a from after today is refused; a plan with limited history serves only the days it keeps and says so in retention.
pathNoOptional exact page path, for example /pricing.
viewNoDefaults to summary.
brandYesBrand or study: its ID from list_brands, or its name (exact or a unique prefix).
limitNoRows per page. Defaults to 25, max 100. A page may hold fewer rows to stay within the response size; follow next_cursor.
cursorNonext_cursor from the previous page. Leave out for the first page.
providerNoOptional AI provider, as the summary's systems name it, for example OpenAI; capitalisation does not matter. A provider with no traffic in the period is refused as unknown.
traffic_typeNoOptional filter.
traffic_viewNoOptional filter set: a built-in view (pages, discovery, previews, errors, spoofed, everything) or a saved view ID. Defaults to pages: loaded pages from verified or unverifiable bots and AI referrals.

Output Schema

NameRequiredDescriptionDefault
dataYes
generated_atYesRFC 3339 time the response was made.
schema_versionYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / data / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "ai_referrals": {
      -        "type": "integer"
      -      },
      -      "ai_share": {
      -        "description": "AI-referred visits as a percentage of human visits.",
      -        "type": "number"
      -      },
      -      "ai_visits": {
      -        "description": "Human visits that arrived from an AI assistant.",
      -        "type": "integer"
      -      },
      -      "brand": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "id": {
      -            "type": "string"
      -          },
      -          "name": {
      -            "type": "string"
      -          },
      -          "url": {
      -            "description": "The brand's website, or empty when none is set.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "id",
      -          "name",
      -          "url"
      -        ],
      -        "type": "object"
      -      },
      -      "connected": {
      -        "description": "Whether site tracking is set up; when false nothing is measured.",
      -        "type": "boolean"
      -      },
      -      "crawler_visits": {
      -        "description": "AI crawler requests. These are not visits and are not part of ai_share.",
      -        "type": "integer"
      -      },
      -      "crawlers": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "name": {
      -              "type": "string"
      -            },
      -            "pages": {
      -              "type": "integer"
      -            },
      -            "provider": {
      -              "type": "string"
      -            },
      -            "purpose": {
      -              "description": "Why the crawler fetched pages: ai_user (for a live user question), ai_search (to build an AI search index) or ai_training (to collect model training data).",
      -              "type": "string"
      -            },
      -            "verified": {
      -              "description": "Visits whose IP address is in the operator's published crawler IP list.",
      -              "type": "integer"
      -            },
      -            "visits": {
      -              "type": "integer"
      -            }
      -          },
      -          "required": [
      -            "name",
      -            "provider",
      -            "purpose",
      -            "visits",
      -            "verified",
      -            "pages"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "latest_visit_at": {
      -        "type": "string"
      -      },
      -      "pages_reached": {
      -        "description": "Distinct pages an AI crawler or AI referral reached.",
      -        "type": "integer"
      -      },
      -      "pages_to_improve": {
      -        "description": "Pages AI crawlers read but people rarely reach from AI answers.",
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "ai_referrals": {
      -              "type": "integer"
      -            },
      -            "ai_visits": {
      -              "description": "Human visits to the page that arrived from an AI assistant.",
      -              "type": "integer"
      -            },
      -            "change": {
      -              "description": "Change in the page's AI share (AI-referred visits as a percentage of human visits) on the previous period, in percentage points; null when the page had no human visits before.",
      -              "type": [
      -                "null",
      -                "number"
      -              ]
      -            },
      -            "crawler_visits": {
      -              "type": "integer"
      -            },
      -            "path": {
      -              "type": "string"
      -            },
      -            "providers": {
      -              "items": {
      -                "type": "string"
      -              },
      -              "type": "array"
      -            },
      -            "total_visits": {
      -              "description": "Human visits to the page.",
      -              "type": "integer"
      -            },
      -            "url": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "path",
      -            "url",
      -            "total_visits",
      -            "ai_visits",
      -            "crawler_visits",
      -            "ai_referrals",
      -            "providers",
      -            "change"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "period": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "from": {
      -            "description": "First day, YYYY-MM-DD.",
      -            "type": "string"
      -          },
      -          "to": {
      -            "description": "Last day, YYYY-MM-DD.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "from",
      -          "to"
      -        ],
      -        "type": "object"
      -      },
      -      "referral_sources": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "name": {
      -              "type": "string"
      -            },
      -            "pages": {
      -              "type": "integer"
      -            },
      -            "provider": {
      -              "type": "string"
      -            },
      -            "referrals": {
      -              "type": "integer"
      -            },
      -            "source": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "source",
      -            "name",
      -            "provider",
      -            "referrals",
      -            "pages"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "systems": {
      -        "description": "AI providers, by visits.",
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "ai_referrals": {
      -              "type": "integer"
      -            },
      -            "crawler_visits": {
      -              "type": "integer"
      -            },
      -            "pages": {
      -              "type": "integer"
      -            },
      -            "provider": {
      -              "description": "Pass as provider to filter.",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "provider",
      -            "crawler_visits",
      -            "ai_referrals",
      -            "pages"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "total_visits": {
      -        "description": "Human page visits. Bots, crawlers and Cleotic's own fetches are not counted.",
      -        "type": "integer"
      -      },
      -      "view": {
      -        "type": "string"
      -      },
      -      "weekly": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "ai_referrals": {
      -              "type": "integer"
      -            },
      -            "crawler_visits": {
      -              "type": "integer"
      -            },
      -            "week_start": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "week_start",
      -            "crawler_visits",
      -            "ai_referrals"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      }
      -    },
      -    "required": [
      -      "brand",
      -      "view",
      -      "period",
      -      "connected",
      -      "total_visits",
      -      "ai_visits",
      -      "ai_share",
      -      "crawler_visits",
      -      "ai_referrals",
      -      "pages_reached",
      -      "latest_visit_at",
      -      "systems",
      -      "crawlers",
      -      "referral_sources",
      -      "pages_to_improve",
      -      "weekly"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "brand": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "id": {
      -            "type": "string"
      -          },
      -          "name": {
      -            "type": "string"
      -          },
      -          "url": {
      -            "description": "The brand's website, or empty when none is set.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "id",
      -          "name",
      -          "url"
      -        ],
      -        "type": "object"
      -      },
      -      "connected": {
      -        "type": "boolean"
      -      },
      -      "pages": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "ai_referrals": {
      -              "type": "integer"
      -            },
      -            "ai_visits": {
      -              "description": "Human visits to the page that arrived from an AI assistant.",
      -              "type": "integer"
      -            },
      -            "change": {
      -              "description": "Change in the page's AI share (AI-referred visits as a percentage of human visits) on the previous period, in percentage points; null when the page had no human visits before.",
      -              "type": [
      -                "null",
      -                "number"
      -              ]
      -            },
      -            "crawler_visits": {
      -              "type": "integer"
      -            },
      -            "path": {
      -              "type": "string"
      -            },
      -            "providers": {
      -              "items": {
      -                "type": "string"
      -              },
      -              "type": "array"
      -            },
      -            "total_visits": {
      -              "description": "Human visits to the page.",
      -              "type": "integer"
      -            },
      -            "url": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "path",
      -            "url",
      -            "total_visits",
      -            "ai_visits",
      -            "crawler_visits",
      -            "ai_referrals",
      -            "providers",
      -            "change"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "pagination": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "next_cursor": {
      -            "description": "Pass as cursor to get the next page; empty on the last page.",
      -            "type": "string"
      -          },
      -          "total": {
      -            "description": "Items across all pages; null when not counted.",
      -            "type": [
      -              "null",
      -              "integer"
      -            ]
      -          }
      -        },
      -        "required": [
      -          "next_cursor",
      -          "total"
      -        ],
      -        "type": "object"
      -      },
      -      "period": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "from": {
      -            "description": "First day, YYYY-MM-DD.",
      -            "type": "string"
      -          },
      -          "to": {
      -            "description": "Last day, YYYY-MM-DD.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "from",
      -          "to"
      -        ],
      -        "type": "object"
      -      },
      -      "view": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "brand",
      -      "view",
      -      "period",
      -      "connected",
      -      "pages",
      -      "pagination"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "brand": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "id": {
      -            "type": "string"
      -          },
      -          "name": {
      -            "type": "string"
      -          },
      -          "url": {
      -            "description": "The brand's website, or empty when none is set.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "id",
      -          "name",
      -          "url"
      -        ],
      -        "type": "object"
      -      },
      -      "connected": {
      -        "type": "boolean"
      -      },
      -      "pagination": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "next_cursor": {
      -            "description": "Pass as cursor to get the next page; empty on the last page.",
      -            "type": "string"
      -          },
      -          "total": {
      -            "description": "Items across all pages; null when not counted.",
      -            "type": [
      -              "null",
      -              "integer"
      -            ]
      -          }
      -        },
      -        "required": [
      -          "next_cursor",
      -          "total"
      -        ],
      -        "type": "object"
      -      },
      -      "period": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "from": {
      -            "description": "First day, YYYY-MM-DD.",
      -            "type": "string"
      -          },
      -          "to": {
      -            "description": "Last day, YYYY-MM-DD.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "from",
      -          "to"
      -        ],
      -        "type": "object"
      -      },
      -      "view": {
      -        "type": "string"
      -      },
      -      "visits": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "captured_at": {
      -              "type": "string"
      -            },
      -            "name": {
      -              "description": "The crawler or referring AI product.",
      -              "type": "string"
      -            },
      -            "path": {
      -              "type": "string"
      -            },
      -            "provider": {
      -              "type": "string"
      -            },
      -            "type": {
      -              "description": "crawler or referral.",
      -              "type": "string"
      -            },
      -            "url": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "type",
      -            "path",
      -            "url",
      -            "provider",
      -            "name",
      -            "captured_at"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      }
      -    },
      -    "required": [
      -      "brand",
      -      "view",
      -      "period",
      -      "connected",
      -      "visits",
      -      "pagination"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "ai_referrals": {
      +        "type": "integer"
      +      },
      +      "ai_share": {
      +        "description": "AI-referred visits as a percentage of human visits.",
      +        "type": "number"
      +      },
      +      "ai_visits": {
      +        "description": "Human visits that arrived from an AI assistant.",
      +        "type": "integer"
      +      },
      +      "brand": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "id": {
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "The brand's website, or empty when none is set.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "id",
      +          "name",
      +          "url"
      +        ],
      +        "type": "object"
      +      },
      +      "connected": {
      +        "description": "Whether site tracking is set up; when false nothing is measured.",
      +        "type": "boolean"
      +      },
      +      "crawler_visits": {
      +        "description": "AI crawler requests. These are not visits and are not part of ai_share.",
      +        "type": "integer"
      +      },
      +      "crawlers": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "name": {
      +              "type": "string"
      +            },
      +            "pages": {
      +              "type": "integer"
      +            },
      +            "provider": {
      +              "type": "string"
      +            },
      +            "purpose": {
      +              "description": "Why the crawler fetched pages: ai_user (for a live user question), ai_search (to build an AI search index), ai_training (to collect model training data) or, in search_engines, search_engine.",
      +              "type": "string"
      +            },
      +            "verified": {
      +              "description": "Visits whose IP address is in the operator's published crawler IP list.",
      +              "type": "integer"
      +            },
      +            "visits": {
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "name",
      +            "provider",
      +            "purpose",
      +            "visits",
      +            "verified",
      +            "pages"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "latest_visit_at": {
      +        "type": "string"
      +      },
      +      "pages_reached": {
      +        "description": "Distinct pages an AI crawler or AI referral reached.",
      +        "type": "integer"
      +      },
      +      "pages_to_improve": {
      +        "description": "Pages AI crawlers read but people rarely reach from AI answers.",
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "ai_referrals": {
      +              "type": "integer"
      +            },
      +            "ai_visits": {
      +              "description": "Human visits to the page that arrived from an AI assistant.",
      +              "type": "integer"
      +            },
      +            "change": {
      +              "description": "Change in the page's AI share (AI-referred visits as a percentage of human visits) on the previous period, in percentage points; null when the page had no human visits before.",
      +              "type": [
      +                "null",
      +                "number"
      +              ]
      +            },
      +            "crawler_visits": {
      +              "type": "integer"
      +            },
      +            "path": {
      +              "type": "string"
      +            },
      +            "providers": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "total_visits": {
      +              "description": "Human visits to the page.",
      +              "type": "integer"
      +            },
      +            "url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "path",
      +            "url",
      +            "total_visits",
      +            "ai_visits",
      +            "crawler_visits",
      +            "ai_referrals",
      +            "providers",
      +            "change"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "period": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "from": {
      +            "description": "First day, YYYY-MM-DD.",
      +            "type": "string"
      +          },
      +          "to": {
      +            "description": "Last day, YYYY-MM-DD.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "from",
      +          "to"
      +        ],
      +        "type": "object"
      +      },
      +      "referral_sources": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "name": {
      +              "type": "string"
      +            },
      +            "pages": {
      +              "type": "integer"
      +            },
      +            "provider": {
      +              "type": "string"
      +            },
      +            "referrals": {
      +              "type": "integer"
      +            },
      +            "source": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "source",
      +            "name",
      +            "provider",
      +            "referrals",
      +            "pages"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "search_engines": {
      +        "description": "Search engine crawlers such as Googlebot and Bingbot, with purpose search_engine. Their indexes also feed AI answers, but the same requests serve ordinary search, so no total counts them.",
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "name": {
      +              "type": "string"
      +            },
      +            "pages": {
      +              "type": "integer"
      +            },
      +            "provider": {
      +              "type": "string"
      +            },
      +            "purpose": {
      +              "description": "Why the crawler fetched pages: ai_user (for a live user question), ai_search (to build an AI search index), ai_training (to collect model training data) or, in search_engines, search_engine.",
      +              "type": "string"
      +            },
      +            "verified": {
      +              "description": "Visits whose IP address is in the operator's published crawler IP list.",
      +              "type": "integer"
      +            },
      +            "visits": {
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "name",
      +            "provider",
      +            "purpose",
      +            "visits",
      +            "verified",
      +            "pages"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "systems": {
      +        "description": "AI providers, by visits.",
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "ai_referrals": {
      +              "type": "integer"
      +            },
      +            "crawler_visits": {
      +              "type": "integer"
      +            },
      +            "pages": {
      +              "type": "integer"
      +            },
      +            "provider": {
      +              "description": "Pass as provider to filter.",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "provider",
      +            "crawler_visits",
      +            "ai_referrals",
      +            "pages"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "total_visits": {
      +        "description": "Human page visits. Bots, crawlers and Cleotic's own fetches are not counted.",
      +        "type": "integer"
      +      },
      +      "view": {
      +        "type": "string"
      +      },
      +      "weekly": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "ai_referrals": {
      +              "type": "integer"
      +            },
      +            "crawler_visits": {
      +              "type": "integer"
      +            },
      +            "week_start": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "week_start",
      +            "crawler_visits",
      +            "ai_referrals"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "brand",
      +      "view",
      +      "period",
      +      "connected",
      +      "total_visits",
      +      "ai_visits",
      +      "ai_share",
      +      "crawler_visits",
      +      "ai_referrals",
      +      "pages_reached",
      +      "latest_visit_at",
      +      "systems",
      +      "crawlers",
      +      "search_engines",
      +      "referral_sources",
      +      "pages_to_improve",
      +      "weekly"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "brand": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "id": {
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "The brand's website, or empty when none is set.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "id",
      +          "name",
      +          "url"
      +        ],
      +        "type": "object"
      +      },
      +      "connected": {
      +        "type": "boolean"
      +      },
      +      "pages": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "ai_referrals": {
      +              "type": "integer"
      +            },
      +            "ai_visits": {
      +              "description": "Human visits to the page that arrived from an AI assistant.",
      +              "type": "integer"
      +            },
      +            "change": {
      +              "description": "Change in the page's AI share (AI-referred visits as a percentage of human visits) on the previous period, in percentage points; null when the page had no human visits before.",
      +              "type": [
      +                "null",
      +                "number"
      +              ]
      +            },
      +            "crawler_visits": {
      +              "type": "integer"
      +            },
      +            "path": {
      +              "type": "string"
      +            },
      +            "providers": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "total_visits": {
      +              "description": "Human visits to the page.",
      +              "type": "integer"
      +            },
      +            "url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "path",
      +            "url",
      +            "total_visits",
      +            "ai_visits",
      +            "crawler_visits",
      +            "ai_referrals",
      +            "providers",
      +            "change"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "pagination": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "next_cursor": {
      +            "description": "Pass as cursor to get the next page; empty on the last page.",
      +            "type": "string"
      +          },
      +          "total": {
      +            "description": "Items across all pages; null when not counted.",
      +            "type": [
      +              "null",
      +              "integer"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "next_cursor",
      +          "total"
      +        ],
      +        "type": "object"
      +      },
      +      "period": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "from": {
      +            "description": "First day, YYYY-MM-DD.",
      +            "type": "string"
      +          },
      +          "to": {
      +            "description": "Last day, YYYY-MM-DD.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "from",
      +          "to"
      +        ],
      +        "type": "object"
      +      },
      +      "view": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "brand",
      +      "view",
      +      "period",
      +      "connected",
      +      "pages",
      +      "pagination"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "brand": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "id": {
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "The brand's website, or empty when none is set.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "id",
      +          "name",
      +          "url"
      +        ],
      +        "type": "object"
      +      },
      +      "connected": {
      +        "type": "boolean"
      +      },
      +      "pagination": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "next_cursor": {
      +            "description": "Pass as cursor to get the next page; empty on the last page.",
      +            "type": "string"
      +          },
      +          "total": {
      +            "description": "Items across all pages; null when not counted.",
      +            "type": [
      +              "null",
      +              "integer"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "next_cursor",
      +          "total"
      +        ],
      +        "type": "object"
      +      },
      +      "period": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "from": {
      +            "description": "First day, YYYY-MM-DD.",
      +            "type": "string"
      +          },
      +          "to": {
      +            "description": "Last day, YYYY-MM-DD.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "from",
      +          "to"
      +        ],
      +        "type": "object"
      +      },
      +      "view": {
      +        "type": "string"
      +      },
      +      "visits": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "captured_at": {
      +              "type": "string"
      +            },
      +            "name": {
      +              "description": "The crawler or referring AI product.",
      +              "type": "string"
      +            },
      +            "path": {
      +              "type": "string"
      +            },
      +            "provider": {
      +              "type": "string"
      +            },
      +            "type": {
      +              "description": "crawler or referral.",
      +              "type": "string"
      +            },
      +            "url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "type",
      +            "path",
      +            "url",
      +            "provider",
      +            "name",
      +            "captured_at"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "brand",
      +      "view",
      +      "period",
      +      "connected",
      +      "visits",
      +      "pagination"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Changed1 schema field changed
    • changedOutput schema / properties / data / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "ai_referrals": {
      -        "type": "integer"
      -      },
      -      "ai_share": {
      -        "description": "AI visits as a percentage of all visits.",
      -        "type": "number"
      -      },
      -      "ai_visits": {
      -        "type": "integer"
      -      },
      -      "brand": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "id": {
      -            "type": "string"
      -          },
      -          "name": {
      -            "type": "string"
      -          },
      -          "url": {
      -            "description": "The brand's website, or empty when none is set.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "id",
      -          "name",
      -          "url"
      -        ],
      -        "type": "object"
      -      },
      -      "connected": {
      -        "description": "Whether site tracking is set up; when false nothing is measured.",
      -        "type": "boolean"
      -      },
      -      "crawler_visits": {
      -        "type": "integer"
      -      },
      -      "crawlers": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "name": {
      -              "type": "string"
      -            },
      -            "pages": {
      -              "type": "integer"
      -            },
      -            "provider": {
      -              "type": "string"
      -            },
      -            "purpose": {
      -              "description": "Why the crawler fetched pages: ai_user (for a live user question), ai_search (to build an AI search index) or ai_training (to collect model training data).",
      -              "type": "string"
      -            },
      -            "verified": {
      -              "description": "Visits whose IP address is in the operator's published crawler IP list.",
      -              "type": "integer"
      -            },
      -            "visits": {
      -              "type": "integer"
      -            }
      -          },
      -          "required": [
      -            "name",
      -            "provider",
      -            "purpose",
      -            "visits",
      -            "verified",
      -            "pages"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "latest_visit_at": {
      -        "type": "string"
      -      },
      -      "pages_reached": {
      -        "description": "Distinct pages an AI crawler or AI referral reached.",
      -        "type": "integer"
      -      },
      -      "pages_to_improve": {
      -        "description": "Pages AI crawlers read but people rarely reach from AI answers.",
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "ai_referrals": {
      -              "type": "integer"
      -            },
      -            "ai_visits": {
      -              "type": "integer"
      -            },
      -            "change": {
      -              "description": "Change in the AI share of the page's visits on the previous period, in percentage points; null when new.",
      -              "type": [
      -                "null",
      -                "number"
      -              ]
      -            },
      -            "crawler_visits": {
      -              "type": "integer"
      -            },
      -            "path": {
      -              "type": "string"
      -            },
      -            "providers": {
      -              "items": {
      -                "type": "string"
      -              },
      -              "type": "array"
      -            },
      -            "total_visits": {
      -              "type": "integer"
      -            },
      -            "url": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "path",
      -            "url",
      -            "total_visits",
      -            "ai_visits",
      -            "crawler_visits",
      -            "ai_referrals",
      -            "providers",
      -            "change"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "period": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "from": {
      -            "description": "First day, YYYY-MM-DD.",
      -            "type": "string"
      -          },
      -          "to": {
      -            "description": "Last day, YYYY-MM-DD.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "from",
      -          "to"
      -        ],
      -        "type": "object"
      -      },
      -      "referral_sources": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "name": {
      -              "type": "string"
      -            },
      -            "pages": {
      -              "type": "integer"
      -            },
      -            "provider": {
      -              "type": "string"
      -            },
      -            "referrals": {
      -              "type": "integer"
      -            },
      -            "source": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "source",
      -            "name",
      -            "provider",
      -            "referrals",
      -            "pages"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "systems": {
      -        "description": "AI providers, by visits.",
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "ai_referrals": {
      -              "type": "integer"
      -            },
      -            "crawler_visits": {
      -              "type": "integer"
      -            },
      -            "pages": {
      -              "type": "integer"
      -            },
      -            "provider": {
      -              "description": "Pass as provider to filter.",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "provider",
      -            "crawler_visits",
      -            "ai_referrals",
      -            "pages"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "total_visits": {
      -        "type": "integer"
      -      },
      -      "view": {
      -        "type": "string"
      -      },
      -      "weekly": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "ai_referrals": {
      -              "type": "integer"
      -            },
      -            "crawler_visits": {
      -              "type": "integer"
      -            },
      -            "week_start": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "week_start",
      -            "crawler_visits",
      -            "ai_referrals"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      }
      -    },
      -    "required": [
      -      "brand",
      -      "view",
      -      "period",
      -      "connected",
      -      "total_visits",
      -      "ai_visits",
      -      "ai_share",
      -      "crawler_visits",
      -      "ai_referrals",
      -      "pages_reached",
      -      "latest_visit_at",
      -      "systems",
      -      "crawlers",
      -      "referral_sources",
      -      "pages_to_improve",
      -      "weekly"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "brand": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "id": {
      -            "type": "string"
      -          },
      -          "name": {
      -            "type": "string"
      -          },
      -          "url": {
      -            "description": "The brand's website, or empty when none is set.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "id",
      -          "name",
      -          "url"
      -        ],
      -        "type": "object"
      -      },
      -      "connected": {
      -        "type": "boolean"
      -      },
      -      "pages": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "ai_referrals": {
      -              "type": "integer"
      -            },
      -            "ai_visits": {
      -              "type": "integer"
      -            },
      -            "change": {
      -              "description": "Change in the AI share of the page's visits on the previous period, in percentage points; null when new.",
      -              "type": [
      -                "null",
      -                "number"
      -              ]
      -            },
      -            "crawler_visits": {
      -              "type": "integer"
      -            },
      -            "path": {
      -              "type": "string"
      -            },
      -            "providers": {
      -              "items": {
      -                "type": "string"
      -              },
      -              "type": "array"
      -            },
      -            "total_visits": {
      -              "type": "integer"
      -            },
      -            "url": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "path",
      -            "url",
      -            "total_visits",
      -            "ai_visits",
      -            "crawler_visits",
      -            "ai_referrals",
      -            "providers",
      -            "change"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "pagination": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "next_cursor": {
      -            "description": "Pass as cursor to get the next page; empty on the last page.",
      -            "type": "string"
      -          },
      -          "total": {
      -            "description": "Items across all pages; null when not counted.",
      -            "type": [
      -              "null",
      -              "integer"
      -            ]
      -          }
      -        },
      -        "required": [
      -          "next_cursor",
      -          "total"
      -        ],
      -        "type": "object"
      -      },
      -      "period": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "from": {
      -            "description": "First day, YYYY-MM-DD.",
      -            "type": "string"
      -          },
      -          "to": {
      -            "description": "Last day, YYYY-MM-DD.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "from",
      -          "to"
      -        ],
      -        "type": "object"
      -      },
      -      "view": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "brand",
      -      "view",
      -      "period",
      -      "connected",
      -      "pages",
      -      "pagination"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "brand": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "id": {
      -            "type": "string"
      -          },
      -          "name": {
      -            "type": "string"
      -          },
      -          "url": {
      -            "description": "The brand's website, or empty when none is set.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "id",
      -          "name",
      -          "url"
      -        ],
      -        "type": "object"
      -      },
      -      "connected": {
      -        "type": "boolean"
      -      },
      -      "pagination": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "next_cursor": {
      -            "description": "Pass as cursor to get the next page; empty on the last page.",
      -            "type": "string"
      -          },
      -          "total": {
      -            "description": "Items across all pages; null when not counted.",
      -            "type": [
      -              "null",
      -              "integer"
      -            ]
      -          }
      -        },
      -        "required": [
      -          "next_cursor",
      -          "total"
      -        ],
      -        "type": "object"
      -      },
      -      "period": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "from": {
      -            "description": "First day, YYYY-MM-DD.",
      -            "type": "string"
      -          },
      -          "to": {
      -            "description": "Last day, YYYY-MM-DD.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "from",
      -          "to"
      -        ],
      -        "type": "object"
      -      },
      -      "view": {
      -        "type": "string"
      -      },
      -      "visits": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "captured_at": {
      -              "type": "string"
      -            },
      -            "name": {
      -              "description": "The crawler or referring AI product.",
      -              "type": "string"
      -            },
      -            "path": {
      -              "type": "string"
      -            },
      -            "provider": {
      -              "type": "string"
      -            },
      -            "type": {
      -              "description": "crawler or referral.",
      -              "type": "string"
      -            },
      -            "url": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "type",
      -            "path",
      -            "url",
      -            "provider",
      -            "name",
      -            "captured_at"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      }
      -    },
      -    "required": [
      -      "brand",
      -      "view",
      -      "period",
      -      "connected",
      -      "visits",
      -      "pagination"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "ai_referrals": {
      +        "type": "integer"
      +      },
      +      "ai_share": {
      +        "description": "AI-referred visits as a percentage of human visits.",
      +        "type": "number"
      +      },
      +      "ai_visits": {
      +        "description": "Human visits that arrived from an AI assistant.",
      +        "type": "integer"
      +      },
      +      "brand": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "id": {
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "The brand's website, or empty when none is set.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "id",
      +          "name",
      +          "url"
      +        ],
      +        "type": "object"
      +      },
      +      "connected": {
      +        "description": "Whether site tracking is set up; when false nothing is measured.",
      +        "type": "boolean"
      +      },
      +      "crawler_visits": {
      +        "description": "AI crawler requests. These are not visits and are not part of ai_share.",
      +        "type": "integer"
      +      },
      +      "crawlers": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "name": {
      +              "type": "string"
      +            },
      +            "pages": {
      +              "type": "integer"
      +            },
      +            "provider": {
      +              "type": "string"
      +            },
      +            "purpose": {
      +              "description": "Why the crawler fetched pages: ai_user (for a live user question), ai_search (to build an AI search index) or ai_training (to collect model training data).",
      +              "type": "string"
      +            },
      +            "verified": {
      +              "description": "Visits whose IP address is in the operator's published crawler IP list.",
      +              "type": "integer"
      +            },
      +            "visits": {
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "name",
      +            "provider",
      +            "purpose",
      +            "visits",
      +            "verified",
      +            "pages"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "latest_visit_at": {
      +        "type": "string"
      +      },
      +      "pages_reached": {
      +        "description": "Distinct pages an AI crawler or AI referral reached.",
      +        "type": "integer"
      +      },
      +      "pages_to_improve": {
      +        "description": "Pages AI crawlers read but people rarely reach from AI answers.",
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "ai_referrals": {
      +              "type": "integer"
      +            },
      +            "ai_visits": {
      +              "description": "Human visits to the page that arrived from an AI assistant.",
      +              "type": "integer"
      +            },
      +            "change": {
      +              "description": "Change in the page's AI share (AI-referred visits as a percentage of human visits) on the previous period, in percentage points; null when the page had no human visits before.",
      +              "type": [
      +                "null",
      +                "number"
      +              ]
      +            },
      +            "crawler_visits": {
      +              "type": "integer"
      +            },
      +            "path": {
      +              "type": "string"
      +            },
      +            "providers": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "total_visits": {
      +              "description": "Human visits to the page.",
      +              "type": "integer"
      +            },
      +            "url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "path",
      +            "url",
      +            "total_visits",
      +            "ai_visits",
      +            "crawler_visits",
      +            "ai_referrals",
      +            "providers",
      +            "change"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "period": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "from": {
      +            "description": "First day, YYYY-MM-DD.",
      +            "type": "string"
      +          },
      +          "to": {
      +            "description": "Last day, YYYY-MM-DD.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "from",
      +          "to"
      +        ],
      +        "type": "object"
      +      },
      +      "referral_sources": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "name": {
      +              "type": "string"
      +            },
      +            "pages": {
      +              "type": "integer"
      +            },
      +            "provider": {
      +              "type": "string"
      +            },
      +            "referrals": {
      +              "type": "integer"
      +            },
      +            "source": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "source",
      +            "name",
      +            "provider",
      +            "referrals",
      +            "pages"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "systems": {
      +        "description": "AI providers, by visits.",
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "ai_referrals": {
      +              "type": "integer"
      +            },
      +            "crawler_visits": {
      +              "type": "integer"
      +            },
      +            "pages": {
      +              "type": "integer"
      +            },
      +            "provider": {
      +              "description": "Pass as provider to filter.",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "provider",
      +            "crawler_visits",
      +            "ai_referrals",
      +            "pages"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "total_visits": {
      +        "description": "Human page visits. Bots, crawlers and Cleotic's own fetches are not counted.",
      +        "type": "integer"
      +      },
      +      "view": {
      +        "type": "string"
      +      },
      +      "weekly": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "ai_referrals": {
      +              "type": "integer"
      +            },
      +            "crawler_visits": {
      +              "type": "integer"
      +            },
      +            "week_start": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "week_start",
      +            "crawler_visits",
      +            "ai_referrals"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "brand",
      +      "view",
      +      "period",
      +      "connected",
      +      "total_visits",
      +      "ai_visits",
      +      "ai_share",
      +      "crawler_visits",
      +      "ai_referrals",
      +      "pages_reached",
      +      "latest_visit_at",
      +      "systems",
      +      "crawlers",
      +      "referral_sources",
      +      "pages_to_improve",
      +      "weekly"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "brand": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "id": {
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "The brand's website, or empty when none is set.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "id",
      +          "name",
      +          "url"
      +        ],
      +        "type": "object"
      +      },
      +      "connected": {
      +        "type": "boolean"
      +      },
      +      "pages": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "ai_referrals": {
      +              "type": "integer"
      +            },
      +            "ai_visits": {
      +              "description": "Human visits to the page that arrived from an AI assistant.",
      +              "type": "integer"
      +            },
      +            "change": {
      +              "description": "Change in the page's AI share (AI-referred visits as a percentage of human visits) on the previous period, in percentage points; null when the page had no human visits before.",
      +              "type": [
      +                "null",
      +                "number"
      +              ]
      +            },
      +            "crawler_visits": {
      +              "type": "integer"
      +            },
      +            "path": {
      +              "type": "string"
      +            },
      +            "providers": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "total_visits": {
      +              "description": "Human visits to the page.",
      +              "type": "integer"
      +            },
      +            "url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "path",
      +            "url",
      +            "total_visits",
      +            "ai_visits",
      +            "crawler_visits",
      +            "ai_referrals",
      +            "providers",
      +            "change"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "pagination": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "next_cursor": {
      +            "description": "Pass as cursor to get the next page; empty on the last page.",
      +            "type": "string"
      +          },
      +          "total": {
      +            "description": "Items across all pages; null when not counted.",
      +            "type": [
      +              "null",
      +              "integer"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "next_cursor",
      +          "total"
      +        ],
      +        "type": "object"
      +      },
      +      "period": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "from": {
      +            "description": "First day, YYYY-MM-DD.",
      +            "type": "string"
      +          },
      +          "to": {
      +            "description": "Last day, YYYY-MM-DD.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "from",
      +          "to"
      +        ],
      +        "type": "object"
      +      },
      +      "view": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "brand",
      +      "view",
      +      "period",
      +      "connected",
      +      "pages",
      +      "pagination"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "brand": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "id": {
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "The brand's website, or empty when none is set.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "id",
      +          "name",
      +          "url"
      +        ],
      +        "type": "object"
      +      },
      +      "connected": {
      +        "type": "boolean"
      +      },
      +      "pagination": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "next_cursor": {
      +            "description": "Pass as cursor to get the next page; empty on the last page.",
      +            "type": "string"
      +          },
      +          "total": {
      +            "description": "Items across all pages; null when not counted.",
      +            "type": [
      +              "null",
      +              "integer"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "next_cursor",
      +          "total"
      +        ],
      +        "type": "object"
      +      },
      +      "period": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "from": {
      +            "description": "First day, YYYY-MM-DD.",
      +            "type": "string"
      +          },
      +          "to": {
      +            "description": "Last day, YYYY-MM-DD.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "from",
      +          "to"
      +        ],
      +        "type": "object"
      +      },
      +      "view": {
      +        "type": "string"
      +      },
      +      "visits": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "captured_at": {
      +              "type": "string"
      +            },
      +            "name": {
      +              "description": "The crawler or referring AI product.",
      +              "type": "string"
      +            },
      +            "path": {
      +              "type": "string"
      +            },
      +            "provider": {
      +              "type": "string"
      +            },
      +            "type": {
      +              "description": "crawler or referral.",
      +              "type": "string"
      +            },
      +            "url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "type",
      +            "path",
      +            "url",
      +            "provider",
      +            "name",
      +            "captured_at"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "brand",
      +      "view",
      +      "period",
      +      "connected",
      +      "visits",
      +      "pagination"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. Changed1 schema field changed
    • addedInput schema / properties / traffic_view
      Added value: +{
      +  "description": "Optional filter set: a built-in view (pages, discovery, previews, errors, spoofed, everything) or a saved view ID. Defaults to pages: loaded pages from verified or unverifiable bots and AI referrals.",
      +  "type": "string"
      +}
  4. Changed1 schema field changed
    • changedOutput schema / properties / data / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "ai_referrals": {
      -        "type": "integer"
      -      },
      -      "ai_share": {
      -        "description": "AI visits as a percentage of all visits.",
      -        "type": "number"
      -      },
      -      "ai_visits": {
      -        "type": "integer"
      -      },
      -      "brand": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "id": {
      -            "type": "string"
      -          },
      -          "name": {
      -            "type": "string"
      -          },
      -          "url": {
      -            "description": "The brand's website, or empty when none is set.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "id",
      -          "name",
      -          "url"
      -        ],
      -        "type": "object"
      -      },
      -      "connected": {
      -        "description": "Whether site tracking is set up; when false nothing is measured.",
      -        "type": "boolean"
      -      },
      -      "crawler_visits": {
      -        "type": "integer"
      -      },
      -      "crawlers": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "name": {
      -              "type": "string"
      -            },
      -            "pages": {
      -              "type": "integer"
      -            },
      -            "provider": {
      -              "type": "string"
      -            },
      -            "visits": {
      -              "type": "integer"
      -            }
      -          },
      -          "required": [
      -            "name",
      -            "provider",
      -            "visits",
      -            "pages"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "latest_visit_at": {
      -        "type": "string"
      -      },
      -      "pages_reached": {
      -        "description": "Distinct pages an AI crawler or AI referral reached.",
      -        "type": "integer"
      -      },
      -      "pages_to_improve": {
      -        "description": "Pages AI crawlers read but people rarely reach from AI answers.",
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "ai_referrals": {
      -              "type": "integer"
      -            },
      -            "ai_visits": {
      -              "type": "integer"
      -            },
      -            "change": {
      -              "description": "Change in the AI share of the page's visits on the previous period, in percentage points; null when new.",
      -              "type": [
      -                "null",
      -                "number"
      -              ]
      -            },
      -            "crawler_visits": {
      -              "type": "integer"
      -            },
      -            "path": {
      -              "type": "string"
      -            },
      -            "providers": {
      -              "items": {
      -                "type": "string"
      -              },
      -              "type": "array"
      -            },
      -            "total_visits": {
      -              "type": "integer"
      -            },
      -            "url": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "path",
      -            "url",
      -            "total_visits",
      -            "ai_visits",
      -            "crawler_visits",
      -            "ai_referrals",
      -            "providers",
      -            "change"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "period": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "from": {
      -            "description": "First day, YYYY-MM-DD.",
      -            "type": "string"
      -          },
      -          "to": {
      -            "description": "Last day, YYYY-MM-DD.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "from",
      -          "to"
      -        ],
      -        "type": "object"
      -      },
      -      "referral_sources": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "name": {
      -              "type": "string"
      -            },
      -            "pages": {
      -              "type": "integer"
      -            },
      -            "provider": {
      -              "type": "string"
      -            },
      -            "referrals": {
      -              "type": "integer"
      -            },
      -            "source": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "source",
      -            "name",
      -            "provider",
      -            "referrals",
      -            "pages"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "systems": {
      -        "description": "AI providers, by visits.",
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "ai_referrals": {
      -              "type": "integer"
      -            },
      -            "crawler_visits": {
      -              "type": "integer"
      -            },
      -            "pages": {
      -              "type": "integer"
      -            },
      -            "provider": {
      -              "description": "Pass as provider to filter.",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "provider",
      -            "crawler_visits",
      -            "ai_referrals",
      -            "pages"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "total_visits": {
      -        "type": "integer"
      -      },
      -      "view": {
      -        "type": "string"
      -      },
      -      "weekly": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "ai_referrals": {
      -              "type": "integer"
      -            },
      -            "crawler_visits": {
      -              "type": "integer"
      -            },
      -            "week_start": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "week_start",
      -            "crawler_visits",
      -            "ai_referrals"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      }
      -    },
      -    "required": [
      -      "brand",
      -      "view",
      -      "period",
      -      "connected",
      -      "total_visits",
      -      "ai_visits",
      -      "ai_share",
      -      "crawler_visits",
      -      "ai_referrals",
      -      "pages_reached",
      -      "latest_visit_at",
      -      "systems",
      -      "crawlers",
      -      "referral_sources",
      -      "pages_to_improve",
      -      "weekly"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "brand": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "id": {
      -            "type": "string"
      -          },
      -          "name": {
      -            "type": "string"
      -          },
      -          "url": {
      -            "description": "The brand's website, or empty when none is set.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "id",
      -          "name",
      -          "url"
      -        ],
      -        "type": "object"
      -      },
      -      "connected": {
      -        "type": "boolean"
      -      },
      -      "pages": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "ai_referrals": {
      -              "type": "integer"
      -            },
      -            "ai_visits": {
      -              "type": "integer"
      -            },
      -            "change": {
      -              "description": "Change in the AI share of the page's visits on the previous period, in percentage points; null when new.",
      -              "type": [
      -                "null",
      -                "number"
      -              ]
      -            },
      -            "crawler_visits": {
      -              "type": "integer"
      -            },
      -            "path": {
      -              "type": "string"
      -            },
      -            "providers": {
      -              "items": {
      -                "type": "string"
      -              },
      -              "type": "array"
      -            },
      -            "total_visits": {
      -              "type": "integer"
      -            },
      -            "url": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "path",
      -            "url",
      -            "total_visits",
      -            "ai_visits",
      -            "crawler_visits",
      -            "ai_referrals",
      -            "providers",
      -            "change"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "pagination": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "next_cursor": {
      -            "description": "Pass as cursor to get the next page; empty on the last page.",
      -            "type": "string"
      -          },
      -          "total": {
      -            "description": "Items across all pages; null when not counted.",
      -            "type": [
      -              "null",
      -              "integer"
      -            ]
      -          }
      -        },
      -        "required": [
      -          "next_cursor",
      -          "total"
      -        ],
      -        "type": "object"
      -      },
      -      "period": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "from": {
      -            "description": "First day, YYYY-MM-DD.",
      -            "type": "string"
      -          },
      -          "to": {
      -            "description": "Last day, YYYY-MM-DD.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "from",
      -          "to"
      -        ],
      -        "type": "object"
      -      },
      -      "view": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "brand",
      -      "view",
      -      "period",
      -      "connected",
      -      "pages",
      -      "pagination"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "brand": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "id": {
      -            "type": "string"
      -          },
      -          "name": {
      -            "type": "string"
      -          },
      -          "url": {
      -            "description": "The brand's website, or empty when none is set.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "id",
      -          "name",
      -          "url"
      -        ],
      -        "type": "object"
      -      },
      -      "connected": {
      -        "type": "boolean"
      -      },
      -      "pagination": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "next_cursor": {
      -            "description": "Pass as cursor to get the next page; empty on the last page.",
      -            "type": "string"
      -          },
      -          "total": {
      -            "description": "Items across all pages; null when not counted.",
      -            "type": [
      -              "null",
      -              "integer"
      -            ]
      -          }
      -        },
      -        "required": [
      -          "next_cursor",
      -          "total"
      -        ],
      -        "type": "object"
      -      },
      -      "period": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "from": {
      -            "description": "First day, YYYY-MM-DD.",
      -            "type": "string"
      -          },
      -          "to": {
      -            "description": "Last day, YYYY-MM-DD.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "from",
      -          "to"
      -        ],
      -        "type": "object"
      -      },
      -      "view": {
      -        "type": "string"
      -      },
      -      "visits": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "captured_at": {
      -              "type": "string"
      -            },
      -            "name": {
      -              "description": "The crawler or referring AI product.",
      -              "type": "string"
      -            },
      -            "path": {
      -              "type": "string"
      -            },
      -            "provider": {
      -              "type": "string"
      -            },
      -            "type": {
      -              "description": "crawler or referral.",
      -              "type": "string"
      -            },
      -            "url": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "type",
      -            "path",
      -            "url",
      -            "provider",
      -            "name",
      -            "captured_at"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      }
      -    },
      -    "required": [
      -      "brand",
      -      "view",
      -      "period",
      -      "connected",
      -      "visits",
      -      "pagination"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "ai_referrals": {
      +        "type": "integer"
      +      },
      +      "ai_share": {
      +        "description": "AI visits as a percentage of all visits.",
      +        "type": "number"
      +      },
      +      "ai_visits": {
      +        "type": "integer"
      +      },
      +      "brand": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "id": {
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "The brand's website, or empty when none is set.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "id",
      +          "name",
      +          "url"
      +        ],
      +        "type": "object"
      +      },
      +      "connected": {
      +        "description": "Whether site tracking is set up; when false nothing is measured.",
      +        "type": "boolean"
      +      },
      +      "crawler_visits": {
      +        "type": "integer"
      +      },
      +      "crawlers": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "name": {
      +              "type": "string"
      +            },
      +            "pages": {
      +              "type": "integer"
      +            },
      +            "provider": {
      +              "type": "string"
      +            },
      +            "purpose": {
      +              "description": "Why the crawler fetched pages: ai_user (for a live user question), ai_search (to build an AI search index) or ai_training (to collect model training data).",
      +              "type": "string"
      +            },
      +            "verified": {
      +              "description": "Visits whose IP address is in the operator's published crawler IP list.",
      +              "type": "integer"
      +            },
      +            "visits": {
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "name",
      +            "provider",
      +            "purpose",
      +            "visits",
      +            "verified",
      +            "pages"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "latest_visit_at": {
      +        "type": "string"
      +      },
      +      "pages_reached": {
      +        "description": "Distinct pages an AI crawler or AI referral reached.",
      +        "type": "integer"
      +      },
      +      "pages_to_improve": {
      +        "description": "Pages AI crawlers read but people rarely reach from AI answers.",
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "ai_referrals": {
      +              "type": "integer"
      +            },
      +            "ai_visits": {
      +              "type": "integer"
      +            },
      +            "change": {
      +              "description": "Change in the AI share of the page's visits on the previous period, in percentage points; null when new.",
      +              "type": [
      +                "null",
      +                "number"
      +              ]
      +            },
      +            "crawler_visits": {
      +              "type": "integer"
      +            },
      +            "path": {
      +              "type": "string"
      +            },
      +            "providers": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "total_visits": {
      +              "type": "integer"
      +            },
      +            "url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "path",
      +            "url",
      +            "total_visits",
      +            "ai_visits",
      +            "crawler_visits",
      +            "ai_referrals",
      +            "providers",
      +            "change"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "period": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "from": {
      +            "description": "First day, YYYY-MM-DD.",
      +            "type": "string"
      +          },
      +          "to": {
      +            "description": "Last day, YYYY-MM-DD.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "from",
      +          "to"
      +        ],
      +        "type": "object"
      +      },
      +      "referral_sources": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "name": {
      +              "type": "string"
      +            },
      +            "pages": {
      +              "type": "integer"
      +            },
      +            "provider": {
      +              "type": "string"
      +            },
      +            "referrals": {
      +              "type": "integer"
      +            },
      +            "source": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "source",
      +            "name",
      +            "provider",
      +            "referrals",
      +            "pages"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "systems": {
      +        "description": "AI providers, by visits.",
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "ai_referrals": {
      +              "type": "integer"
      +            },
      +            "crawler_visits": {
      +              "type": "integer"
      +            },
      +            "pages": {
      +              "type": "integer"
      +            },
      +            "provider": {
      +              "description": "Pass as provider to filter.",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "provider",
      +            "crawler_visits",
      +            "ai_referrals",
      +            "pages"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "total_visits": {
      +        "type": "integer"
      +      },
      +      "view": {
      +        "type": "string"
      +      },
      +      "weekly": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "ai_referrals": {
      +              "type": "integer"
      +            },
      +            "crawler_visits": {
      +              "type": "integer"
      +            },
      +            "week_start": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "week_start",
      +            "crawler_visits",
      +            "ai_referrals"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "brand",
      +      "view",
      +      "period",
      +      "connected",
      +      "total_visits",
      +      "ai_visits",
      +      "ai_share",
      +      "crawler_visits",
      +      "ai_referrals",
      +      "pages_reached",
      +      "latest_visit_at",
      +      "systems",
      +      "crawlers",
      +      "referral_sources",
      +      "pages_to_improve",
      +      "weekly"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "brand": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "id": {
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "The brand's website, or empty when none is set.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "id",
      +          "name",
      +          "url"
      +        ],
      +        "type": "object"
      +      },
      +      "connected": {
      +        "type": "boolean"
      +      },
      +      "pages": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "ai_referrals": {
      +              "type": "integer"
      +            },
      +            "ai_visits": {
      +              "type": "integer"
      +            },
      +            "change": {
      +              "description": "Change in the AI share of the page's visits on the previous period, in percentage points; null when new.",
      +              "type": [
      +                "null",
      +                "number"
      +              ]
      +            },
      +            "crawler_visits": {
      +              "type": "integer"
      +            },
      +            "path": {
      +              "type": "string"
      +            },
      +            "providers": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "total_visits": {
      +              "type": "integer"
      +            },
      +            "url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "path",
      +            "url",
      +            "total_visits",
      +            "ai_visits",
      +            "crawler_visits",
      +            "ai_referrals",
      +            "providers",
      +            "change"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "pagination": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "next_cursor": {
      +            "description": "Pass as cursor to get the next page; empty on the last page.",
      +            "type": "string"
      +          },
      +          "total": {
      +            "description": "Items across all pages; null when not counted.",
      +            "type": [
      +              "null",
      +              "integer"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "next_cursor",
      +          "total"
      +        ],
      +        "type": "object"
      +      },
      +      "period": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "from": {
      +            "description": "First day, YYYY-MM-DD.",
      +            "type": "string"
      +          },
      +          "to": {
      +            "description": "Last day, YYYY-MM-DD.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "from",
      +          "to"
      +        ],
      +        "type": "object"
      +      },
      +      "view": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "brand",
      +      "view",
      +      "period",
      +      "connected",
      +      "pages",
      +      "pagination"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "brand": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "id": {
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "The brand's website, or empty when none is set.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "id",
      +          "name",
      +          "url"
      +        ],
      +        "type": "object"
      +      },
      +      "connected": {
      +        "type": "boolean"
      +      },
      +      "pagination": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "next_cursor": {
      +            "description": "Pass as cursor to get the next page; empty on the last page.",
      +            "type": "string"
      +          },
      +          "total": {
      +            "description": "Items across all pages; null when not counted.",
      +            "type": [
      +              "null",
      +              "integer"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "next_cursor",
      +          "total"
      +        ],
      +        "type": "object"
      +      },
      +      "period": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "from": {
      +            "description": "First day, YYYY-MM-DD.",
      +            "type": "string"
      +          },
      +          "to": {
      +            "description": "Last day, YYYY-MM-DD.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "from",
      +          "to"
      +        ],
      +        "type": "object"
      +      },
      +      "view": {
      +        "type": "string"
      +      },
      +      "visits": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "captured_at": {
      +              "type": "string"
      +            },
      +            "name": {
      +              "description": "The crawler or referring AI product.",
      +              "type": "string"
      +            },
      +            "path": {
      +              "type": "string"
      +            },
      +            "provider": {
      +              "type": "string"
      +            },
      +            "type": {
      +              "description": "crawler or referral.",
      +              "type": "string"
      +            },
      +            "url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "type",
      +            "path",
      +            "url",
      +            "provider",
      +            "name",
      +            "captured_at"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "brand",
      +      "view",
      +      "period",
      +      "connected",
      +      "visits",
      +      "pagination"
      +    ],
      +    "type": "object"
      +  }
      +]
  5. Changed4 schema fields changed
    • changedInput schema / properties / from / description
      Previous value: -"Start date, YYYY-MM-DD. Defaults to 30 days before to; plan retention may shorten it."New value: +"Start date, YYYY-MM-DD. Defaults to 30 days before to. Windows are at most 180 days and a from after today is refused; a plan with limited history serves only the days it keeps and says so in retention."
    • changedInput schema / properties / provider / description
      Previous value: -"Optional AI provider, as the summary's systems name it, for example OpenAI."New value: +"Optional AI provider, as the summary's systems name it, for example OpenAI; capitalisation does not matter. A provider with no traffic in the period is refused as unknown."
    • changedInput schema / properties / to / description
      Previous value: -"End date, YYYY-MM-DD. Defaults to today."New value: +"End date, YYYY-MM-DD, inclusive; from equal to to is a single day. Defaults to today; a later date is treated as today."
    • changedOutput schema / properties / data / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "ai_referrals": {
      -        "type": "integer"
      -      },
      -      "ai_share": {
      -        "description": "AI visits as a percentage of all visits.",
      -        "type": "number"
      -      },
      -      "ai_visits": {
      -        "type": "integer"
      -      },
      -      "brand": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "id": {
      -            "type": "string"
      -          },
      -          "name": {
      -            "type": "string"
      -          },
      -          "url": {
      -            "description": "The brand's website, or empty when none is set.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "id",
      -          "name",
      -          "url"
      -        ],
      -        "type": "object"
      -      },
      -      "connected": {
      -        "description": "Whether site tracking is set up; when false nothing is measured.",
      -        "type": "boolean"
      -      },
      -      "crawler_visits": {
      -        "type": "integer"
      -      },
      -      "crawlers": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "name": {
      -              "type": "string"
      -            },
      -            "pages": {
      -              "type": "integer"
      -            },
      -            "provider": {
      -              "type": "string"
      -            },
      -            "visits": {
      -              "type": "integer"
      -            }
      -          },
      -          "required": [
      -            "name",
      -            "provider",
      -            "visits",
      -            "pages"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "latest_visit_at": {
      -        "type": "string"
      -      },
      -      "pages_reached": {
      -        "type": "integer"
      -      },
      -      "pages_to_improve": {
      -        "description": "Pages AI crawlers read but people rarely reach from AI answers.",
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "ai_referrals": {
      -              "type": "integer"
      -            },
      -            "ai_visits": {
      -              "type": "integer"
      -            },
      -            "change": {
      -              "description": "Change in the AI share of the page's visits on the previous period, in percentage points; null when new.",
      -              "type": [
      -                "null",
      -                "number"
      -              ]
      -            },
      -            "crawler_visits": {
      -              "type": "integer"
      -            },
      -            "path": {
      -              "type": "string"
      -            },
      -            "providers": {
      -              "items": {
      -                "type": "string"
      -              },
      -              "type": "array"
      -            },
      -            "total_visits": {
      -              "type": "integer"
      -            },
      -            "url": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "path",
      -            "url",
      -            "total_visits",
      -            "ai_visits",
      -            "crawler_visits",
      -            "ai_referrals",
      -            "providers",
      -            "change"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "period": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "from": {
      -            "description": "First day, YYYY-MM-DD.",
      -            "type": "string"
      -          },
      -          "to": {
      -            "description": "Last day, YYYY-MM-DD.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "from",
      -          "to"
      -        ],
      -        "type": "object"
      -      },
      -      "referral_sources": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "name": {
      -              "type": "string"
      -            },
      -            "pages": {
      -              "type": "integer"
      -            },
      -            "provider": {
      -              "type": "string"
      -            },
      -            "referrals": {
      -              "type": "integer"
      -            },
      -            "source": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "source",
      -            "name",
      -            "provider",
      -            "referrals",
      -            "pages"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "systems": {
      -        "description": "AI providers, by visits.",
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "ai_referrals": {
      -              "type": "integer"
      -            },
      -            "crawler_visits": {
      -              "type": "integer"
      -            },
      -            "pages": {
      -              "type": "integer"
      -            },
      -            "provider": {
      -              "description": "Pass as provider to filter.",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "provider",
      -            "crawler_visits",
      -            "ai_referrals",
      -            "pages"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "total_visits": {
      -        "type": "integer"
      -      },
      -      "view": {
      -        "type": "string"
      -      },
      -      "weekly": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "ai_referrals": {
      -              "type": "integer"
      -            },
      -            "crawler_visits": {
      -              "type": "integer"
      -            },
      -            "week_start": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "week_start",
      -            "crawler_visits",
      -            "ai_referrals"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      }
      -    },
      -    "required": [
      -      "brand",
      -      "view",
      -      "period",
      -      "connected",
      -      "total_visits",
      -      "ai_visits",
      -      "ai_share",
      -      "crawler_visits",
      -      "ai_referrals",
      -      "pages_reached",
      -      "latest_visit_at",
      -      "systems",
      -      "crawlers",
      -      "referral_sources",
      -      "pages_to_improve",
      -      "weekly"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "brand": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "id": {
      -            "type": "string"
      -          },
      -          "name": {
      -            "type": "string"
      -          },
      -          "url": {
      -            "description": "The brand's website, or empty when none is set.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "id",
      -          "name",
      -          "url"
      -        ],
      -        "type": "object"
      -      },
      -      "connected": {
      -        "type": "boolean"
      -      },
      -      "pages": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "ai_referrals": {
      -              "type": "integer"
      -            },
      -            "ai_visits": {
      -              "type": "integer"
      -            },
      -            "change": {
      -              "description": "Change in the AI share of the page's visits on the previous period, in percentage points; null when new.",
      -              "type": [
      -                "null",
      -                "number"
      -              ]
      -            },
      -            "crawler_visits": {
      -              "type": "integer"
      -            },
      -            "path": {
      -              "type": "string"
      -            },
      -            "providers": {
      -              "items": {
      -                "type": "string"
      -              },
      -              "type": "array"
      -            },
      -            "total_visits": {
      -              "type": "integer"
      -            },
      -            "url": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "path",
      -            "url",
      -            "total_visits",
      -            "ai_visits",
      -            "crawler_visits",
      -            "ai_referrals",
      -            "providers",
      -            "change"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "pagination": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "next_cursor": {
      -            "description": "Pass as cursor to get the next page; empty on the last page.",
      -            "type": "string"
      -          },
      -          "total": {
      -            "description": "Items across all pages; null when not counted.",
      -            "type": [
      -              "null",
      -              "integer"
      -            ]
      -          }
      -        },
      -        "required": [
      -          "next_cursor",
      -          "total"
      -        ],
      -        "type": "object"
      -      },
      -      "period": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "from": {
      -            "description": "First day, YYYY-MM-DD.",
      -            "type": "string"
      -          },
      -          "to": {
      -            "description": "Last day, YYYY-MM-DD.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "from",
      -          "to"
      -        ],
      -        "type": "object"
      -      },
      -      "view": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "brand",
      -      "view",
      -      "period",
      -      "connected",
      -      "pages",
      -      "pagination"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "brand": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "id": {
      -            "type": "string"
      -          },
      -          "name": {
      -            "type": "string"
      -          },
      -          "url": {
      -            "description": "The brand's website, or empty when none is set.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "id",
      -          "name",
      -          "url"
      -        ],
      -        "type": "object"
      -      },
      -      "connected": {
      -        "type": "boolean"
      -      },
      -      "pagination": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "next_cursor": {
      -            "description": "Pass as cursor to get the next page; empty on the last page.",
      -            "type": "string"
      -          },
      -          "total": {
      -            "description": "Items across all pages; null when not counted.",
      -            "type": [
      -              "null",
      -              "integer"
      -            ]
      -          }
      -        },
      -        "required": [
      -          "next_cursor",
      -          "total"
      -        ],
      -        "type": "object"
      -      },
      -      "period": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "from": {
      -            "description": "First day, YYYY-MM-DD.",
      -            "type": "string"
      -          },
      -          "to": {
      -            "description": "Last day, YYYY-MM-DD.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "from",
      -          "to"
      -        ],
      -        "type": "object"
      -      },
      -      "view": {
      -        "type": "string"
      -      },
      -      "visits": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "captured_at": {
      -              "type": "string"
      -            },
      -            "name": {
      -              "description": "The crawler or referring AI product.",
      -              "type": "string"
      -            },
      -            "path": {
      -              "type": "string"
      -            },
      -            "provider": {
      -              "type": "string"
      -            },
      -            "type": {
      -              "description": "crawler or referral.",
      -              "type": "string"
      -            },
      -            "url": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "type",
      -            "path",
      -            "url",
      -            "provider",
      -            "name",
      -            "captured_at"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      }
      -    },
      -    "required": [
      -      "brand",
      -      "view",
      -      "period",
      -      "connected",
      -      "visits",
      -      "pagination"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "ai_referrals": {
      +        "type": "integer"
      +      },
      +      "ai_share": {
      +        "description": "AI visits as a percentage of all visits.",
      +        "type": "number"
      +      },
      +      "ai_visits": {
      +        "type": "integer"
      +      },
      +      "brand": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "id": {
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "The brand's website, or empty when none is set.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "id",
      +          "name",
      +          "url"
      +        ],
      +        "type": "object"
      +      },
      +      "connected": {
      +        "description": "Whether site tracking is set up; when false nothing is measured.",
      +        "type": "boolean"
      +      },
      +      "crawler_visits": {
      +        "type": "integer"
      +      },
      +      "crawlers": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "name": {
      +              "type": "string"
      +            },
      +            "pages": {
      +              "type": "integer"
      +            },
      +            "provider": {
      +              "type": "string"
      +            },
      +            "visits": {
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "name",
      +            "provider",
      +            "visits",
      +            "pages"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "latest_visit_at": {
      +        "type": "string"
      +      },
      +      "pages_reached": {
      +        "description": "Distinct pages an AI crawler or AI referral reached.",
      +        "type": "integer"
      +      },
      +      "pages_to_improve": {
      +        "description": "Pages AI crawlers read but people rarely reach from AI answers.",
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "ai_referrals": {
      +              "type": "integer"
      +            },
      +            "ai_visits": {
      +              "type": "integer"
      +            },
      +            "change": {
      +              "description": "Change in the AI share of the page's visits on the previous period, in percentage points; null when new.",
      +              "type": [
      +                "null",
      +                "number"
      +              ]
      +            },
      +            "crawler_visits": {
      +              "type": "integer"
      +            },
      +            "path": {
      +              "type": "string"
      +            },
      +            "providers": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "total_visits": {
      +              "type": "integer"
      +            },
      +            "url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "path",
      +            "url",
      +            "total_visits",
      +            "ai_visits",
      +            "crawler_visits",
      +            "ai_referrals",
      +            "providers",
      +            "change"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "period": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "from": {
      +            "description": "First day, YYYY-MM-DD.",
      +            "type": "string"
      +          },
      +          "to": {
      +            "description": "Last day, YYYY-MM-DD.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "from",
      +          "to"
      +        ],
      +        "type": "object"
      +      },
      +      "referral_sources": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "name": {
      +              "type": "string"
      +            },
      +            "pages": {
      +              "type": "integer"
      +            },
      +            "provider": {
      +              "type": "string"
      +            },
      +            "referrals": {
      +              "type": "integer"
      +            },
      +            "source": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "source",
      +            "name",
      +            "provider",
      +            "referrals",
      +            "pages"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "systems": {
      +        "description": "AI providers, by visits.",
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "ai_referrals": {
      +              "type": "integer"
      +            },
      +            "crawler_visits": {
      +              "type": "integer"
      +            },
      +            "pages": {
      +              "type": "integer"
      +            },
      +            "provider": {
      +              "description": "Pass as provider to filter.",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "provider",
      +            "crawler_visits",
      +            "ai_referrals",
      +            "pages"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "total_visits": {
      +        "type": "integer"
      +      },
      +      "view": {
      +        "type": "string"
      +      },
      +      "weekly": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "ai_referrals": {
      +              "type": "integer"
      +            },
      +            "crawler_visits": {
      +              "type": "integer"
      +            },
      +            "week_start": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "week_start",
      +            "crawler_visits",
      +            "ai_referrals"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "brand",
      +      "view",
      +      "period",
      +      "connected",
      +      "total_visits",
      +      "ai_visits",
      +      "ai_share",
      +      "crawler_visits",
      +      "ai_referrals",
      +      "pages_reached",
      +      "latest_visit_at",
      +      "systems",
      +      "crawlers",
      +      "referral_sources",
      +      "pages_to_improve",
      +      "weekly"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "brand": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "id": {
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "The brand's website, or empty when none is set.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "id",
      +          "name",
      +          "url"
      +        ],
      +        "type": "object"
      +      },
      +      "connected": {
      +        "type": "boolean"
      +      },
      +      "pages": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "ai_referrals": {
      +              "type": "integer"
      +            },
      +            "ai_visits": {
      +              "type": "integer"
      +            },
      +            "change": {
      +              "description": "Change in the AI share of the page's visits on the previous period, in percentage points; null when new.",
      +              "type": [
      +                "null",
      +                "number"
      +              ]
      +            },
      +            "crawler_visits": {
      +              "type": "integer"
      +            },
      +            "path": {
      +              "type": "string"
      +            },
      +            "providers": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "total_visits": {
      +              "type": "integer"
      +            },
      +            "url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "path",
      +            "url",
      +            "total_visits",
      +            "ai_visits",
      +            "crawler_visits",
      +            "ai_referrals",
      +            "providers",
      +            "change"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "pagination": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "next_cursor": {
      +            "description": "Pass as cursor to get the next page; empty on the last page.",
      +            "type": "string"
      +          },
      +          "total": {
      +            "description": "Items across all pages; null when not counted.",
      +            "type": [
      +              "null",
      +              "integer"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "next_cursor",
      +          "total"
      +        ],
      +        "type": "object"
      +      },
      +      "period": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "from": {
      +            "description": "First day, YYYY-MM-DD.",
      +            "type": "string"
      +          },
      +          "to": {
      +            "description": "Last day, YYYY-MM-DD.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "from",
      +          "to"
      +        ],
      +        "type": "object"
      +      },
      +      "view": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "brand",
      +      "view",
      +      "period",
      +      "connected",
      +      "pages",
      +      "pagination"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "brand": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "id": {
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "The brand's website, or empty when none is set.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "id",
      +          "name",
      +          "url"
      +        ],
      +        "type": "object"
      +      },
      +      "connected": {
      +        "type": "boolean"
      +      },
      +      "pagination": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "next_cursor": {
      +            "description": "Pass as cursor to get the next page; empty on the last page.",
      +            "type": "string"
      +          },
      +          "total": {
      +            "description": "Items across all pages; null when not counted.",
      +            "type": [
      +              "null",
      +              "integer"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "next_cursor",
      +          "total"
      +        ],
      +        "type": "object"
      +      },
      +      "period": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "from": {
      +            "description": "First day, YYYY-MM-DD.",
      +            "type": "string"
      +          },
      +          "to": {
      +            "description": "Last day, YYYY-MM-DD.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "from",
      +          "to"
      +        ],
      +        "type": "object"
      +      },
      +      "view": {
      +        "type": "string"
      +      },
      +      "visits": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "captured_at": {
      +              "type": "string"
      +            },
      +            "name": {
      +              "description": "The crawler or referring AI product.",
      +              "type": "string"
      +            },
      +            "path": {
      +              "type": "string"
      +            },
      +            "provider": {
      +              "type": "string"
      +            },
      +            "type": {
      +              "description": "crawler or referral.",
      +              "type": "string"
      +            },
      +            "url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "type",
      +            "path",
      +            "url",
      +            "provider",
      +            "name",
      +            "captured_at"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "brand",
      +      "view",
      +      "period",
      +      "connected",
      +      "visits",
      +      "pagination"
      +    ],
      +    "type": "object"
      +  }
      +]
  6. Changed9 schema fields changed
    • addedInput schema / additionalProperties
      Added value: +false
    • addedInput schema / properties / brand / minLength
      Added value: +1
    • changedInput schema / properties / cursor / description
      Previous value: -"next_cursor from the previous page."New value: +"next_cursor from the previous page. Leave out for the first page."
    • addedInput schema / properties / from / format
      Added value: +"date"
    • changedInput schema / properties / limit / description
      Previous value: -"Rows per page. Defaults to 25, max 100."New value: +"Rows per page. Defaults to 25, max 100. A page may hold fewer rows to stay within the response size; follow next_cursor."
    • changedInput schema / properties / path / description
      Previous value: -"Optional page path filter."New value: +"Optional exact page path, for example /pricing."
    • changedInput schema / properties / provider / description
      Previous value: -"Optional AI provider filter."New value: +"Optional AI provider, as the summary's systems name it, for example OpenAI."
    • addedInput schema / properties / to / format
      Added value: +"date"
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "data": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": false,
      +          "properties": {
      +            "ai_referrals": {
      +              "type": "integer"
      +            },
      +            "ai_share": {
      +              "description": "AI visits as a percentage of all visits.",
      +              "type": "number"
      +            },
      +            "ai_visits": {
      +              "type": "integer"
      +            },
      +            "brand": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "id": {
      +                  "type": "string"
      +                },
      +                "name": {
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "description": "The brand's website, or empty when none is set.",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "id",
      +                "name",
      +                "url"
      +              ],
      +              "type": "object"
      +            },
      +            "connected": {
      +              "description": "Whether site tracking is set up; when false nothing is measured.",
      +              "type": "boolean"
      +            },
      +            "crawler_visits": {
      +              "type": "integer"
      +            },
      +            "crawlers": {
      +              "items": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "name": {
      +                    "type": "string"
      +                  },
      +                  "pages": {
      +                    "type": "integer"
      +                  },
      +                  "provider": {
      +                    "type": "string"
      +                  },
      +                  "visits": {
      +                    "type": "integer"
      +                  }
      +                },
      +                "required": [
      +                  "name",
      +                  "provider",
      +                  "visits",
      +                  "pages"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            "latest_visit_at": {
      +              "type": "string"
      +            },
      +            "pages_reached": {
      +              "type": "integer"
      +            },
      +            "pages_to_improve": {
      +              "description": "Pages AI crawlers read but people rarely reach from AI answers.",
      +              "items": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "ai_referrals": {
      +                    "type": "integer"
      +                  },
      +                  "ai_visits": {
      +                    "type": "integer"
      +                  },
      +                  "change": {
      +                    "description": "Change in the AI share of the page's visits on the previous period, in percentage points; null when new.",
      +                    "type": [
      +                      "null",
      +                      "number"
      +                    ]
      +                  },
      +                  "crawler_visits": {
      +                    "type": "integer"
      +                  },
      +                  "path": {
      +                    "type": "string"
      +                  },
      +                  "providers": {
      +                    "items": {
      +                      "type": "string"
      +                    },
      +                    "type": "array"
      +                  },
      +                  "total_visits": {
      +                    "type": "integer"
      +                  },
      +                  "url": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "path",
      +                  "url",
      +                  "total_visits",
      +                  "ai_visits",
      +                  "crawler_visits",
      +                  "ai_referrals",
      +                  "providers",
      +                  "change"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            "period": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "from": {
      +                  "description": "First day, YYYY-MM-DD.",
      +                  "type": "string"
      +                },
      +                "to": {
      +                  "description": "Last day, YYYY-MM-DD.",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "from",
      +                "to"
      +              ],
      +              "type": "object"
      +            },
      +            "referral_sources": {
      +              "items": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "name": {
      +                    "type": "string"
      +                  },
      +                  "pages": {
      +                    "type": "integer"
      +                  },
      +                  "provider": {
      +                    "type": "string"
      +                  },
      +                  "referrals": {
      +                    "type": "integer"
      +                  },
      +                  "source": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "source",
      +                  "name",
      +                  "provider",
      +                  "referrals",
      +                  "pages"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            "systems": {
      +              "description": "AI providers, by visits.",
      +              "items": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "ai_referrals": {
      +                    "type": "integer"
      +                  },
      +                  "crawler_visits": {
      +                    "type": "integer"
      +                  },
      +                  "pages": {
      +                    "type": "integer"
      +                  },
      +                  "provider": {
      +                    "description": "Pass as provider to filter.",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "provider",
      +                  "crawler_visits",
      +                  "ai_referrals",
      +                  "pages"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            "total_visits": {
      +              "type": "integer"
      +            },
      +            "view": {
      +              "type": "string"
      +            },
      +            "weekly": {
      +              "items": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "ai_referrals": {
      +                    "type": "integer"
      +                  },
      +                  "crawler_visits": {
      +                    "type": "integer"
      +                  },
      +                  "week_start": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "week_start",
      +                  "crawler_visits",
      +                  "ai_referrals"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            }
      +          },
      +          "required": [
      +            "brand",
      +            "view",
      +            "period",
      +            "connected",
      +            "total_visits",
      +            "ai_visits",
      +            "ai_share",
      +            "crawler_visits",
      +            "ai_referrals",
      +            "pages_reached",
      +            "latest_visit_at",
      +            "systems",
      +            "crawlers",
      +            "referral_sources",
      +            "pages_to_improve",
      +            "weekly"
      +          ],
      +          "type": "object"
      +        },
      +        {
      +          "additionalProperties": false,
      +          "properties": {
      +            "brand": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "id": {
      +                  "type": "string"
      +                },
      +                "name": {
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "description": "The brand's website, or empty when none is set.",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "id",
      +                "name",
      +                "url"
      +              ],
      +              "type": "object"
      +            },
      +            "connected": {
      +              "type": "boolean"
      +            },
      +            "pages": {
      +              "items": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "ai_referrals": {
      +                    "type": "integer"
      +                  },
      +                  "ai_visits": {
      +                    "type": "integer"
      +                  },
      +                  "change": {
      +                    "description": "Change in the AI share of the page's visits on the previous period, in percentage points; null when new.",
      +                    "type": [
      +                      "null",
      +                      "number"
      +                    ]
      +                  },
      +                  "crawler_visits": {
      +                    "type": "integer"
      +                  },
      +                  "path": {
      +                    "type": "string"
      +                  },
      +                  "providers": {
      +                    "items": {
      +                      "type": "string"
      +                    },
      +                    "type": "array"
      +                  },
      +                  "total_visits": {
      +                    "type": "integer"
      +                  },
      +                  "url": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "path",
      +                  "url",
      +                  "total_visits",
      +                  "ai_visits",
      +                  "crawler_visits",
      +                  "ai_referrals",
      +                  "providers",
      +                  "change"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            "pagination": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "next_cursor": {
      +                  "description": "Pass as cursor to get the next page; empty on the last page.",
      +                  "type": "string"
      +                },
      +                "total": {
      +                  "description": "Items across all pages; null when not counted.",
      +                  "type": [
      +                    "null",
      +                    "integer"
      +                  ]
      +                }
      +              },
      +              "required": [
      +                "next_cursor",
      +                "total"
      +              ],
      +              "type": "object"
      +            },
      +            "period": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "from": {
      +                  "description": "First day, YYYY-MM-DD.",
      +                  "type": "string"
      +                },
      +                "to": {
      +                  "description": "Last day, YYYY-MM-DD.",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "from",
      +                "to"
      +              ],
      +              "type": "object"
      +            },
      +            "view": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "brand",
      +            "view",
      +            "period",
      +            "connected",
      +            "pages",
      +            "pagination"
      +          ],
      +          "type": "object"
      +        },
      +        {
      +          "additionalProperties": false,
      +          "properties": {
      +            "brand": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "id": {
      +                  "type": "string"
      +                },
      +                "name": {
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "description": "The brand's website, or empty when none is set.",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "id",
      +                "name",
      +                "url"
      +              ],
      +              "type": "object"
      +            },
      +            "connected": {
      +              "type": "boolean"
      +            },
      +            "pagination": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "next_cursor": {
      +                  "description": "Pass as cursor to get the next page; empty on the last page.",
      +                  "type": "string"
      +                },
      +                "total": {
      +                  "description": "Items across all pages; null when not counted.",
      +                  "type": [
      +                    "null",
      +                    "integer"
      +                  ]
      +                }
      +              },
      +              "required": [
      +                "next_cursor",
      +                "total"
      +              ],
      +              "type": "object"
      +            },
      +            "period": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "from": {
      +                  "description": "First day, YYYY-MM-DD.",
      +                  "type": "string"
      +                },
      +                "to": {
      +                  "description": "Last day, YYYY-MM-DD.",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "from",
      +                "to"
      +              ],
      +              "type": "object"
      +            },
      +            "view": {
      +              "type": "string"
      +            },
      +            "visits": {
      +              "items": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "captured_at": {
      +                    "type": "string"
      +                  },
      +                  "name": {
      +                    "description": "The crawler or referring AI product.",
      +                    "type": "string"
      +                  },
      +                  "path": {
      +                    "type": "string"
      +                  },
      +                  "provider": {
      +                    "type": "string"
      +                  },
      +                  "type": {
      +                    "description": "crawler or referral.",
      +                    "type": "string"
      +                  },
      +                  "url": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "type",
      +                  "path",
      +                  "url",
      +                  "provider",
      +                  "name",
      +                  "captured_at"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            }
      +          },
      +          "required": [
      +            "brand",
      +            "view",
      +            "period",
      +            "connected",
      +            "visits",
      +            "pagination"
      +          ],
      +          "type": "object"
      +        }
      +      ]
      +    },
      +    "generated_at": {
      +      "description": "RFC 3339 time the response was made.",
      +      "type": "string"
      +    },
      +    "schema_version": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "schema_version",
      +    "generated_at",
      +    "data"
      +  ],
      +  "type": "object"
      +}
  7. Added

TDQS

A3.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already establish the safe read-only, idempotent, non-destructive profile, and the description adds substantive behavior on top: connected=false signals unconfigured tracking, bots and Cleotic's own fetches are excluded from visits, and only pages/evidence views paginate. Retention and rate-limit behavior are left to the schema rather than the description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the resource definition, then a definitions block, then per-view semantics and a paging caveat β€” no filler sentences. The semicolon-chained clauses make it dense and slightly run-on, but every clause carries distinct information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 10 parameters, an output schema, and full schema coverage, the description supplies what the structured fields cannot: metric definitions, the disconnected-tracking signal, and which views paginate. That is enough for correct invocation; only tool-selection guidance against siblings is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, and the description does add real meaning for the 'view' enum (enumerating exactly what summary returns, including search engines being 'listed, never counted') which the schema only says 'Defaults to summary.' It does not touch provider, traffic_type, or traffic_view beyond what the schema already documents.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The first clause names the exact resource β€” AI crawler requests and AI-referred visits pulled from the brand's own tracking β€” and defines its key terms (visits, AI share, crawler requests counted separately). It is clearly distinct from siblings like get_brand_overview or get_perception, though it never names an alternative to contrast with.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

'view summary: totals, providers, crawlers...' / 'view pages: per-page traffic' / 'view evidence: individual visits' effectively tells the agent which view to pick for which output. But there is no guidance on when to reach for this tool over neighbouring analytics tools, and no prerequisites or exclusions are stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources