{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"/api/v1/market-intelligence/schema","title":"DefaultBench Market Intelligence v1 report","type":"object","required":["product_code","schema_version","canonical_keyword","snapshot","market","evidence","data_quality"],"properties":{"product_code":{"const":"market_intelligence_v1"},"schema_version":{"const":"1.0.0"},"canonical_keyword":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"snapshot":{"type":"object","additionalProperties":false,"required":["from","as_of","periods_days","target_ranks","basis","immutable"],"properties":{"from":{"type":"string","format":"date-time"},"as_of":{"type":"string","format":"date-time"},"periods_days":{"type":"array","items":{"enum":[7,30,90]},"uniqueItems":true},"target_ranks":{"type":"array","items":{"enum":[1,3,5,10]},"uniqueItems":true},"basis":{"const":"generation_time"},"immutable":{"const":true}}},"market":{"type":"object","additionalProperties":false,"required":["search_demand_index","trend","searches_producing_no_result_basis_points","active_organic_resource_count","sponsored_listing_count","total_verified_sponsored_spend_base_units","rank_distribution","amount_required_to_reach_ranks","recent_competitive_movement","estimated_share_of_sponsored_impressions_by_rank","referral_rate_range_basis_points","related_under_served_keywords"],"properties":{"search_demand_index":{"oneOf":[{"allOf":[{"$ref":"#/$defs/available"},{"type":"object","properties":{"value":{"type":"object","required":["value","scale"],"properties":{"value":{"type":"string","pattern":"^[0-9]+$"},"scale":{"const":10000}},"additionalProperties":false}}}]},{"$ref":"#/$defs/insufficient_data"}]},"trend":{"type":"array","items":{"type":"object","required":["period_days","change_basis_points"],"properties":{"period_days":{"enum":[7,30,90]},"change_basis_points":{"oneOf":[{"allOf":[{"$ref":"#/$defs/available"},{"type":"object","properties":{"value":{"type":"string","pattern":"^-?[0-9]+$"}}}]},{"$ref":"#/$defs/insufficient_data"}]}},"additionalProperties":false}},"searches_producing_no_result_basis_points":{"oneOf":[{"allOf":[{"$ref":"#/$defs/available"},{"type":"object","properties":{"value":{"type":"string","pattern":"^[0-9]+$"}}}]},{"$ref":"#/$defs/insufficient_data"}]},"active_organic_resource_count":{"oneOf":[{"allOf":[{"$ref":"#/$defs/available"},{"type":"object","properties":{"value":{"type":"integer","minimum":0}}}]},{"$ref":"#/$defs/insufficient_data"}]},"sponsored_listing_count":{"oneOf":[{"allOf":[{"$ref":"#/$defs/available"},{"type":"object","properties":{"value":{"type":"integer","minimum":0}}}]},{"$ref":"#/$defs/insufficient_data"}]},"total_verified_sponsored_spend_base_units":{"oneOf":[{"allOf":[{"$ref":"#/$defs/available"},{"type":"object","properties":{"value":{"type":"string","pattern":"^[0-9]+$"}}}]},{"$ref":"#/$defs/insufficient_data"}]},"rank_distribution":{"oneOf":[{"allOf":[{"$ref":"#/$defs/available"},{"type":"object","properties":{"value":{"type":"object","required":["top_ranks","total_listing_count","returned_listing_count","truncated"],"properties":{"top_ranks":{"type":"array","maxItems":100,"items":{"type":"object","required":["rank","cumulative_payment_base_units"],"properties":{"rank":{"type":"integer","minimum":1,"maximum":100},"cumulative_payment_base_units":{"type":"string","pattern":"^[0-9]+$"}},"additionalProperties":false}},"total_listing_count":{"type":"integer","minimum":0},"returned_listing_count":{"type":"integer","minimum":0,"maximum":100},"truncated":{"type":"boolean"}}}}}]},{"$ref":"#/$defs/insufficient_data"}]},"amount_required_to_reach_ranks":{"oneOf":[{"allOf":[{"$ref":"#/$defs/available"},{"type":"object","properties":{"value":{"type":"array","items":{"type":"object","required":["rank","amount_base_units"],"properties":{"rank":{"enum":[1,3,5,10]},"amount_base_units":{"type":"string","pattern":"^[0-9]+$"}}}}}}]},{"$ref":"#/$defs/insufficient_data"}]},"recent_competitive_movement":{"oneOf":[{"allOf":[{"$ref":"#/$defs/available"},{"type":"object","properties":{"value":{"type":"object","required":["rank_observations","changed_rank_observations","listings_observed","latest_observation"],"properties":{"rank_observations":{"type":"string","pattern":"^[0-9]+$"},"changed_rank_observations":{"type":"string","pattern":"^[0-9]+$"},"listings_observed":{"type":"string","pattern":"^[0-9]+$"},"latest_observation":{"type":["string","null"],"format":"date-time"}}}}}]},{"$ref":"#/$defs/insufficient_data"}]},"estimated_share_of_sponsored_impressions_by_rank":{"oneOf":[{"allOf":[{"$ref":"#/$defs/available"},{"type":"object","properties":{"value":{"type":"array","items":{"type":"object","required":["rank","share_basis_points","sample_size"],"properties":{"rank":{"type":"integer","minimum":1},"share_basis_points":{"type":"string","pattern":"^[0-9]+$"},"sample_size":{"type":"string","pattern":"^[0-9]+$"}}}}}}]},{"$ref":"#/$defs/insufficient_data"}]},"referral_rate_range_basis_points":{"oneOf":[{"allOf":[{"$ref":"#/$defs/available"},{"type":"object","properties":{"value":{"type":"object","required":["lower","upper","qualifying_rank_count"],"properties":{"lower":{"type":"string","pattern":"^[0-9]+$"},"upper":{"type":"string","pattern":"^[0-9]+$"},"qualifying_rank_count":{"type":"integer","minimum":1}}}}}]},{"$ref":"#/$defs/insufficient_data"}]},"related_under_served_keywords":{"oneOf":[{"allOf":[{"$ref":"#/$defs/available"},{"type":"object","properties":{"value":{"type":"array","items":{"type":"object","required":["canonical_keyword","search_sample_size","no_result_share_basis_points","sponsored_listing_count"],"properties":{"canonical_keyword":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"search_sample_size":{"type":"string","pattern":"^[0-9]+$"},"no_result_share_basis_points":{"type":"string","pattern":"^[0-9]+$"},"sponsored_listing_count":{"type":"integer","minimum":0}}}}}}]},{"$ref":"#/$defs/insufficient_data"}]}}},"evidence":{"type":"object","additionalProperties":false,"required":["coverage","earliest_aggregate_observation","latest_aggregate_observation","source_classes"],"properties":{"coverage":{"oneOf":[{"allOf":[{"$ref":"#/$defs/available"},{"type":"object","properties":{"value":{"type":"array","items":{"type":"object","required":["freshness","sponsored_impressions","share_basis_points"],"properties":{"freshness":{"enum":["fresh","stale","unknown"]},"sponsored_impressions":{"type":"string","pattern":"^[0-9]+$"},"share_basis_points":{"type":"string","pattern":"^[0-9]+$"}}}}}}]},{"$ref":"#/$defs/insufficient_data"}]},"earliest_aggregate_observation":{"type":["string","null"],"format":"date-time"},"latest_aggregate_observation":{"type":["string","null"],"format":"date-time"},"source_classes":{"type":"array","items":{"type":"string"},"uniqueItems":true}}},"data_quality":{"type":"object","additionalProperties":false,"required":["minimum_sample_size","search_sample_size","sponsored_impression_sample_size","referral_sample_size","rare_keyword_buckets_suppressed","raw_queries_retained","individual_searchers_exposed","provider_private_metrics_exposed","measurement_classes","limitations"],"properties":{"minimum_sample_size":{"type":"integer","minimum":1},"search_sample_size":{"oneOf":[{"type":"string","pattern":"^[0-9]+$"},{"type":"null"}]},"sponsored_impression_sample_size":{"oneOf":[{"type":"string","pattern":"^[0-9]+$"},{"type":"null"}]},"referral_sample_size":{"oneOf":[{"type":"string","pattern":"^[0-9]+$"},{"type":"null"}]},"rare_keyword_buckets_suppressed":{"const":true},"raw_queries_retained":{"const":false},"individual_searchers_exposed":{"const":false},"provider_private_metrics_exposed":{"const":false},"measurement_classes":{"type":"object","additionalProperties":{"type":"string"}},"limitations":{"type":"array","items":{"type":"string"}}}}},"additionalProperties":false,"$defs":{"available":{"type":"object","required":["state","value","sample_size"],"properties":{"state":{"const":"available"},"value":{},"sample_size":{"type":"string","pattern":"^[0-9]+$"}}},"insufficient_data":{"type":"object","additionalProperties":false,"required":["state","reason","publication_threshold"],"properties":{"state":{"const":"insufficient_data"},"reason":{"enum":["publication_threshold_not_met","no_observations","not_enough_history"]},"publication_threshold":{"type":"integer","minimum":1}}}}}