# Structured Data Deprecation Watcher (`checksmithcats/structured-data-deprecation-watcher`) Actor

Watches official Google Search Central structured-data docs and updates for change signals affecting selected schema.org types.

- **URL**: https://apify.com/checksmithcats/structured-data-deprecation-watcher.md
- **Developed by:** [Checksmith Cats](https://apify.com/checksmithcats) (community)
- **Categories:** Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.50 / structured-data watcher report generated

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Structured Data Deprecation Watcher

Watch official Google Search Central structured-data docs for changes that can affect the schema.org types you rely on.

This Actor fetches mapped Google Search Central structured-data documentation and the Search Central updates page, records compact text hashes, scans update snippets near selected type names, and compares the result with your latest saved baseline.

### Useful For

- Teams maintaining Product, JobPosting, Event, Article, Recipe, VideoObject, FAQPage, or merchant structured data
- Agencies that want a recurring evidence record for structured-data documentation changes
- Storefront or marketplace teams that already use Structured Data Bulk QA and want a companion watcher
- Release checklists where official documentation changes should be noticed before the next structured-data update

### Signals

- Official source fetched or uncheckable
- Update-page retirement, removal, or deprecation language near watched type names
- Update-page required-property language near watched type names
- Mapped documentation page no longer mentioning a watched type name
- Official-document text hash changed since the latest baseline
- Baseline saved when `saveBaseline` is enabled

### Data Handling

The report stores official source URLs, fetch status, text hashes, matched snippets, and compact baseline state. It does not store full official document bodies.

### Billing note

Pay-per-event billing starts only when at least one mapped official source is successfully observed. A successful run records one report event plus one checked-item event for each observed official source. Sources that cannot be fetched are reported as unknown and are not billed as checked items. Invalid input and runs with no observable official source do not create report or checked-item charges.

### Limits

This Actor reads public official documentation. It does not run Google's Rich Results Test, inspect your site pages, certify eligibility, promise search display, interpret every documentation change, or replace manual review of official docs. If a source cannot be fetched, the report marks it unknown rather than retired. Checksmith Cats is not affiliated with Google.

### Related tools

- Structured Data Bulk QA - Use when you need page-level JSON-LD checks for selected structured-data types.
- Merchant Feed Preflight - Use when Product, return, shipping, and storefront trust signals need to be checked together.
- AI Visibility Signal Report - Use when structured-data signals are one part of a broader AI/search visibility record.

# Actor input Schema

## `types` (type: `array`):

schema.org type names to watch, such as Product, JobPosting, Event, Article, FAQPage, Recipe, or VideoObject.

## `baselineKey` (type: `string`):

Optional stable identity for repeated comparisons. Use the same value for the same site, client, or structured-data watch list.

## `includeUpdatesPage` (type: `boolean`):

Also scan the Google Search Central updates page for change, retirement, removal, or required-property language near the watched type names.

## `saveBaseline` (type: `boolean`):

Save the compact official-document snapshot for the next run. Turn off only when previewing a comparison without updating state.

## `stateStoreName` (type: `string`):

Key-value store name for the latest compact official-document baseline snapshot.

## Actor input object example

```json
{
  "types": [
    "Product",
    "FAQPage"
  ],
  "includeUpdatesPage": true,
  "saveBaseline": true,
  "stateStoreName": "structured-data-deprecation-watcher-state"
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `report` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "types": [
        "Product",
        "FAQPage"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("checksmithcats/structured-data-deprecation-watcher").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "types": [
        "Product",
        "FAQPage",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("checksmithcats/structured-data-deprecation-watcher").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "types": [
    "Product",
    "FAQPage"
  ]
}' |
apify call checksmithcats/structured-data-deprecation-watcher --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=checksmithcats/structured-data-deprecation-watcher",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/M4H3c4H80mlVstuAC/builds/DYv12FEGD4p4Toqse/openapi.json