DailyInsights

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/gatiflow/main/json-schema/gatiflow-daily-insights-schema.json",
  "title": "DailyInsights",
  "description": "The shared Daily Insights report, shaped to the caller's plan.",
  "x-generated": "2026-09-27",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/gatiflow-public-api-openapi.yml#/components/schemas/DailyInsights",
  "properties": {
    "analytics": {
      "$ref": "#/$defs/ReportAnalytics"
    },
    "cta": {
      "$ref": "#/$defs/InsightsCallToAction"
    },
    "generated_at": {
      "format": "date-time",
      "title": "Generated At",
      "type": "string"
    },
    "metadata": {
      "$ref": "#/$defs/InsightsMetadata"
    },
    "score": {
      "$ref": "#/$defs/ReportScore"
    },
    "sections": {
      "$ref": "#/$defs/ReportSections"
    },
    "subtitle": {
      "title": "Subtitle",
      "type": "string"
    },
    "title": {
      "title": "Title",
      "type": "string"
    },
    "week_of": {
      "title": "Week Of",
      "type": "string"
    }
  },
  "required": [
    "generated_at",
    "week_of",
    "title",
    "subtitle",
    "sections",
    "score",
    "analytics",
    "cta",
    "metadata"
  ],
  "type": "object",
  "$defs": {
    "ExecutiveSummary": {
      "description": "The report overview. ``narrative`` is written by a language model and\ndeclared as such in ``metadata.ai_generated``.",
      "properties": {
        "narrative": {
          "title": "Narrative",
          "type": "string"
        },
        "overall_confidence": {
          "title": "Overall Confidence",
          "type": "number"
        },
        "summary": {
          "title": "Summary",
          "type": "string"
        },
        "title": {
          "title": "Title",
          "type": "string"
        }
      },
      "required": [
        "title",
        "summary",
        "narrative",
        "overall_confidence"
      ],
      "title": "ExecutiveSummary",
      "type": "object"
    },
    "InsightsCallToAction": {
      "properties": {
        "api_docs": {
          "title": "Api Docs",
          "type": "string"
        },
        "message": {
          "title": "Message",
          "type": "string"
        },
        "signup_url": {
          "title": "Signup Url",
          "type": "string"
        }
      },
      "required": [
        "message",
        "signup_url",
        "api_docs"
      ],
      "title": "InsightsCallToAction",
      "type": "object"
    },
    "InsightsMetadata": {
      "properties": {
        "data_sources": {
          "title": "Data Sources",
          "type": "string"
        },
        "product": {
          "title": "Product",
          "type": "string"
        },
        "report_type": {
          "title": "Report Type",
          "type": "string"
        },
        "update_frequency": {
          "title": "Update Frequency",
          "type": "string"
        }
      },
      "required": [
        "product",
        "data_sources",
        "update_frequency",
        "report_type"
      ],
      "title": "InsightsMetadata",
      "type": "object"
    },
    "MarketOverview": {
      "properties": {
        "average_score": {
          "title": "Average Score",
          "type": "number"
        },
        "top_score": {
          "title": "Top Score",
          "type": "number"
        },
        "total_profiles_analyzed": {
          "title": "Total Profiles Analyzed",
          "type": "integer"
        }
      },
      "required": [
        "total_profiles_analyzed",
        "average_score",
        "top_score"
      ],
      "title": "MarketOverview",
      "type": "object"
    },
    "OrgBriefing": {
      "description": "Business plan only: a paragraph on the organization's own watchlist.",
      "properties": {
        "narrative": {
          "title": "Narrative",
          "type": "string"
        },
        "title": {
          "title": "Title",
          "type": "string"
        }
      },
      "required": [
        "title",
        "narrative"
      ],
      "title": "OrgBriefing",
      "type": "object"
    },
    "ReportAnalytics": {
      "description": "Distributions over the talent profiles in the report.",
      "properties": {
        "market_overview": {
          "$ref": "#/$defs/MarketOverview"
        },
        "role_distribution": {
          "additionalProperties": {
            "type": "integer"
          },
          "title": "Role Distribution",
          "type": "object"
        },
        "seniority_distribution": {
          "additionalProperties": {
            "type": "integer"
          },
          "description": "Profiles per score band.",
          "title": "Seniority Distribution",
          "type": "object"
        },
        "seniority_levels": {
          "additionalProperties": {
            "type": "integer"
          },
          "description": "Profiles per seniority label.",
          "title": "Seniority Levels",
          "type": "object"
        },
        "stack_distribution": {
          "additionalProperties": {
            "type": "integer"
          },
          "title": "Stack Distribution",
          "type": "object"
        },
        "strategic_insights": {
          "items": {
            "type": "string"
          },
          "title": "Strategic Insights",
          "type": "array"
        }
      },
      "required": [
        "market_overview",
        "seniority_distribution",
        "seniority_levels",
        "stack_distribution",
        "role_distribution",
        "strategic_insights"
      ],
      "title": "ReportAnalytics",
      "type": "object"
    },
    "ReportScore": {
      "description": "Aggregate confidence over the signals in the report.",
      "properties": {
        "categories": {
          "additionalProperties": {
            "type": "number"
          },
          "title": "Categories",
          "type": "object"
        },
        "collection_health": {
          "additionalProperties": true,
          "title": "Collection Health",
          "type": "object"
        },
        "confidence_interval": {
          "additionalProperties": true,
          "title": "Confidence Interval",
          "type": "object"
        },
        "cross_source_signals": {
          "title": "Cross Source Signals",
          "type": "integer"
        },
        "overall_confidence": {
          "maximum": 1.0,
          "minimum": 0.0,
          "title": "Overall Confidence",
          "type": "number"
        },
        "signal_count": {
          "minimum": 0.0,
          "title": "Signal Count",
          "type": "integer"
        },
        "source_diversity": {
          "title": "Source Diversity",
          "type": "integer"
        }
      },
      "required": [
        "overall_confidence",
        "signal_count"
      ],
      "title": "ReportScore",
      "type": "object"
    },
    "ReportSections": {
      "description": "The report body.",
      "properties": {
        "executive_summary": {
          "$ref": "#/$defs/ExecutiveSummary"
        },
        "hiring_signals": {
          "$ref": "#/$defs/SignalSection"
        },
        "market_trends": {
          "$ref": "#/$defs/SignalSection"
        },
        "org_briefing": {
          "$ref": "#/$defs/OrgBriefing"
        },
        "talent_signals": {
          "$ref": "#/$defs/SignalSection"
        }
      },
      "required": [
        "executive_summary",
        "market_trends",
        "talent_signals",
        "hiring_signals"
      ],
      "title": "ReportSections",
      "type": "object"
    },
    "SignalItem": {
      "description": "One signal in a report section.\n\n``confidence`` and ``evidence`` are present on plans that include them\nand absent on the expired-trial preview.",
      "properties": {
        "category": {
          "description": "Signal category, for example market_trend, research_paper, talent or hiring_signal.",
          "title": "Category",
          "type": "string"
        },
        "company": {
          "title": "Company",
          "type": "string"
        },
        "confidence": {
          "title": "Confidence",
          "type": "number"
        },
        "detail": {
          "title": "Detail",
          "type": "string"
        },
        "entity_key": {
          "title": "Entity Key",
          "type": "string"
        },
        "entity_type": {
          "title": "Entity Type",
          "type": "string"
        },
        "evidence": {
          "additionalProperties": true,
          "description": "The source metadata behind the counts, as collected.",
          "title": "Evidence",
          "type": "object"
        },
        "example_headline": {
          "title": "Example Headline",
          "type": "string"
        },
        "hiring_status": {
          "title": "Hiring Status",
          "type": "string"
        },
        "relevance": {
          "title": "Relevance",
          "type": "number"
        },
        "source": {
          "description": "Source ids that observed the signal, comma-separated.",
          "title": "Source",
          "type": "string"
        },
        "timestamp": {
          "format": "date-time",
          "title": "Timestamp",
          "type": "string"
        },
        "title": {
          "title": "Title",
          "type": "string"
        },
        "url": {
          "title": "Url",
          "type": "string"
        },
        "velocity": {
          "additionalProperties": true,
          "description": "Week-over-week movement of the signal.",
          "title": "Velocity",
          "type": "object"
        }
      },
      "required": [
        "source",
        "title",
        "detail",
        "category",
        "timestamp"
      ],
      "title": "SignalItem",
      "type": "object"
    },
    "SignalSection": {
      "description": "A section of signals, capped by the plan.",
      "properties": {
        "count": {
          "description": "Number of items in data.",
          "minimum": 0.0,
          "title": "Count",
          "type": "integer"
        },
        "data": {
          "items": {
            "$ref": "#/$defs/SignalItem"
          },
          "title": "Data",
          "type": "array"
        },
        "title": {
          "title": "Title",
          "type": "string"
        }
      },
      "required": [
        "title",
        "count",
        "data"
      ],
      "title": "SignalSection",
      "type": "object"
    }
  }
}