{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://artifacts.apis.io/trendsfast/json-schema/trendsfast-trends-api-v3-response-schema.json", "title": "TrendsApiV3Response", "x-generated": "2026-10-30", "x-method": "derived", "x-generator": "derive-json-schema.py", "x-source": "openapi/trendsfast-v3-openapi.json#/components/schemas/TrendsApiV3Response", "type": "object", "properties": { "version": { "type": "string", "const": "trends-api-v3" }, "result_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "request_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "operation": { "type": "string", "enum": [ "global", "niche", "ask", "discover" ] }, "generated_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "read_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "new_research": { "type": "boolean" }, "data": { "anyOf": [ { "$ref": "#/$defs/TrendIntelligenceV3" }, { "type": "object", "properties": { "version": { "type": "string", "const": "trend-ask-v3" }, "question": { "type": "string", "minLength": 3, "maxLength": 1000 }, "plan": { "type": "object", "properties": { "intent": { "type": "string", "enum": [ "DISCOVER", "FILTER", "COMPARE", "EXPLAIN", "SUMMARIZE", "FIND_CONVERSATIONS", "FIND_CREATIVE_PATTERNS", "ANALYZE_CUSTOMER_PROBLEMS", "FIND_FEATURE_REQUESTS", "COMPETITOR_ACTIVITY", "SEARCH_DEMAND" ] }, "basis": { "type": "string", "const": "BOUNDED_DETERMINISTIC_PLAN" }, "maximum_items": { "type": "integer", "minimum": 1, "maximum": 100 }, "provider_calls": { "type": "number", "const": 0 }, "filters": { "type": "object", "properties": { "platforms": { "minItems": 1, "maxItems": 11, "type": "array", "items": { "type": "string", "enum": [ "TIKTOK", "YOUTUBE", "INSTAGRAM", "FACEBOOK", "X", "REDDIT", "GOOGLE", "BING", "AI_SEARCH", "WEB", "FORUM", "GITHUB" ] } }, "content_types": { "minItems": 1, "maxItems": 4, "type": "array", "items": { "type": "string", "enum": [ "VIDEO", "CONVERSATION", "SEARCH", "ARTICLE" ] } }, "categories": { "minItems": 1, "maxItems": 10, "type": "array", "items": { "type": "string", "enum": [ "COFFEE_BREWING", "CONTENT_CREATION", "CUSTOMER_DISCOVERY", "SOFTWARE_DEVELOPMENT", "PRODUCTIVITY", "FITNESS", "GARDENING", "COOKING", "SKINCARE", "TRAVEL", "AI", "ECOMMERCE", "FINANCE", "EDUCATION", "ENTERTAINMENT", "SUSTAINABILITY", "MARKETING", "SALES", "HEALTHCARE", "HEALTH_WELLNESS", "HOME_SERVICES", "REAL_ESTATE", "FASHION", "BEAUTY", "PETS", "GAMING", "PARENTING", "AUTOMOTIVE", "LEGAL", "RESTAURANTS", "SPORTS", "CRYPTO", "CAREERS", "HOME_DECOR", "WEDDINGS", "OUTDOORS", "PHOTOGRAPHY", "CRAFTS_DIY", "CYBERSECURITY", "NONPROFIT", "MUSIC_CREATION", "DRINKS", "GENERAL" ] } }, "signals": { "minItems": 1, "maxItems": 8, "type": "array", "items": { "type": "string", "enum": [ "POPULAR_NOW", "RISING", "EMERGING", "RECURRING_PROBLEM", "SEARCH_INTEREST", "CREATIVE_PATTERN", "NEW_DEVELOPMENT", "INSUFFICIENT_EVIDENCE" ] } }, "evidence_quality": { "minItems": 1, "maxItems": 3, "type": "array", "items": { "type": "string", "enum": [ "ATTRIBUTED_METADATA", "PERMITTED_TEXT", "INSPECTED_MEDIA" ] } }, "country": { "type": "string", "pattern": "^[A-Z]{2}$" }, "region": { "type": "string", "minLength": 1, "maxLength": 100 }, "observed_market": { "type": "string", "pattern": "^[A-Z]{2}$" }, "language": { "type": "string", "pattern": "^[a-z]{2}(?:-[A-Z]{2})?$" }, "observed_from": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "observed_to": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "lookback_hours": { "default": 72, "type": "integer", "minimum": 1, "maximum": 720 }, "history_days": { "type": "integer", "minimum": 1, "maximum": 90 }, "compare_to": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "limit": { "default": 20, "type": "integer", "minimum": 1, "maximum": 100 } }, "required": [ "lookback_hours", "limit" ], "additionalProperties": false }, "subject_terms": { "maxItems": 8, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 500 } }, "interpretation": { "maxItems": 10, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 500 } } }, "required": [ "intent", "basis", "maximum_items", "provider_calls" ], "additionalProperties": false }, "intelligence": { "$ref": "#/$defs/TrendIntelligenceV3" }, "claims": { "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 2000 }, "evidence_ids": { "maxItems": 24, "type": "array", "items": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" } } }, "required": [ "text", "evidence_ids" ], "additionalProperties": false } }, "answer": { "type": "string", "maxLength": 6000 }, "limitations": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 500 } }, "answer_status": { "type": "string", "enum": [ "ANSWERED", "PARTIAL", "INSUFFICIENT_EVIDENCE", "NEEDS_CONTEXT", "NOT_COLLECTED" ] }, "findings": { "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "TREND", "CUSTOMER_PROBLEM", "FEATURE_REQUEST", "QUESTION_ASKED", "HOOK_OBSERVED", "FORMAT_OBSERVED", "TITLE_OBSERVED", "SEARCH_DEMAND", "COMPETITOR_POST", "COMPETITOR_MENTION", "RELATED_DISCUSSION", "REFERENCE" ] }, "item_id": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" }, "title": { "type": "string", "minLength": 1, "maxLength": 500 }, "statement": { "type": "string", "minLength": 1, "maxLength": 1200 }, "platform": { "type": "string", "enum": [ "TIKTOK", "YOUTUBE", "INSTAGRAM", "FACEBOOK", "X", "REDDIT", "GOOGLE", "BING", "AI_SEARCH", "WEB", "FORUM", "GITHUB" ] }, "source": { "type": "string", "minLength": 1, "maxLength": 500 }, "url": { "anyOf": [ { "type": "string", "maxLength": 2048, "format": "uri" }, { "type": "null" } ] }, "metrics": { "anyOf": [ { "type": "string", "maxLength": 300 }, { "type": "null" } ] }, "published_at": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ] }, "ring": { "type": "string", "enum": [ "CORE", "ADJACENT", "GLOBAL" ] }, "evidence_ids": { "minItems": 1, "maxItems": 24, "type": "array", "items": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" } } }, "required": [ "kind", "item_id", "title", "statement", "platform", "source", "url", "metrics", "published_at", "ring", "evidence_ids" ], "additionalProperties": false } }, "next_steps": { "maxItems": 8, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 600 } }, "missing_inputs": { "maxItems": 8, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 600 } } }, "required": [ "version", "question", "plan", "intelligence", "claims", "answer", "limitations" ], "additionalProperties": false } ] }, "usage": { "type": "object", "properties": { "credits_charged": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "read_charge": { "type": "number", "const": 0 }, "this_request_credits": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "catalog_version": { "type": "string", "minLength": 1, "maxLength": 180 }, "replayed": { "type": "boolean" } }, "required": [ "credits_charged", "read_charge", "this_request_credits", "catalog_version", "replayed" ], "additionalProperties": false }, "next_cursor": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 512 }, { "type": "null" } ] } }, "required": [ "version", "result_id", "request_id", "operation", "generated_at", "read_at", "new_research", "data", "usage", "next_cursor" ], "additionalProperties": false, "$defs": { "TrendIntelligenceV3": { "type": "object", "properties": { "version": { "type": "string", "const": "trend-intelligence-v3" }, "snapshot_id": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" }, "as_of": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "read_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "classification_as_of": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "classification_window": { "type": "object", "properties": { "lookback_hours": { "type": "integer", "minimum": 1, "maximum": 720 }, "observed_from": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "observed_to": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" } }, "required": [ "lookback_hours", "observed_from", "observed_to" ], "additionalProperties": false }, "context": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "CONFIRMED_CONTEXT", "TEMPORARY_INPUT" ] }, "context_id": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "revision": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "fields": { "minItems": 1, "maxItems": 250, "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string", "enum": [ "description", "topic", "problem", "audience", "exclusion", "capability", "job", "industry", "product_category", "customer_interest", "competitor", "adjacent_category", "market", "language", "platform", "community", "competitor_handle", "competitor_domain", "keyword" ] }, "value": { "type": "string", "minLength": 1, "maxLength": 2000 }, "basis": { "type": "string", "enum": [ "OWNER_CONFIRMED", "WEBSITE_OBSERVED", "USER_ASSERTED", "INFERRED" ] }, "evidence_ids": { "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 180 } } }, "required": [ "field", "value", "basis", "evidence_ids" ], "additionalProperties": false } } }, "required": [ "kind", "context_id", "revision", "fields" ], "additionalProperties": false }, { "type": "null" } ] }, "items": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" }, "cluster_id": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" }, "cluster_assignment": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" }, "entity_id": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" }, "cluster_id": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" }, "event_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "assigned_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "method_version": { "type": "string", "minLength": 1, "maxLength": 500 }, "change": { "type": "string", "enum": [ "INITIAL", "MERGE", "SPLIT" ] }, "predecessor_cluster_ids": { "maxItems": 100, "type": "array", "items": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" } } }, "required": [ "id", "entity_id", "cluster_id", "event_id", "assigned_at", "method_version", "change", "predecessor_cluster_ids" ], "additionalProperties": false }, "history": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "COMPARABLE", "NO_BASELINE", "INSUFFICIENT_HISTORY", "NOT_OBSERVED" ] }, "first_retained_observed_at": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ] }, "last_retained_observed_at": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ] }, "requested_baseline_at": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ] }, "baseline_observation_id": { "anyOf": [ { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" }, { "type": "null" } ] }, "snapshots": { "maxItems": 24, "type": "array", "items": { "type": "object", "properties": { "observation_id": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" }, "source": { "type": "string", "minLength": 1, "maxLength": 500 }, "observed_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "metrics": { "maxItems": 24, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "views", "likes", "comments", "shares", "saves", "followers", "relative_interest", "estimated_monthly_demand", "points", "score", "reposts", "quotes", "reactions", "rising_percent", "thumbs_up" ] }, "value": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "unit": { "type": "string", "enum": [ "COUNT", "INDEX", "MODELED_MONTHLY_COUNT", "PERCENT" ] }, "semantics": { "type": "string", "enum": [ "CUMULATIVE_COUNTER", "WINDOW_VALUE", "MODELED_ESTIMATE" ] }, "definition": { "type": "string", "minLength": 1, "maxLength": 500 }, "scope": { "type": "string", "minLength": 1, "maxLength": 500 }, "observed_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "freshness_basis": { "type": "string", "enum": [ "CURRENT_OBSERVED", "CACHED_OBSERVED", "UNKNOWN" ] }, "period_start": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ] }, "period_end": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ] } }, "required": [ "name", "value", "unit", "semantics", "definition", "scope", "observed_at", "period_start", "period_end" ], "additionalProperties": false } } }, "required": [ "observation_id", "source", "observed_at", "metrics" ], "additionalProperties": false } }, "limitations": { "minItems": 1, "maxItems": 10, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 500 } } }, "required": [ "status", "first_retained_observed_at", "last_retained_observed_at", "requested_baseline_at", "baseline_observation_id", "snapshots", "limitations" ], "additionalProperties": false }, "entity": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" }, "platform": { "type": "string", "enum": [ "TIKTOK", "YOUTUBE", "INSTAGRAM", "FACEBOOK", "X", "REDDIT", "GOOGLE", "BING", "AI_SEARCH", "WEB", "FORUM", "GITHUB" ] }, "native_id": { "type": "string", "minLength": 1, "maxLength": 180 }, "original_url": { "anyOf": [ { "type": "string", "maxLength": 2048, "format": "uri" }, { "type": "null" } ] }, "creator": { "anyOf": [ { "type": "object", "properties": { "native_id": { "anyOf": [ { "type": "string", "maxLength": 180 }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "maxLength": 180 }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string", "maxLength": 2048, "format": "uri" }, { "type": "null" } ] } }, "required": [ "native_id", "name", "url" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "id", "platform", "native_id", "original_url", "creator" ], "additionalProperties": false }, "content_type": { "type": "string", "enum": [ "VIDEO", "CONVERSATION", "SEARCH", "ARTICLE" ] }, "current_observation": { "type": "object", "properties": { "version": { "type": "string", "const": "trend-index-observation-v3" }, "id": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" }, "entity": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" }, "platform": { "type": "string", "enum": [ "TIKTOK", "YOUTUBE", "INSTAGRAM", "FACEBOOK", "X", "REDDIT", "GOOGLE", "BING", "AI_SEARCH", "WEB", "FORUM", "GITHUB" ] }, "native_id": { "type": "string", "minLength": 1, "maxLength": 180 }, "original_url": { "anyOf": [ { "type": "string", "maxLength": 2048, "format": "uri" }, { "type": "null" } ] }, "creator": { "anyOf": [ { "type": "object", "properties": { "native_id": { "anyOf": [ { "type": "string", "maxLength": 180 }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "maxLength": 180 }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string", "maxLength": 2048, "format": "uri" }, { "type": "null" } ] } }, "required": [ "native_id", "name", "url" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "id", "platform", "native_id", "original_url", "creator" ], "additionalProperties": false }, "collection_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "rights_receipt_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "source": { "type": "string", "minLength": 1, "maxLength": 500 }, "origin": { "type": "string", "enum": [ "PUBLIC_INDEX", "FIXTURE" ] }, "content_type": { "type": "string", "enum": [ "VIDEO", "CONVERSATION", "SEARCH", "ARTICLE" ] }, "title": { "anyOf": [ { "type": "string", "maxLength": 500 }, { "type": "null" } ] }, "excerpt": { "anyOf": [ { "type": "string", "maxLength": 2000 }, { "type": "null" } ] }, "published_at": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ] }, "observed_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "expires_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "language": { "anyOf": [ { "type": "string", "maxLength": 20 }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string", "pattern": "^[A-Z]{2}$" }, { "type": "null" } ] }, "region": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ] }, "observed_market": { "default": null, "anyOf": [ { "type": "string", "pattern": "^[A-Z]{2}$" }, { "type": "null" } ] }, "categories": { "maxItems": 10, "type": "array", "items": { "type": "string", "enum": [ "COFFEE_BREWING", "CONTENT_CREATION", "CUSTOMER_DISCOVERY", "SOFTWARE_DEVELOPMENT", "PRODUCTIVITY", "FITNESS", "GARDENING", "COOKING", "SKINCARE", "TRAVEL", "AI", "ECOMMERCE", "FINANCE", "EDUCATION", "ENTERTAINMENT", "SUSTAINABILITY", "MARKETING", "SALES", "HEALTHCARE", "HEALTH_WELLNESS", "HOME_SERVICES", "REAL_ESTATE", "FASHION", "BEAUTY", "PETS", "GAMING", "PARENTING", "AUTOMOTIVE", "LEGAL", "RESTAURANTS", "SPORTS", "CRYPTO", "CAREERS", "HOME_DECOR", "WEDDINGS", "OUTDOORS", "PHOTOGRAPHY", "CRAFTS_DIY", "CYBERSECURITY", "NONPROFIT", "MUSIC_CREATION", "DRINKS", "GENERAL" ] } }, "metrics": { "maxItems": 24, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "views", "likes", "comments", "shares", "saves", "followers", "relative_interest", "estimated_monthly_demand", "points", "score", "reposts", "quotes", "reactions", "rising_percent", "thumbs_up" ] }, "value": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "unit": { "type": "string", "enum": [ "COUNT", "INDEX", "MODELED_MONTHLY_COUNT", "PERCENT" ] }, "semantics": { "type": "string", "enum": [ "CUMULATIVE_COUNTER", "WINDOW_VALUE", "MODELED_ESTIMATE" ] }, "definition": { "type": "string", "minLength": 1, "maxLength": 500 }, "scope": { "type": "string", "minLength": 1, "maxLength": 500 }, "observed_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "freshness_basis": { "type": "string", "enum": [ "CURRENT_OBSERVED", "CACHED_OBSERVED", "UNKNOWN" ] }, "period_start": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ] }, "period_end": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ] } }, "required": [ "name", "value", "unit", "semantics", "definition", "scope", "observed_at", "period_start", "period_end" ], "additionalProperties": false } }, "video": { "anyOf": [ { "type": "object", "properties": { "duration_seconds": { "anyOf": [ { "type": "number", "exclusiveMinimum": 0, "maximum": 86400 }, { "type": "null" } ] }, "format": { "type": "object", "properties": { "value": { "anyOf": [ { "type": "string", "maxLength": 1000 }, { "type": "null" } ] }, "basis": { "type": "string", "enum": [ "METADATA", "PERMITTED_TEXT", "TRANSCRIPT", "INSPECTED_FRAMES", "INSPECTED_AUDIO", "UNKNOWN" ] }, "evidence_ids": { "maxItems": 60, "type": "array", "items": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" } } }, "required": [ "value", "basis", "evidence_ids" ], "additionalProperties": false }, "hook": { "type": "object", "properties": { "value": { "anyOf": [ { "type": "string", "maxLength": 1000 }, { "type": "null" } ] }, "basis": { "type": "string", "enum": [ "METADATA", "PERMITTED_TEXT", "TRANSCRIPT", "INSPECTED_FRAMES", "INSPECTED_AUDIO", "UNKNOWN" ] }, "evidence_ids": { "maxItems": 60, "type": "array", "items": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" } } }, "required": [ "value", "basis", "evidence_ids" ], "additionalProperties": false }, "visual_narrative": { "type": "object", "properties": { "value": { "anyOf": [ { "type": "string", "maxLength": 1000 }, { "type": "null" } ] }, "basis": { "type": "string", "enum": [ "METADATA", "PERMITTED_TEXT", "TRANSCRIPT", "INSPECTED_FRAMES", "INSPECTED_AUDIO", "UNKNOWN" ] }, "evidence_ids": { "maxItems": 60, "type": "array", "items": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" } } }, "required": [ "value", "basis", "evidence_ids" ], "additionalProperties": false }, "media_analysis": { "type": "object", "properties": { "state": { "type": "string", "enum": [ "NOT_ANALYZED", "METADATA_ONLY", "TRANSCRIPT_ONLY", "FRAMES_INSPECTED", "AUDIOVISUAL_INSPECTED" ] }, "version": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 500 }, { "type": "null" } ] }, "source_fingerprint": { "anyOf": [ { "type": "string", "pattern": "^[a-f0-9]{64}$" }, { "type": "null" } ] }, "analyzed_at": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ] }, "evidence_ids": { "maxItems": 60, "type": "array", "items": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" } }, "inspected_intervals": { "maxItems": 60, "type": "array", "items": { "type": "object", "properties": { "from_seconds": { "type": "number", "minimum": 0 }, "to_seconds": { "type": "number", "exclusiveMinimum": 0 } }, "required": [ "from_seconds", "to_seconds" ], "additionalProperties": false } }, "audio_inspected": { "type": "boolean" }, "limitations": { "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 500 } } }, "required": [ "state", "version", "source_fingerprint", "analyzed_at", "evidence_ids", "inspected_intervals", "audio_inspected", "limitations" ], "additionalProperties": false } }, "required": [ "duration_seconds", "format", "hook", "visual_narrative", "media_analysis" ], "additionalProperties": false }, { "type": "null" } ] }, "conversation": { "anyOf": [ { "type": "object", "properties": { "community": { "anyOf": [ { "type": "string", "maxLength": 180 }, { "type": "null" } ] }, "root_native_id": { "anyOf": [ { "type": "string", "maxLength": 180 }, { "type": "null" } ] }, "parent_native_id": { "anyOf": [ { "type": "string", "maxLength": 180 }, { "type": "null" } ] }, "thread_context": { "maxItems": 12, "type": "array", "items": { "type": "object", "properties": { "native_id": { "type": "string", "minLength": 1, "maxLength": 180 }, "parent_native_id": { "anyOf": [ { "type": "string", "maxLength": 180 }, { "type": "null" } ] }, "original_url": { "type": "string", "maxLength": 2048, "format": "uri" }, "excerpt": { "anyOf": [ { "type": "string", "maxLength": 2000 }, { "type": "null" } ] }, "published_at": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ] } }, "required": [ "native_id", "parent_native_id", "original_url", "excerpt", "published_at" ], "additionalProperties": false } }, "question": { "type": "object", "properties": { "value": { "anyOf": [ { "type": "string", "maxLength": 1000 }, { "type": "null" } ] }, "basis": { "type": "string", "enum": [ "METADATA", "PERMITTED_TEXT", "TRANSCRIPT", "INSPECTED_FRAMES", "INSPECTED_AUDIO", "UNKNOWN" ] }, "evidence_ids": { "maxItems": 60, "type": "array", "items": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" } } }, "required": [ "value", "basis", "evidence_ids" ], "additionalProperties": false }, "problem": { "type": "object", "properties": { "value": { "anyOf": [ { "type": "string", "maxLength": 1000 }, { "type": "null" } ] }, "basis": { "type": "string", "enum": [ "METADATA", "PERMITTED_TEXT", "TRANSCRIPT", "INSPECTED_FRAMES", "INSPECTED_AUDIO", "UNKNOWN" ] }, "evidence_ids": { "maxItems": 60, "type": "array", "items": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" } } }, "required": [ "value", "basis", "evidence_ids" ], "additionalProperties": false }, "access": { "type": "string", "enum": [ "PUBLIC_OBSERVED", "UNKNOWN", "RESTRICTED", "REVOKED" ] }, "rules": { "anyOf": [ { "type": "object", "properties": { "receipt_id": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" }, "url": { "type": "string", "maxLength": 2048, "format": "uri" }, "observed_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "expires_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "text": { "anyOf": [ { "type": "string", "maxLength": 4000 }, { "type": "null" } ] }, "posting_permission": { "type": "string", "const": "NOT_GRANTED" } }, "required": [ "receipt_id", "url", "observed_at", "expires_at", "text", "posting_permission" ], "additionalProperties": false }, { "type": "null" } ] }, "destination_state": { "type": "string", "enum": [ "OPEN_OBSERVED", "CLOSED", "UNKNOWN" ] }, "posting_permission": { "type": "string", "const": "NOT_GRANTED" } }, "required": [ "community", "root_native_id", "parent_native_id", "thread_context", "question", "problem", "access", "rules", "destination_state", "posting_permission" ], "additionalProperties": false }, { "type": "null" } ] }, "search": { "anyOf": [ { "type": "object", "properties": { "query": { "type": "string", "minLength": 1, "maxLength": 180 }, "market": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ] }, "language": { "anyOf": [ { "type": "string", "maxLength": 20 }, { "type": "null" } ] }, "methodology": { "type": "string", "minLength": 1, "maxLength": 500 }, "measurement_kind": { "type": "string", "enum": [ "RELATIVE_INTEREST", "MODELED_MONTHLY_DEMAND", "ORGANIC_VISIBILITY", "AI_CITATION", "AI_BRAND_MENTION", "RETRIEVED_REFERENCE", "FINAL_CITATION" ] }, "reference_kind": { "type": "string", "enum": [ "ORIGINAL_SOURCE", "PROVIDER_CHECK_URL", "METHODOLOGY_REFERENCE" ] }, "reference_url": { "type": "string", "maxLength": 2048, "format": "uri" }, "provider": { "type": "string", "minLength": 1, "maxLength": 500 }, "provider_interface": { "type": "string", "minLength": 1, "maxLength": 500 }, "model": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 500 }, { "type": "null" } ] }, "reported_series": { "oneOf": [ { "type": "object", "properties": { "version": { "type": "string", "const": "search-reported-series-v3" }, "kind": { "type": "string", "const": "RELATIVE_INTEREST" }, "normalization": { "type": "string", "const": "WITHIN_RESPONSE_RELATIVE_INDEX" }, "reported_point_count": { "type": "integer", "minimum": 1, "maximum": 1000 }, "omitted_point_count": { "type": "integer", "minimum": 0, "maximum": 1000 }, "points": { "minItems": 1, "maxItems": 31, "type": "array", "items": { "type": "object", "properties": { "at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "value": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 100 }, { "type": "null" } ] }, "date_from": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "date_to": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" } }, "required": [ "at", "value" ], "additionalProperties": false } } }, "required": [ "version", "kind", "normalization", "reported_point_count", "omitted_point_count", "points" ], "additionalProperties": false }, { "type": "object", "properties": { "version": { "type": "string", "const": "search-reported-series-v3" }, "kind": { "type": "string", "const": "MODELED_MONTHLY_DEMAND" }, "methodology": { "type": "string", "const": "PAA_DERIVED_MODELED_ESTIMATE" }, "current_estimated_volume": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "monthly_history": { "maxItems": 12, "type": "array", "items": { "type": "object", "properties": { "year": { "type": "integer", "minimum": 2000, "maximum": 2100 }, "month": { "type": "integer", "minimum": 1, "maximum": 12 }, "estimated_volume": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "year", "month", "estimated_volume" ], "additionalProperties": false } } }, "required": [ "version", "kind", "methodology", "current_estimated_volume", "monthly_history" ], "additionalProperties": false } ] } }, "required": [ "query", "market", "language", "methodology", "measurement_kind" ], "additionalProperties": false }, { "type": "null" } ] }, "evidence_quality": { "type": "string", "enum": [ "ATTRIBUTED_METADATA", "PERMITTED_TEXT", "INSPECTED_MEDIA" ] }, "limitations": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 500 } } }, "required": [ "version", "id", "entity", "collection_id", "rights_receipt_id", "source", "origin", "content_type", "title", "excerpt", "published_at", "observed_at", "expires_at", "language", "country", "region", "observed_market", "categories", "metrics", "video", "conversation", "search", "evidence_quality", "limitations" ], "additionalProperties": false }, "observation_ids": { "minItems": 1, "maxItems": 24, "type": "array", "items": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" } }, "signal": { "type": "string", "enum": [ "POPULAR_NOW", "RISING", "EMERGING", "RECURRING_PROBLEM", "SEARCH_INTEREST", "CREATIVE_PATTERN", "NEW_DEVELOPMENT", "INSUFFICIENT_EVIDENCE" ] }, "signal_basis": { "type": "string", "minLength": 1, "maxLength": 500 }, "measured_growth": { "type": "string", "enum": [ "INCREASING_OBSERVED", "DECREASING_OBSERVED", "UNCHANGED_OBSERVED", "NOT_COMPARABLE" ] }, "growth": { "maxItems": 24, "type": "array", "items": { "type": "object", "properties": { "metric": { "type": "string" }, "baseline_observation_id": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" }, "current_observation_id": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" }, "from": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "to": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "previous_value": { "type": "number" }, "current_value": { "type": "number" }, "absolute_change": { "type": "number" }, "percent_change": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "per_hour": { "type": "number" }, "basis": { "type": "string", "const": "COMPARABLE_RETAINED_SNAPSHOTS" } }, "required": [ "metric", "baseline_observation_id", "current_observation_id", "from", "to", "previous_value", "current_value", "absolute_change", "percent_change", "per_hour", "basis" ], "additionalProperties": false } }, "virality": { "type": "string", "const": "NOT_ESTABLISHED" }, "ring": { "type": "string", "enum": [ "CORE", "ADJACENT", "GLOBAL" ] }, "relevance": { "type": "object", "properties": { "basis": { "type": "string", "const": "CONTROLLED_DOMAIN_FAMILIES_AND_TOKEN_MATCH" }, "score": { "type": "number", "minimum": 0, "maximum": 1 }, "matched_fields": { "type": "array", "items": { "type": "string", "enum": [ "description", "topic", "problem", "audience", "exclusion", "capability", "job", "industry", "product_category", "customer_interest", "competitor", "adjacent_category", "market", "language", "platform", "community", "competitor_handle", "competitor_domain", "keyword" ] } }, "matched_categories": { "type": "array", "items": { "type": "string", "enum": [ "COFFEE_BREWING", "CONTENT_CREATION", "CUSTOMER_DISCOVERY", "SOFTWARE_DEVELOPMENT", "PRODUCTIVITY", "FITNESS", "GARDENING", "COOKING", "SKINCARE", "TRAVEL", "AI", "ECOMMERCE", "FINANCE", "EDUCATION", "ENTERTAINMENT", "SUSTAINABILITY", "MARKETING", "SALES", "HEALTHCARE", "HEALTH_WELLNESS", "HOME_SERVICES", "REAL_ESTATE", "FASHION", "BEAUTY", "PETS", "GAMING", "PARENTING", "AUTOMOTIVE", "LEGAL", "RESTAURANTS", "SPORTS", "CRYPTO", "CAREERS", "HOME_DECOR", "WEDDINGS", "OUTDOORS", "PHOTOGRAPHY", "CRAFTS_DIY", "CYBERSECURITY", "NONPROFIT", "MUSIC_CREATION", "DRINKS", "GENERAL" ] } }, "product_fit": { "type": "string", "const": "REVIEW_REQUIRED" }, "explanation": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "basis", "score", "matched_fields", "matched_categories", "product_fit", "explanation" ], "additionalProperties": false }, "freshness": { "type": "string", "enum": [ "CURRENT_DATED_REFERENCE", "BACKGROUND_REFERENCE", "UNDATED_REFERENCE", "MODELED_PERIOD_NOT_CURRENT_MOMENTUM" ] }, "limitations": { "minItems": 1, "maxItems": 30, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 500 } }, "guidance": { "type": "object", "properties": { "evidence_class": { "type": "string", "enum": [ "TREND_SIGNAL", "AUDIENCE_EVIDENCE", "CREATIVE_EXAMPLE", "SEARCH_DEMAND", "COMPETITOR_ACTIVITY", "REFERENCE_ONLY" ] }, "uses": { "maxItems": 6, "type": "array", "items": { "type": "object", "properties": { "use": { "type": "string", "enum": [ "POST_TOPIC", "DISCUSSION_TO_READ", "CUSTOMER_PROBLEM", "FEATURE_INPUT", "VIDEO_TOPIC", "TITLE_REFERENCE", "FORMAT_REFERENCE", "HOOK_REFERENCE", "SEARCH_KEYWORD", "COMPETITOR_WATCH", "BACKGROUND_ONLY" ] }, "channels": { "maxItems": 10, "type": "array", "items": { "type": "string", "enum": [ "X", "REDDIT", "HACKER_NEWS", "LINKEDIN", "YOUTUBE", "TIKTOK", "INSTAGRAM", "FACEBOOK", "BLOG", "SEO_GEO" ] } }, "note": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "use", "channels", "note" ], "additionalProperties": false } }, "caution": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "evidence_class", "uses", "caution" ], "additionalProperties": false }, "topic_history": { "anyOf": [ { "type": "object", "properties": { "topic_key": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" }, "state": { "type": "string", "enum": [ "EMERGING", "RISING", "PEAKING", "DECLINING", "EVERGREEN" ] }, "since": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "first_seen": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "peak_day": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "channels": { "type": "integer", "minimum": 0, "maximum": 32 }, "velocity": { "anyOf": [ { "type": "number", "minimum": -1 }, { "type": "null" } ] }, "as_of": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "method_version": { "type": "string", "pattern": "^[a-z][a-z0-9-]{2,39}$" }, "series_method_version": { "type": "string", "pattern": "^[a-z][a-z0-9-]{2,39}$" } }, "required": [ "topic_key", "state", "since", "first_seen", "peak_day", "channels", "velocity", "as_of", "method_version", "series_method_version" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "id", "cluster_id", "entity", "content_type", "current_observation", "observation_ids", "signal", "signal_basis", "measured_growth", "growth", "virality", "ring", "relevance", "freshness", "limitations" ], "additionalProperties": false } }, "coverage": { "maxItems": 200, "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string", "minLength": 1, "maxLength": 500 }, "platform": { "type": "string", "enum": [ "TIKTOK", "YOUTUBE", "INSTAGRAM", "FACEBOOK", "X", "REDDIT", "GOOGLE", "BING", "AI_SEARCH", "WEB", "FORUM", "GITHUB" ] }, "status": { "type": "string", "enum": [ "OBSERVATIONS_AVAILABLE", "COLLECTED_EMPTY", "OUTCOME_UNKNOWN", "NOT_COLLECTED", "RIGHTS_UNAVAILABLE" ] }, "last_observed_at": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ] }, "observation_count": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "limitations": { "minItems": 1, "maxItems": 10, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 500 } } }, "required": [ "source", "platform", "status", "last_observed_at", "observation_count", "limitations" ], "additionalProperties": false } }, "excluded_count": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "truncated": { "type": "boolean" }, "history_status": { "type": "string", "enum": [ "OBSERVATIONS_AVAILABLE", "NOT_OBSERVED" ] }, "new_research": { "type": "boolean" }, "limitations": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 500 } }, "brief": { "type": "object", "properties": { "version": { "type": "string", "const": "trend-brief-v3" }, "headline": { "type": "string", "minLength": 1, "maxLength": 600 }, "sections": { "maxItems": 6, "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "enum": [ "TRENDING_NOW", "AUDIENCE_CONVERSATIONS", "CREATIVE_REFERENCES", "SEARCH_DEMAND", "COMPETITOR_ACTIVITY", "REFERENCES" ] }, "status": { "type": "string", "enum": [ "AVAILABLE", "EMPTY", "NOT_COLLECTED", "NEEDS_CONTEXT" ] }, "count": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "item_ids": { "maxItems": 20, "type": "array", "items": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{2,95}$" } }, "note": { "type": "string", "minLength": 1, "maxLength": 600 } }, "required": [ "key", "status", "count", "item_ids", "note" ], "additionalProperties": false } }, "sources": { "maxItems": 40, "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string", "minLength": 1, "maxLength": 500 }, "platform": { "type": "string", "enum": [ "TIKTOK", "YOUTUBE", "INSTAGRAM", "FACEBOOK", "X", "REDDIT", "GOOGLE", "BING", "AI_SEARCH", "WEB", "FORUM", "GITHUB" ] }, "items": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "markets": { "maxItems": 40, "type": "array", "items": { "type": "string", "pattern": "^[A-Z]{2}$" } } }, "required": [ "source", "platform", "items", "markets" ], "additionalProperties": false } }, "coverage_gaps": { "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "platform": { "type": "string", "enum": [ "TIKTOK", "YOUTUBE", "INSTAGRAM", "FACEBOOK", "X", "REDDIT", "GOOGLE", "BING", "AI_SEARCH", "WEB", "FORUM", "GITHUB" ] }, "note": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "platform", "note" ], "additionalProperties": false } }, "next_steps": { "maxItems": 8, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 600 } } }, "required": [ "version", "headline", "sections", "sources", "coverage_gaps", "next_steps" ], "additionalProperties": false }, "ai_answers": { "type": "object", "properties": { "provider": { "type": "string", "const": "DataForSEO LLM Responses" }, "asked": { "type": "integer", "minimum": 0, "maximum": 12 }, "answers": { "maxItems": 12, "type": "array", "items": { "type": "object", "properties": { "platform": { "type": "string", "enum": [ "CHATGPT", "PERPLEXITY", "GEMINI", "CLAUDE" ] }, "model": { "type": "string", "minLength": 1, "maxLength": 100 }, "category": { "type": "string", "enum": [ "COFFEE_BREWING", "CONTENT_CREATION", "CUSTOMER_DISCOVERY", "SOFTWARE_DEVELOPMENT", "PRODUCTIVITY", "FITNESS", "GARDENING", "COOKING", "SKINCARE", "TRAVEL", "AI", "ECOMMERCE", "FINANCE", "EDUCATION", "ENTERTAINMENT", "SUSTAINABILITY", "MARKETING", "SALES", "HEALTHCARE", "HEALTH_WELLNESS", "HOME_SERVICES", "REAL_ESTATE", "FASHION", "BEAUTY", "PETS", "GAMING", "PARENTING", "AUTOMOTIVE", "LEGAL", "RESTAURANTS", "SPORTS", "CRYPTO", "CAREERS", "HOME_DECOR", "WEDDINGS", "OUTDOORS", "PHOTOGRAPHY", "CRAFTS_DIY", "CYBERSECURITY", "NONPROFIT", "MUSIC_CREATION", "DRINKS", "GENERAL" ] }, "question": { "type": "string", "minLength": 1, "maxLength": 500 }, "answered_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "mentions_you": { "type": "boolean" }, "competitors_named": { "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "names": { "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 120 } }, "cited_domains": { "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 253 } }, "excerpt": { "anyOf": [ { "type": "string", "maxLength": 1500 }, { "type": "null" } ] } }, "required": [ "platform", "model", "category", "question", "answered_at", "mentions_you", "competitors_named", "names", "cited_domains", "excerpt" ], "additionalProperties": false } }, "limitations": { "minItems": 1, "maxItems": 10, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 500 } } }, "required": [ "provider", "asked", "answers", "limitations" ], "additionalProperties": false }, "communities": { "maxItems": 5, "type": "array", "items": { "type": "object", "properties": { "version": { "type": "string", "const": "community-profile-v3" }, "platform": { "type": "string", "const": "REDDIT" }, "community": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9_]{1,20}$" }, "url": { "type": "string", "maxLength": 2048, "format": "uri" }, "status": { "type": "string", "enum": [ "PROFILED", "NOT_FOUND", "UNAVAILABLE" ] }, "observed_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "rules_observed_at": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ] }, "weekly_active_users": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "weekly_contributions": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "maxLength": 500 }, { "type": "null" } ] }, "rules": { "maxItems": 25, "type": "array", "items": { "type": "object", "properties": { "number": { "type": "integer", "minimum": 1, "maximum": 40 }, "title": { "type": "string", "minLength": 1, "maxLength": 200 }, "text": { "type": "string", "maxLength": 600 }, "source": { "type": "string", "enum": [ "RULES", "GUIDELINES" ] } }, "required": [ "number", "title", "text", "source" ], "additionalProperties": false } }, "posting": { "type": "object", "properties": { "self_promotion": { "type": "object", "properties": { "policy": { "type": "string", "enum": [ "ALLOWED", "RESTRICTED", "NOT_ALLOWED", "UNKNOWN" ] }, "rules": { "maxItems": 10, "type": "array", "items": { "type": "integer", "minimum": 1, "maximum": 40 } } }, "required": [ "policy", "rules" ], "additionalProperties": false }, "links": { "type": "object", "properties": { "policy": { "type": "string", "enum": [ "ALLOWED", "RESTRICTED", "NOT_ALLOWED", "UNKNOWN" ] }, "rules": { "maxItems": 10, "type": "array", "items": { "type": "integer", "minimum": 1, "maximum": 40 } } }, "required": [ "policy", "rules" ], "additionalProperties": false }, "ai_content": { "type": "object", "properties": { "policy": { "type": "string", "enum": [ "ALLOWED", "RESTRICTED", "NOT_ALLOWED", "UNKNOWN" ] }, "rules": { "maxItems": 10, "type": "array", "items": { "type": "integer", "minimum": 1, "maximum": 40 } } }, "required": [ "policy", "rules" ], "additionalProperties": false }, "flair_required": { "type": "object", "properties": { "required": { "type": "boolean" }, "rules": { "maxItems": 10, "type": "array", "items": { "type": "integer", "minimum": 1, "maximum": 40 } } }, "required": [ "required", "rules" ], "additionalProperties": false }, "account_requirements": { "type": "object", "properties": { "stated": { "type": "boolean" }, "rules": { "maxItems": 10, "type": "array", "items": { "type": "integer", "minimum": 1, "maximum": 40 } } }, "required": [ "stated", "rules" ], "additionalProperties": false }, "promotion_venue": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 120 }, { "type": "null" } ] } }, "required": [ "self_promotion", "links", "ai_content", "flair_required", "account_requirements", "promotion_venue" ], "additionalProperties": false }, "culture": { "type": "object", "properties": { "sampled_posts": { "type": "integer", "minimum": 0, "maximum": 100 }, "text_post_share": { "anyOf": [ { "type": "number", "minimum": 0, "maximum": 1 }, { "type": "null" } ] }, "formats": { "maxItems": 7, "type": "array", "items": { "type": "object", "properties": { "format": { "type": "string", "enum": [ "QUESTION", "STORY", "SHOWCASE", "GUIDE", "DISCUSSION", "LINK", "MEDIA" ] }, "share": { "type": "number", "minimum": 0, "maximum": 1 } }, "required": [ "format", "share" ], "additionalProperties": false } }, "median_score": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "median_comments": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "top_flairs": { "maxItems": 5, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 64 } }, "moderator_posts": { "type": "integer", "minimum": 0, "maximum": 100 } }, "required": [ "sampled_posts", "text_post_share", "formats", "median_score", "median_comments", "top_flairs", "moderator_posts", "examples" ], "additionalProperties": false }, "all_time_top": { "anyOf": [ { "type": "object", "properties": { "posts": { "maxItems": 5, "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 300 }, "url": { "type": "string", "maxLength": 2048, "format": "uri" }, "kind": { "type": "string", "enum": [ "TEXT", "IMAGE", "VIDEO", "GALLERY", "LINK" ] }, "format": { "type": "string", "enum": [ "QUESTION", "STORY", "SHOWCASE", "GUIDE", "DISCUSSION", "LINK", "MEDIA" ] }, "score": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "comments": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "posted_at": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ] }, "words": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 100000 }, { "type": "null" } ] }, "structure": { "anyOf": [ { "type": "string", "enum": [ "PROSE", "LIST", "SECTIONS" ] }, { "type": "null" } ] }, "links_out": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, "required": [ "title", "url", "kind", "format", "score", "comments", "posted_at", "words", "structure", "links_out" ], "additionalProperties": false } }, "pattern": { "maxItems": 3, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 500 } } }, "required": [ "posts", "pattern" ], "additionalProperties": false }, { "type": "null" } ] }, "community_posts": { "maxItems": 3, "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 300 }, "url": { "type": "string", "maxLength": 2048, "format": "uri" }, "text": { "type": "string", "maxLength": 1200 }, "pinned": { "type": "boolean" }, "posted_at": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ] } }, "required": [ "title", "url", "text", "pinned", "posted_at" ], "additionalProperties": false } }, "format_analysis": { "anyOf": [ { "type": "object", "properties": { "version": { "type": "string", "const": "community-format-v1" }, "model": { "type": "string", "const": "claude-sonnet-5-5" }, "analyzed_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "based_on": { "minItems": 1, "maxItems": 5, "type": "array", "items": { "type": "string", "maxLength": 2048, "format": "uri" } }, "summary": { "type": "string", "minLength": 1, "maxLength": 400 }, "hook": { "type": "string", "minLength": 1, "maxLength": 400 }, "structure": { "type": "string", "minLength": 1, "maxLength": 400 }, "length": { "type": "string", "minLength": 1, "maxLength": 400 }, "proof": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 400 }, { "type": "null" } ] }, "product_mention": { "type": "string", "minLength": 1, "maxLength": 400 }, "avoid": { "maxItems": 3, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 400 } }, "cost_usd": { "type": "number", "minimum": 0, "maximum": 1 } }, "required": [ "version", "model", "analyzed_at", "based_on", "summary", "hook", "structure", "length", "proof", "product_mention", "avoid", "cost_usd" ], "additionalProperties": false }, { "type": "null" } ] }, "play": { "minItems": 1, "maxItems": 7, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 500 } }, "limitations": { "minItems": 1, "maxItems": 8, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 500 } } }, "required": [ "version", "platform", "community", "url", "status", "observed_at", "rules_observed_at", "weekly_active_users", "weekly_contributions", "description", "rules", "posting", "culture", "play", "limitations" ], "additionalProperties": false } } }, "required": [ "version", "snapshot_id", "as_of", "read_at", "classification_as_of", "classification_window", "context", "items", "coverage", "excluded_count", "truncated", "new_research", "limitations" ], "additionalProperties": false } } }