SEO Deployment Guard Snapshot Comparison

POST /v1/seo-guard

SEO Deployment Guard Snapshot Comparison

Compare customer-supplied deployment metadata with a baseline and versioned release requirements.

50 credits · USD $0.050

Input schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "maxLength": 100,
      "x-maxUtf8Bytes": 100
    },
    "rule_version": {
      "type": "integer",
      "minimum": 1
    },
    "baseline_id": {
      "type": "string",
      "maxLength": 100,
      "x-maxUtf8Bytes": 100
    },
    "current": {
      "type": "object",
      "properties": {
        "title": {
          "type": "string",
          "maxLength": 2048
        },
        "description": {
          "type": "string",
          "maxLength": 2048
        },
        "canonical": {
          "type": "string",
          "maxLength": 2048,
          "description": "Empty or HTTPS URL without credentials."
        },
        "indexable": {
          "type": "boolean"
        },
        "jsonld_types": {
          "type": "array",
          "maxItems": 50,
          "items": {
            "type": "string",
            "maxLength": 100
          }
        }
      },
      "required": [
        "title",
        "description",
        "canonical",
        "indexable",
        "jsonld_types"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "project_id",
    "rule_version",
    "baseline_id",
    "current"
  ]
}

Request

curl -X POST 'https://staging.callmint.dev/v1/seo-guard' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: unique-request-001' \
  -H 'Content-Type: application/json' \
  -d '{"project_id":"YOUR_PROJECT_ID","rule_version":1,"baseline_id":"YOUR_SNAPSHOT_ID","current":{"title":"Example","description":"Example page","canonical":"https://example.com/","indexable":true,"jsonld_types":["WebPage"]}}'

Response result

{
  "project_id": "YOUR_PROJECT_ID",
  "kind": "seo",
  "passed": true,
  "findings": [],
  "severity": "none",
  "rule_version": 1,
  "checked_at": "2026-11-03T00:00:00.000Z",
  "fingerprint": null,
  "duplicate": false,
  "changes": []
}

Limitations

50 credits. Compares supplied title, description, canonical, indexing flag and structured-data type list. Does not fetch HTML, verify indexing, crawl redirects or validate structured-data semantics. Baselines are explicit and immutable; no scheduler or dashboard.

All enabled routes accept a JSON object of at most 60,000 UTF-8 bytes. String limits are also measured in UTF-8 bytes.

seo-guard