serp-metrics

{'type': 'object', 'required': ['rows'], 'properties': {'rows': {'type': 'array', 'items': {'type': 'object', 'required': ['position', 'impressions'], 'properties': {'query': {'type': 'string', 'description': 'Optional label for the row.'}, 'clicks': {'type': 'number', 'description': 'Optional observed clicks, used to calibrate the curve.'}, 'position': {'type': 'number', 'description': 'Average SERP position for the row, 1-based.'}, 'impressions': {'type': 'number', 'description': 'Impressions the row received.'}, 'target_position': {'type': 'number', 'description': 'Optional per-row target position, overriding the global target.'}}}, 'description': 'Query rows.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['rows', 'ctr_curve'], 'properties': {'rows': {'type': 'array', 'items': {'type': 'object', 'required': ['position', 'impressions'], 'properties': {'query': {'type': 'string', 'description': 'Optional label for the row.'}, 'clicks': {'type': 'number', 'description': 'Optional observed clicks, used to calibrate the curve.'}, 'position': {'type': 'number', 'description': 'Average SERP position for the row, 1-based.'}, 'impressions': {'type': 'number', 'description': 'Impressions the row received.'}, 'target_position': {'type': 'number', 'description': 'Optional per-row target position, overriding the global target.'}}}, 'description': 'Query rows.'}, 'ctr_curve': {'type': 'object', 'description': 'Required. Map of position to click-through rate as a 0-1 fraction, e.g. {"1":0.28,"2":0.15,"3":0.10,"10":0.02}. Supply your own measured values.', 'additionalProperties': {'type': 'number'}}, 'target_position': {'type': 'number', 'description': 'Target position applied to every row that does not carry its own.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['entities'], 'properties': {'entities': {'type': 'array', 'items': {'type': 'object', 'required': ['impressions'], 'properties': {'entity': {'type': 'string', 'description': 'Competitor name or domain.'}, 'position': {'type': 'number', 'description': 'Average position, required only when a ctr_curve is supplied.'}, 'impressions': {'type': 'number'}}}, 'description': 'One entry per competitor per keyword, or pre-aggregated per competitor.'}, 'ctr_curve': {'type': 'object', 'description': 'Optional caller-supplied position-to-CTR map, for weighted visibility.', 'additionalProperties': {'type': 'number'}}}, 'additionalProperties': False}