{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/frase-io/json-schema/frase-io-content-schema.json",
  "title": "Content",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/frase-io-content-api-openapi.yml#/components/schemas/Content",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "brief_id": {
      "type": [
        "string",
        "null"
      ],
      "format": "uuid"
    },
    "site_id": {
      "type": [
        "string",
        "null"
      ],
      "format": "uuid"
    },
    "project_id": {
      "type": [
        "string",
        "null"
      ],
      "format": "uuid"
    },
    "folder_id": {
      "type": [
        "string",
        "null"
      ],
      "format": "uuid"
    },
    "title": {
      "type": [
        "string",
        "null"
      ]
    },
    "slug": {
      "type": [
        "string",
        "null"
      ]
    },
    "type": {
      "type": [
        "string",
        "null"
      ]
    },
    "body": {
      "type": [
        "string",
        "null"
      ]
    },
    "language": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO 639-1 language code (e.g., 'en', 'de')"
    },
    "country": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO 3166-1 country code (e.g., 'US', 'DE')"
    },
    "meta_title": {
      "type": [
        "string",
        "null"
      ]
    },
    "meta_description": {
      "type": [
        "string",
        "null"
      ]
    },
    "target_keywords": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "status": {
      "type": "string",
      "enum": [
        "draft",
        "generating",
        "review",
        "published",
        "archived"
      ]
    },
    "word_count": {
      "type": [
        "integer",
        "null"
      ]
    },
    "eeat_score": {
      "type": [
        "integer",
        "null"
      ],
      "description": "E-E-A-T score (0-100)"
    },
    "geo_score": {
      "type": [
        "integer",
        "null"
      ],
      "description": "GEO optimization score (0-100)"
    },
    "seo_score": {
      "type": [
        "integer",
        "null"
      ],
      "description": "SEO score (0-100)"
    },
    "quotability_score": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Quotability score (0-100)"
    },
    "ai_citation_score": {
      "type": [
        "integer",
        "null"
      ],
      "description": "AI citation readiness score (0-100)"
    },
    "eeat_breakdown": {
      "$ref": "#/$defs/EeatBreakdown"
    },
    "geo_breakdown": {
      "$ref": "#/$defs/GeoBreakdown"
    },
    "seo_breakdown": {
      "$ref": "#/$defs/SeoBreakdown"
    },
    "featured_image": {
      "type": [
        "string",
        "null"
      ],
      "description": "URL of the featured image"
    },
    "hero_image_prompt": {
      "type": [
        "string",
        "null"
      ],
      "description": "AI prompt used to generate hero image"
    },
    "published_url": {
      "type": [
        "string",
        "null"
      ]
    },
    "published_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "is_monitored": {
      "type": "boolean",
      "description": "True when the article is under Content Guard monitoring."
    },
    "monitored_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "Timestamp monitoring was first enabled for this article."
    },
    "scheduled_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "schema_markup": {
      "type": [
        "object",
        "null"
      ],
      "description": "JSON-LD schema markup"
    },
    "schema_types": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      },
      "description": "Schema types (e.g., 'Article', 'FAQPage')"
    },
    "progress_details": {
      "$ref": "#/$defs/ContentProgressDetails"
    },
    "created_at": {
      "type": "string",
      "format": "date-time"
    },
    "updated_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    }
  },
  "$defs": {
    "ContentProgressDetails": {
      "type": [
        "object",
        "null"
      ],
      "description": "Progress details for content generation",
      "properties": {
        "phase": {
          "type": "string",
          "enum": [
            "researching",
            "writing",
            "scoring",
            "complete",
            "failed",
            "canceled"
          ]
        },
        "phase_percent": {
          "type": "integer",
          "description": "Progress within current phase (0-100)"
        },
        "substep": {
          "type": "string",
          "description": "Current substep description"
        },
        "current_section": {
          "type": "string"
        },
        "completed_sections": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "word_count": {
          "type": "integer"
        },
        "total_sections": {
          "type": "integer"
        },
        "sources": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string"
              },
              "title": {
                "type": "string"
              }
            }
          }
        },
        "citation_count": {
          "type": "integer"
        },
        "error": {
          "type": "string"
        }
      }
    },
    "EeatBreakdown": {
      "type": [
        "object",
        "null"
      ],
      "description": "E-E-A-T score breakdown",
      "properties": {
        "experience": {
          "type": [
            "number",
            "null"
          ]
        },
        "expertise": {
          "type": [
            "number",
            "null"
          ]
        },
        "authority": {
          "type": [
            "number",
            "null"
          ]
        },
        "trust": {
          "type": [
            "number",
            "null"
          ]
        }
      }
    },
    "GeoBreakdown": {
      "type": [
        "object",
        "null"
      ],
      "description": "GEO score breakdown",
      "properties": {
        "quotability": {
          "type": [
            "number",
            "null"
          ]
        },
        "structure": {
          "type": [
            "number",
            "null"
          ]
        },
        "definitions": {
          "type": [
            "number",
            "null"
          ]
        },
        "takeaways": {
          "type": [
            "number",
            "null"
          ]
        }
      }
    },
    "SeoBreakdown": {
      "type": [
        "object",
        "null"
      ],
      "description": "SEO score breakdown",
      "properties": {
        "keywords": {
          "type": [
            "number",
            "null"
          ]
        },
        "meta": {
          "type": [
            "number",
            "null"
          ]
        },
        "structure": {
          "type": [
            "number",
            "null"
          ]
        },
        "readability": {
          "type": [
            "number",
            "null"
          ]
        }
      }
    }
  }
}