{"openapi":"3.1.0","info":{"title":"Zeitwire Public Evidence API","version":"1.0.0","description":"Read-only, citation-ready evidence from curated tech discourse, including tweets, topics, articles, historical days, agent context bundles, and Trending Now story snapshots.","contact":{"name":"Zeitwire","url":"https://wire.indiethinkers.com/contact","email":"daniel@indiethinkers.com"},"license":{"name":"MIT","identifier":"MIT"}},"servers":[{"url":"https://wire.indiethinkers.com","description":"Public production API"}],"externalDocs":{"description":"Evidence for Agents","url":"https://wire.indiethinkers.com/agents"},"tags":[{"name":"Agent evidence","description":"Purpose-built context for AI agents."},{"name":"Public sources","description":"Underlying read-only evidence collections."},{"name":"Trends","description":"Tracked-graph and official-X trend explorer APIs."},{"name":"Stories","description":"Compiled story board and briefs."}],"security":[],"paths":{"/api/command/tweets-by-date":{"get":{"operationId":"listTweetsByDate","summary":"List ranked tweets for a day","description":"Returns the ranked command-center tweet stream for the latest window or a calendar day.","tags":["Public sources"],"parameters":[{"name":"date","in":"query","required":false,"description":"latest, today, yesterday, or an ISO calendar date.","schema":{"type":"string","oneOf":[{"type":"string","enum":["latest","today","yesterday"]},{"type":"string","format":"date"}],"default":"today"}},{"name":"limit","in":"query","required":false,"description":"Maximum number of tweets.","schema":{"type":"integer","default":10,"minimum":1,"maximum":50}},{"name":"topic","in":"query","required":false,"description":"Optional topic filter.","schema":{"type":"string","maxLength":120,"pattern":"^[a-zA-Z0-9+#._ /-]{1,120}$"}},{"name":"tz","in":"query","required":false,"description":"IANA timezone used to interpret calendar dates.","schema":{"type":"string","default":"UTC","maxLength":64,"examples":["UTC","America/Los_Angeles"]}}],"responses":{"200":{"description":"A ranked collection of published tweets.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LatestTweetCollection"}}}},"400":{"description":"The request parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"405":{"description":"The HTTP method is not supported by this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Allow":{"description":"HTTP methods accepted by this operation path.","schema":{"type":"string"}}}},"429":{"description":"The public rate limit has been exceeded.","headers":{"Retry-After":{"description":"Seconds until the client may retry.","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"The service could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"The read model is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/command/streams":{"get":{"operationId":"listCategoryStream","summary":"List a category stream","description":"Returns recent ranked tweets matching one command-center category and optional topic.","tags":["Public sources"],"parameters":[{"name":"category","in":"query","required":false,"description":"Command-center category.","schema":{"type":"string","enum":["ai-ml","startups","coding","product","platform"],"default":"ai-ml"}},{"name":"limit","in":"query","required":false,"description":"Maximum number of tweets.","schema":{"type":"integer","default":10,"minimum":1,"maximum":50}},{"name":"topic","in":"query","required":false,"description":"Optional topic filter.","schema":{"type":"string","maxLength":120}}],"responses":{"200":{"description":"A ranked collection of published tweets.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountedTweetCollection"}}}},"400":{"description":"The request parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"405":{"description":"The HTTP method is not supported by this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Allow":{"description":"HTTP methods accepted by this operation path.","schema":{"type":"string"}}}},"500":{"description":"The service could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/command/hot-takes":{"get":{"operationId":"listHotDiscussions","summary":"List reply-heavy discussions","description":"Returns recent, high-visibility tweets ranked by discussion activity.","tags":["Public sources"],"responses":{"200":{"description":"Reply-heavy published tweets.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HotTakeCollection"}}}},"405":{"description":"The HTTP method is not supported by this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Allow":{"description":"HTTP methods accepted by this operation path.","schema":{"type":"string"}}}},"500":{"description":"The service could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/tweets/trending":{"get":{"operationId":"listTrendingTweets","summary":"List trending tweets","description":"Returns quality-ranked published tweets with bounded shallow pagination.","tags":["Public sources"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Maximum number of tweets.","schema":{"type":"integer","default":20,"minimum":1,"maximum":50}},{"name":"offset","in":"query","required":false,"description":"Shallow result offset.","schema":{"type":"integer","default":0,"minimum":0,"maximum":100}}],"responses":{"200":{"description":"Trending published tweets.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrendingTweetCollection"}}}},"400":{"description":"The request parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"405":{"description":"The HTTP method is not supported by this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Allow":{"description":"HTTP methods accepted by this operation path.","schema":{"type":"string"}}}},"500":{"description":"The service could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/articles":{"get":{"operationId":"listArticles","summary":"List long-form articles","description":"Returns published long-form article rows using a bounded keyset cursor.","tags":["Public sources"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Maximum number of articles.","schema":{"type":"integer","default":20,"minimum":1,"maximum":50}},{"name":"cursor","in":"query","required":false,"description":"Opaque cursor from the previous page.","schema":{"type":"string","maxLength":1024,"pattern":"^[A-Za-z0-9_-]+$"}}],"responses":{"200":{"description":"Published long-form articles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArticleCollection"}}}},"400":{"description":"The request parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"405":{"description":"The HTTP method is not supported by this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Allow":{"description":"HTTP methods accepted by this operation path.","schema":{"type":"string"}}}},"500":{"description":"The service could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/time-travel/{date}":{"get":{"operationId":"getTimeTravelDay","summary":"Get one historical day","description":"Returns the quality-ranked Time Travel read model for one valid ISO calendar day.","tags":["Public sources"],"parameters":[{"name":"date","in":"path","required":true,"description":"ISO calendar date within the Time Travel archive.","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Maximum number of tweets.","schema":{"type":"integer","default":20,"minimum":1,"maximum":50}}],"responses":{"200":{"description":"A historical day and its published tweets.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeTravelDay"}}}},"400":{"description":"The request parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"The date is outside the available archive.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"405":{"description":"The HTTP method is not supported by this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Allow":{"description":"HTTP methods accepted by this operation path.","schema":{"type":"string"}}}},"429":{"description":"The public rate limit has been exceeded.","headers":{"Retry-After":{"description":"Seconds until the client may retry.","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"The service could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"The read model is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}}},"components":{"schemas":{"JudgeRequest":{"type":"object","properties":{"tweetId":{"type":"string","format":"uuid","description":"Published Zeitwire record UUID, not an X status ID."}},"required":["tweetId"],"additionalProperties":false},"JudgeRubric":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Whether POST evaluation is configured. Metadata remains available when false."},"questionSetVersion":{"type":"integer","minimum":0},"categories":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","enum":["analysis","opinion","news","education","pain_point","hype","promotion","reaction","discussion","unclear"]},"label":{"type":"string"},"description":{"type":"string"}},"required":["id","label","description"]}},"substanceScale":{"type":"array","items":{"type":"object","properties":{"score":{"type":"integer","minimum":0,"maximum":3},"description":{"type":"string"}},"required":["score","description"]}},"confidence":{"type":"object","properties":{"category":{"type":"string"},"substance":{"type":"string"}},"required":["category","substance"]},"questions":{"type":"object","properties":{"verdict":{"type":"object","properties":{"type":{"const":"choice"},"instructions":{"type":"string"},"criteria":{"type":"object","additionalProperties":{"type":"string"}}},"required":["type","instructions","criteria"]},"substance":{"type":"object","properties":{"type":{"const":"score"},"instructions":{"type":"string"},"criteria":{"type":"array","items":{"type":"string"}}},"required":["type","instructions","criteria"]},"hot_take":{"type":"object","properties":{"type":{"const":"noul"},"instructions":{"type":"string"},"criteria":{"type":"object","properties":{"true":{"type":"string"},"false":{"type":"string"}},"required":["true","false"]}},"required":["type","instructions","criteria"]}},"required":["verdict","substance","hot_take"]},"inputFields":{"type":"array","items":{"type":"string"}},"limitations":{"type":"array","items":{"type":"string"}},"rateLimit":{"type":"object","properties":{"limit":{"type":"integer","minimum":0},"windowSeconds":{"type":"integer","minimum":0}},"required":["limit","windowSeconds"]}},"required":["enabled","questionSetVersion","categories","substanceScale","confidence","questions","inputFields","limitations","rateLimit"]},"JudgeResult":{"type":"object","properties":{"tweetId":{"type":"string","format":"uuid"},"model":{"type":"string"},"questionSetVersion":{"type":"integer","minimum":0},"generatedAt":{"type":"string","format":"date-time"},"source":{"type":"object","properties":{"canonicalUrl":{"type":"string","format":"uri"},"authorHandle":{"type":"string"},"postedAt":{"type":"string","format":"date-time"}},"required":["canonicalUrl","authorHandle","postedAt"]},"answers":{"type":"object","properties":{"verdict":{"type":"object","properties":{"type":{"const":"choice"},"choice":{"type":"string","enum":["analysis","opinion","news","education","pain_point","hype","promotion","reaction","discussion","unclear"]},"probabilities":{"type":"object","additionalProperties":{"type":"number","minimum":0,"maximum":1}},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["type","choice","probabilities","confidence"]},"substance":{"type":"object","properties":{"type":{"const":"score"},"score":{"type":"number","minimum":0,"maximum":3},"legend":{"type":"object","additionalProperties":{"type":"string"}},"probabilities":{"type":"object","additionalProperties":{"type":"number","minimum":0,"maximum":1}},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["type","score","legend","probabilities","confidence"]},"hot_take":{"type":"object","properties":{"type":{"const":"noul"},"noul":{"type":"number","minimum":0,"maximum":1}},"required":["type","noul"]}},"required":["verdict","substance","hot_take"]},"usage":{"type":"object","properties":{"input_tokens":{"type":"integer","minimum":0},"output_tokens":{"type":"integer","minimum":0}},"required":["input_tokens","output_tokens"]},"latencyMs":{"type":"integer","minimum":0}},"required":["tweetId","model","questionSetVersion","generatedAt","source","answers","usage","latencyMs"]},"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code.","examples":["invalid_parameter"]},"message":{"type":"string","description":"Human-readable explanation of the failure."},"hint":{"type":"string","description":"A concrete next step that can resolve the failure."}},"additionalProperties":false}},"additionalProperties":false},"StoryReceipt":{"type":"object","required":["tweetId","tweetUrl","authorHandle","authorName","excerpt","postedAt"],"properties":{"tweetId":{"type":"string"},"tweetUrl":{"type":"string"},"authorHandle":{"type":"string"},"authorName":{"type":"string"},"excerpt":{"type":"string"},"postedAt":{"type":"string","format":"date-time"}},"additionalProperties":false},"StoryBoardRow":{"type":"object","required":["id","headline","whyNow","hero","window","compiledAt"],"properties":{"id":{"type":"string","format":"uuid"},"headline":{"type":"string"},"whyNow":{"type":"string"},"hero":{"oneOf":[{"$ref":"#/components/schemas/StoryReceipt"},{"type":"null"}]},"window":{"type":"string","enum":["4h","24h","48h","7d"]},"compiledAt":{"type":"string","format":"date-time"}},"additionalProperties":false},"StoryBoard":{"type":"object","required":["window","windowEnd","generatedAt","stories"],"properties":{"window":{"type":"string","enum":["4h","24h","48h","7d"]},"windowEnd":{"type":"string","format":"date-time"},"generatedAt":{"type":"string","format":"date-time"},"stories":{"type":"array","items":{"$ref":"#/components/schemas/StoryBoardRow"},"maxItems":12}},"additionalProperties":false},"StoryBrief":{"type":"object","required":["id","storyKey","window","windowEnd","headline","whyNow","disagreement","receipts","hero","entitySlugs","clusterScore","compileModel","compiledAt"],"properties":{"id":{"type":"string","format":"uuid"},"storyKey":{"type":"string"},"window":{"type":"string","enum":["4h","24h","48h","7d"]},"windowEnd":{"type":"string","format":"date-time"},"headline":{"type":"string"},"whyNow":{"type":"string"},"disagreement":{"type":["string","null"]},"receipts":{"type":"array","items":{"$ref":"#/components/schemas/StoryReceipt"},"minItems":2,"maxItems":3},"hero":{"oneOf":[{"$ref":"#/components/schemas/StoryReceipt"},{"type":"null"}]},"entitySlugs":{"type":"array","items":{"type":"string"}},"clusterScore":{"type":"number"},"compileModel":{"type":"string"},"compiledAt":{"type":"string","format":"date-time"},"related":{"type":"array","items":{"$ref":"#/components/schemas/StoryBrief"}}},"additionalProperties":false},"StoryLookupEmpty":{"type":"object","required":["empty","copy","related"],"properties":{"empty":{"type":"boolean","const":true},"copy":{"type":"string","const":"Nothing moved on this"},"related":{"oneOf":[{"$ref":"#/components/schemas/StoryBrief"},{"type":"null"}]}},"additionalProperties":false},"StoryLookup":{"oneOf":[{"$ref":"#/components/schemas/StoryBrief"},{"$ref":"#/components/schemas/StoryLookupEmpty"}]},"PublicProfile":{"type":"object","required":["id","handle","name"],"properties":{"id":{"type":"string","format":"uuid"},"twitter_user_id":{"type":["string","null"]},"handle":{"type":"string"},"name":{"type":"string"},"bio":{"type":["string","null"]},"avatar_url":{"type":["string","null"],"format":"uri"},"banner_url":{"type":["string","null"],"format":"uri"},"location":{"type":["string","null"]},"website":{"type":["string","null"],"format":"uri"},"verified":{"type":["boolean","null"]},"follower_count":{"type":["integer","null"],"minimum":0},"following_count":{"type":["integer","null"],"minimum":0},"tweet_count":{"type":["integer","null"],"minimum":0},"listed_count":{"type":["integer","null"],"minimum":0},"joined_date":{"type":["string","null"],"format":"date-time"}},"additionalProperties":false},"XSafeTweet":{"type":"object","description":"A published Zeitwire evidence row. Carries X Post ID, author X User ID and an x.com permalink plus Zeitwire-derived fields; post text, profiles and media are not included (hydrate from X under its terms).","required":["id","x_post_id","x_url","author_x_user_id","headline","summary","topics","quality_score","content_type","posted_at","ingested_at","canonical_url"],"properties":{"id":{"type":"string","format":"uuid"},"x_post_id":{"type":["string","null"],"pattern":"^\\d{1,20}$"},"x_url":{"type":["string","null"],"format":"uri"},"author_x_user_id":{"type":["string","null"],"pattern":"^\\d{1,20}$"},"headline":{"type":["string","null"]},"summary":{"type":["string","null"]},"topics":{"type":"array","items":{"type":"string"}},"quality_score":{"type":["integer","null"],"minimum":1,"maximum":10},"content_type":{"type":["string","null"],"enum":["tweet","article",null]},"posted_at":{"type":["string","null"],"format":"date-time"},"ingested_at":{"type":["string","null"],"format":"date-time"},"canonical_url":{"type":"string","format":"uri"},"tech_twitter":{"oneOf":[{"type":"object","required":["views","clicks"],"properties":{"views":{"type":"integer","minimum":0},"clicks":{"type":"integer","minimum":0}},"additionalProperties":false},{"type":"null"}]}},"additionalProperties":false},"Tweet":{"type":"object","description":"A published Zeitwire evidence row.","required":["id","tweet_url","tweet_text","summary","author_name","author_handle","timestamp","comment_count","like_count","retweet_count","submitted_at","created_at","seo_title","bookmark_count","image_url","keywords","video_url","video_thumbnail_url","image_grid_urls","profile_id","link_card_url","link_card_title","link_card_image_url","link_card_domain","is_pinned","pinned_at","content_type","article_title","article_image_url","slug","quality_score"],"properties":{"id":{"type":"string","format":"uuid"},"tweet_url":{"type":"string","format":"uri"},"tweet_text":{"type":"string"},"summary":{"type":["string","null"]},"author_name":{"type":"string"},"author_handle":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"comment_count":{"type":["integer","null"],"minimum":0},"like_count":{"type":["integer","null"],"minimum":0},"retweet_count":{"type":["integer","null"],"minimum":0},"submitted_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"seo_title":{"type":["string","null"]},"bookmark_count":{"type":["integer","null"],"minimum":0},"image_url":{"type":["string","null"],"format":"uri"},"keywords":{"oneOf":[{"type":"array","items":{"type":"string"},"maxItems":10},{"type":"null"}]},"video_url":{"type":["string","null"],"format":"uri"},"video_thumbnail_url":{"type":["string","null"],"format":"uri"},"image_grid_urls":{"type":["array","null"],"items":{"type":"string","format":"uri"}},"profile_id":{"type":["string","null"],"format":"uuid"},"link_card_url":{"type":["string","null"],"format":"uri"},"link_card_title":{"type":["string","null"]},"link_card_image_url":{"type":["string","null"],"format":"uri"},"link_card_domain":{"type":["string","null"]},"is_pinned":{"type":["boolean","null"]},"pinned_at":{"type":["string","null"],"format":"date-time"},"content_type":{"type":["string","null"],"enum":["tweet","article",null]},"article_title":{"type":["string","null"]},"article_image_url":{"type":["string","null"],"format":"uri"},"slug":{"type":["string","null"]},"quality_score":{"type":["integer","null"],"minimum":1,"maximum":10},"noindex":{"type":"boolean"},"profiles":{"oneOf":[{"$ref":"#/components/schemas/PublicProfile"},{"type":"null"}]}},"additionalProperties":false},"CountedTweetCollection":{"type":"object","required":["tweets","count"],"properties":{"tweets":{"type":"array","items":{"$ref":"#/components/schemas/XSafeTweet"}},"count":{"type":"integer","minimum":0}},"additionalProperties":false},"LatestTweetCollection":{"type":"object","required":["tweets","count"],"properties":{"tweets":{"type":"array","items":{"$ref":"#/components/schemas/XSafeTweet"}},"count":{"type":"integer","minimum":0},"hasMore":{"type":"boolean"},"overflowTweetId":{"type":["string","null"]}},"additionalProperties":false},"TrendingTweetCollection":{"type":"object","required":["tweets","total","hasMore"],"properties":{"tweets":{"type":"array","items":{"$ref":"#/components/schemas/XSafeTweet"}},"total":{"type":"integer","minimum":0},"hasMore":{"type":"boolean"}},"additionalProperties":false},"TweetSearchCollection":{"type":"object","description":"Search results with the strategy that produced them. `countIsLowerBound` is true when the keyword fallback could only prove that more results exist.","required":["tweets","totalCount","hasMore","countIsLowerBound","query","searchType"],"properties":{"tweets":{"type":"array","items":{"$ref":"#/components/schemas/XSafeTweet"}},"totalCount":{"type":"integer","minimum":0},"hasMore":{"type":"boolean"},"countIsLowerBound":{"type":"boolean"},"query":{"type":"string"},"searchType":{"type":"string","enum":["author","keyword","semantic","hybrid"]}},"additionalProperties":false},"HotTake":{"type":"object","description":"A published tweet with its replies-to-likes discussion ratio.","required":["id","tweet_url","tweet_text","summary","author_name","author_handle","timestamp","comment_count","like_count","retweet_count","submitted_at","created_at","seo_title","bookmark_count","image_url","keywords","video_url","video_thumbnail_url","image_grid_urls","profile_id","link_card_url","link_card_title","link_card_image_url","link_card_domain","is_pinned","pinned_at","content_type","article_title","article_image_url","slug","quality_score","replyRatio"],"properties":{"id":{"type":"string","format":"uuid"},"tweet_url":{"type":"string","format":"uri"},"tweet_text":{"type":"string"},"summary":{"type":["string","null"]},"author_name":{"type":"string"},"author_handle":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"comment_count":{"type":["integer","null"],"minimum":0},"like_count":{"type":["integer","null"],"minimum":0},"retweet_count":{"type":["integer","null"],"minimum":0},"submitted_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"seo_title":{"type":["string","null"]},"bookmark_count":{"type":["integer","null"],"minimum":0},"image_url":{"type":["string","null"],"format":"uri"},"keywords":{"oneOf":[{"type":"array","items":{"type":"string"},"maxItems":10},{"type":"null"}]},"video_url":{"type":["string","null"],"format":"uri"},"video_thumbnail_url":{"type":["string","null"],"format":"uri"},"image_grid_urls":{"type":["array","null"],"items":{"type":"string","format":"uri"}},"profile_id":{"type":["string","null"],"format":"uuid"},"link_card_url":{"type":["string","null"],"format":"uri"},"link_card_title":{"type":["string","null"]},"link_card_image_url":{"type":["string","null"],"format":"uri"},"link_card_domain":{"type":["string","null"]},"is_pinned":{"type":["boolean","null"]},"pinned_at":{"type":["string","null"],"format":"date-time"},"content_type":{"type":["string","null"],"enum":["tweet","article",null]},"article_title":{"type":["string","null"]},"article_image_url":{"type":["string","null"],"format":"uri"},"slug":{"type":["string","null"]},"quality_score":{"type":["integer","null"],"minimum":1,"maximum":10},"noindex":{"type":"boolean"},"profiles":{"oneOf":[{"$ref":"#/components/schemas/PublicProfile"},{"type":"null"}]},"replyRatio":{"type":"number","minimum":0}},"additionalProperties":false},"HotTakeCollection":{"type":"object","required":["tweets","count"],"properties":{"tweets":{"type":"array","items":{"$ref":"#/components/schemas/HotTake"}},"count":{"type":"integer","minimum":0}},"additionalProperties":false},"ArticleCollection":{"type":"object","required":["articles","total","limit","offset","nextCursor","hasMore"],"properties":{"articles":{"type":"array","items":{"$ref":"#/components/schemas/XSafeTweet"}},"total":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":50},"offset":{"type":"integer","const":0},"nextCursor":{"type":["string","null"]},"hasMore":{"type":"boolean"}},"additionalProperties":false},"AgentEvidenceProvenance":{"type":"object","required":["table"],"properties":{"table":{"type":"string"},"id":{"type":"string"},"contentType":{"type":"string"}},"additionalProperties":false},"AgentEvidenceAuthor":{"type":"object","required":["xUserId"],"properties":{"xUserId":{"type":"string","pattern":"^\\d{1,20}$"}},"additionalProperties":false},"AgentTopicRef":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"slug":{"type":"string"}},"additionalProperties":false},"AgentDerivedEvidenceRole":{"type":"object","required":["evidenceRole","sourceType","sourceDomain","confidence","rationaleCodes"],"properties":{"evidenceRole":{"type":"string","enum":["origin","report","analysis","official_confirmation","reaction"]},"sourceType":{"type":"string","enum":["x_post","first_party_web","external_web","unknown"]},"sourceDomain":{"type":["string","null"]},"confidence":{"type":"number","minimum":0,"maximum":1},"rationaleCodes":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"AgentDerivedEvidencePerformance":{"type":"object","required":["authorPerformanceRatio","authorPercentile","cohortPercentile"],"properties":{"authorPerformanceRatio":{"type":["number","null"],"minimum":0},"authorPercentile":{"type":["number","null"],"minimum":0,"maximum":1},"cohortPercentile":{"type":["number","null"],"minimum":0,"maximum":1}},"additionalProperties":false},"AgentDerivedEvidenceConversation":{"type":"object","required":["observedPostCount","distinctAuthorCount","relationshipEdgeCount","crossAuthorEdgeCount","maximumObservedDepth","coverage"],"properties":{"observedPostCount":{"type":"integer","minimum":0},"distinctAuthorCount":{"type":"integer","minimum":0},"relationshipEdgeCount":{"type":"integer","minimum":0},"crossAuthorEdgeCount":{"type":"integer","minimum":0},"maximumObservedDepth":{"type":"integer","minimum":0},"coverage":{"type":"string","const":"corpus_bounded"}},"additionalProperties":false},"AgentDerivedEvidenceEmergingVoice":{"type":"object","required":["topic","recentPostCount","baselinePostCount","recentAuthorPercentile","momentumScore","coverage"],"properties":{"topic":{"oneOf":[{"$ref":"#/components/schemas/AgentTopicRef"},{"type":"null"}],"description":"The public topic or safe canonical entity label associated with the momentum signal; null when unavailable."},"recentPostCount":{"type":"integer","minimum":0},"baselinePostCount":{"type":"integer","minimum":0},"recentAuthorPercentile":{"type":["number","null"],"minimum":0,"maximum":1},"momentumScore":{"type":["number","null"]},"coverage":{"type":"string","enum":["full","partial","insufficient_data"]}},"additionalProperties":false},"AgentDerivedEvidenceCluster":{"type":"object","required":["headline"],"properties":{"headline":{"type":"string"}},"additionalProperties":false},"AgentDerivedEvidence":{"type":"object","description":"Stored-data analysis for a public receipt. Null sections mean the requested conclusion is unsupported.","required":["role","performance","evidenceCluster"],"properties":{"role":{"oneOf":[{"$ref":"#/components/schemas/AgentDerivedEvidenceRole"},{"type":"null"}]},"performance":{"oneOf":[{"$ref":"#/components/schemas/AgentDerivedEvidencePerformance"},{"type":"null"}]},"evidenceCluster":{"oneOf":[{"$ref":"#/components/schemas/AgentDerivedEvidenceCluster"},{"type":"null"}]}},"additionalProperties":false},"AgentDerivedEvidenceCoverage":{"type":"object","required":["policyVersion","status","enrichedEvidenceCount"],"properties":{"policyVersion":{"type":"string"},"status":{"type":"string","enum":["complete","degraded"]},"enrichedEvidenceCount":{"type":"integer","minimum":0,"maximum":20},"reason":{"type":"string","enum":["feature_lookup_failed"]}},"additionalProperties":false},"AgentEvidence":{"type":"object","required":["id","sourceType","provenance","title","xPostId","xUrl","author","postedAt","topics","whyIncluded","canonicalUrl","derivedEvidence"],"properties":{"id":{"type":"string"},"sourceType":{"type":"string","enum":["tweet","article","topic","profile"]},"provenance":{"$ref":"#/components/schemas/AgentEvidenceProvenance"},"title":{"type":"string"},"summary":{"type":["string","null"]},"xPostId":{"type":["string","null"],"pattern":"^\\d{1,20}$"},"xUrl":{"type":["string","null"],"format":"uri"},"author":{"oneOf":[{"$ref":"#/components/schemas/AgentEvidenceAuthor"},{"type":"null"}]},"postedAt":{"type":["string","null"],"format":"date-time"},"qualityScore":{"type":["integer","null"],"minimum":1,"maximum":10},"topics":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"slug":{"type":"string"}}}},"whyIncluded":{"type":"string"},"canonicalUrl":{"type":"string","format":"uri"},"derivedEvidence":{"oneOf":[{"$ref":"#/components/schemas/AgentDerivedEvidence"},{"type":"null"}]}},"additionalProperties":false},"AgentFacet":{"type":"object","required":["name","value","count"],"properties":{"name":{"type":"string"},"value":{"type":"string"},"count":{"type":"integer","minimum":0},"href":{"type":"string","format":"uri"}},"additionalProperties":false},"AgentFacetMetrics":{"type":"object","required":["evidenceCount","maxLimit"],"properties":{"evidenceCount":{"type":"integer","minimum":0},"maxLimit":{"type":"integer","minimum":1,"maximum":20}},"additionalProperties":false},"AgentContextFacets":{"type":"object","required":["topics","authors","sources","metrics"],"properties":{"topics":{"type":"array","items":{"$ref":"#/components/schemas/AgentFacet"}},"authors":{"type":"array","items":{"$ref":"#/components/schemas/AgentFacet"}},"sources":{"type":"array","items":{"$ref":"#/components/schemas/AgentFacet"}},"metrics":{"$ref":"#/components/schemas/AgentFacetMetrics"}},"additionalProperties":false},"AgentContextNext":{"type":"object","required":["context","a2a","agentCard","llmsFull","relatedEndpoints"],"properties":{"context":{"type":"string","format":"uri"},"a2a":{"type":"string","format":"uri"},"agentCard":{"type":"string","format":"uri"},"llmsFull":{"type":"string","format":"uri"},"relatedEndpoints":{"type":"array","items":{"type":"string","format":"uri"}}},"additionalProperties":false},"AgentContext":{"type":"object","required":["kind","question","query","generatedAt","window","instructions","evidence","derivedEvidence","facets","next"],"properties":{"kind":{"type":"string","enum":["what-changed","launches","arguments","read-list","narrative-alert"]},"question":{"type":"string"},"query":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"},"window":{"type":"object","required":["label","start","end"],"properties":{"label":{"type":"string","enum":["24h","48h","7d"]},"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"}}},"instructions":{"type":"array","items":{"type":"string"}},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/AgentEvidence"}},"derivedEvidence":{"$ref":"#/components/schemas/AgentDerivedEvidenceCoverage"},"facets":{"$ref":"#/components/schemas/AgentContextFacets"},"next":{"$ref":"#/components/schemas/AgentContextNext"}},"additionalProperties":false},"HeatmapTopic":{"type":"object","required":["keyword","slug","count","engagement"],"properties":{"keyword":{"type":"string"},"slug":{"type":"string"},"count":{"type":"integer","minimum":0},"engagement":{"type":"integer","minimum":0}},"additionalProperties":false},"HeatmapCollection":{"type":"object","required":["topics"],"properties":{"topics":{"type":"array","items":{"$ref":"#/components/schemas/HeatmapTopic"}}},"additionalProperties":false},"PublicTopic":{"type":"object","required":["id","name","display_name","slug","tweet_count","description","long_description","category","related_topic_ids","metadata_updated_at","created_at","last_tweet_at"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"display_name":{"type":"string"},"slug":{"type":"string"},"tweet_count":{"type":["integer","null"],"minimum":0},"description":{"type":["string","null"]},"long_description":{"type":["string","null"]},"category":{"type":["string","null"]},"related_topic_ids":{"type":["array","null"],"items":{"type":"string","format":"uuid"}},"metadata_updated_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"last_tweet_at":{"type":["string","null"],"format":"date-time"}},"additionalProperties":false},"PublicTopicCollection":{"type":"object","required":["topics"],"properties":{"topics":{"type":"array","items":{"$ref":"#/components/schemas/PublicTopic"}}},"additionalProperties":false},"NarrativeTrend":{"type":"object","required":["keyword","mentionCount","engagementTotal","firstSeen","dayOverDay","streak","todayCount","trend"],"properties":{"keyword":{"type":"string"},"mentionCount":{"type":"integer","minimum":0},"engagementTotal":{"type":"integer","minimum":0},"firstSeen":{"type":"string","format":"date-time"},"dayOverDay":{"type":"integer"},"streak":{"type":"integer","enum":[0,2,3]},"todayCount":{"type":"integer","minimum":0},"trend":{"type":"string","enum":["emerging","momentum"]}},"additionalProperties":false},"ConnectedNarrative":{"type":"object","required":["keywords","coOccurrence"],"properties":{"keywords":{"type":"array","items":{"type":"string"},"minItems":2,"maxItems":2},"coOccurrence":{"type":"integer","minimum":0}},"additionalProperties":false},"HotNarrative":{"type":"object","required":["keyword","count","engagement"],"properties":{"keyword":{"type":"string"},"count":{"type":"integer","minimum":0},"engagement":{"type":"integer","minimum":0}},"additionalProperties":false},"NarrativeCollection":{"type":"object","required":["emerging","momentum","connected","hotToday"],"properties":{"emerging":{"type":"array","items":{"$ref":"#/components/schemas/NarrativeTrend"}},"momentum":{"type":"array","items":{"$ref":"#/components/schemas/NarrativeTrend"}},"connected":{"type":"array","items":{"$ref":"#/components/schemas/ConnectedNarrative"}},"hotToday":{"type":"array","items":{"$ref":"#/components/schemas/HotNarrative"}}},"additionalProperties":false},"TimeTravelDay":{"type":"object","required":["tweets","totalCount","uniqueAuthors","lastmod"],"properties":{"tweets":{"type":"array","items":{"$ref":"#/components/schemas/XSafeTweet"}},"totalCount":{"type":"integer","minimum":0},"uniqueAuthors":{"type":"integer","minimum":0},"lastmod":{"type":["string","null"],"format":"date-time"},"limit":{"type":"integer","minimum":1,"maximum":50},"hasMore":{"type":"boolean"}},"additionalProperties":false},"JsonRpcId":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"A2AMetadata":{"type":"object","properties":{"question":{"type":"string"},"text":{"type":"string"},"kind":{"type":"string","enum":["auto","what-changed","launches","arguments","read-list","narrative-alert"]},"q":{"type":"string"},"topic":{"type":"string"},"window":{"type":"string","enum":["24h","48h","7d"]},"limit":{"type":"integer","minimum":1,"maximum":20}},"additionalProperties":true},"A2ATextInputPart":{"type":"object","required":["text"],"properties":{"text":{"type":"string"},"metadata":{"type":"object","additionalProperties":true},"filename":{"type":"string"},"mediaType":{"type":"string"}},"additionalProperties":false},"A2ADataInputPart":{"type":"object","required":["data"],"properties":{"data":{},"metadata":{"type":"object","additionalProperties":true},"filename":{"type":"string"},"mediaType":{"type":"string"}},"additionalProperties":false},"A2AInputPart":{"oneOf":[{"$ref":"#/components/schemas/A2ATextInputPart"},{"$ref":"#/components/schemas/A2ADataInputPart"}]},"A2AInputMessage":{"type":"object","required":["messageId","role","parts"],"properties":{"messageId":{"type":"string","minLength":1},"contextId":{"type":"string","minLength":1,"description":"Optional conversation identifier. The response echoes this value; when omitted, the server creates one."},"taskId":{"type":"string","minLength":1,"description":"Task continuation is not supported. Any supplied non-empty taskId returns Task not found (-32001)."},"role":{"type":"string","const":"ROLE_USER"},"parts":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/A2AInputPart"}},"metadata":{"$ref":"#/components/schemas/A2AMetadata"},"extensions":{"type":"array","items":{"type":"string","format":"uri"}},"referenceTaskIds":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"A2ASendMessageConfiguration":{"type":"object","properties":{"acceptedOutputModes":{"type":"array","items":{"type":"string"}},"historyLength":{"type":"integer","minimum":0},"returnImmediately":{"type":"boolean"}},"additionalProperties":false},"A2ARequestParams":{"type":"object","required":["message"],"properties":{"tenant":{"type":"string"},"message":{"$ref":"#/components/schemas/A2AInputMessage"},"configuration":{"$ref":"#/components/schemas/A2ASendMessageConfiguration"},"metadata":{"$ref":"#/components/schemas/A2AMetadata"}},"additionalProperties":false},"A2ARequest":{"type":"object","required":["jsonrpc","method","params"],"properties":{"jsonrpc":{"type":"string","const":"2.0"},"id":{"$ref":"#/components/schemas/JsonRpcId"},"method":{"type":"string","const":"SendMessage"},"params":{"$ref":"#/components/schemas/A2ARequestParams"}},"additionalProperties":false},"A2ADataPart":{"type":"object","required":["mediaType","data"],"properties":{"mediaType":{"type":"string","const":"application/json"},"data":{"$ref":"#/components/schemas/AgentContext"}},"additionalProperties":false},"A2AMessageMetadata":{"type":"object","required":["kind","generatedAt"],"properties":{"kind":{"type":"string","enum":["what-changed","launches","arguments","read-list","narrative-alert"]},"generatedAt":{"type":"string","format":"date-time"}},"additionalProperties":true},"A2AMessage":{"type":"object","required":["messageId","contextId","role","parts","metadata"],"properties":{"messageId":{"type":"string"},"contextId":{"type":"string","minLength":1,"description":"Conversation identifier. The response echoes a client-supplied contextId or contains a server-generated value."},"role":{"type":"string","const":"ROLE_AGENT"},"parts":{"type":"array","minItems":1,"maxItems":1,"items":{"$ref":"#/components/schemas/A2ADataPart"}},"metadata":{"$ref":"#/components/schemas/A2AMessageMetadata"}},"additionalProperties":false},"A2AResult":{"type":"object","required":["message"],"properties":{"message":{"$ref":"#/components/schemas/A2AMessage"}},"additionalProperties":false},"A2AErrorDetail":{"type":"object","required":["@type"],"properties":{"@type":{"type":"string"}},"additionalProperties":true},"A2AError":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer"},"message":{"type":"string"},"data":{"type":"array","items":{"$ref":"#/components/schemas/A2AErrorDetail"}}},"additionalProperties":false},"A2ASuccessResponse":{"type":"object","required":["jsonrpc","id","result"],"properties":{"jsonrpc":{"type":"string","const":"2.0"},"id":{"$ref":"#/components/schemas/JsonRpcId"},"result":{"$ref":"#/components/schemas/A2AResult"}},"additionalProperties":false},"A2AErrorResponse":{"type":"object","required":["jsonrpc","id","error"],"properties":{"jsonrpc":{"type":"string","const":"2.0"},"id":{"$ref":"#/components/schemas/JsonRpcId"},"error":{"$ref":"#/components/schemas/A2AError"}},"additionalProperties":false},"A2AResponse":{"oneOf":[{"$ref":"#/components/schemas/A2ASuccessResponse"},{"$ref":"#/components/schemas/A2AErrorResponse"}]},"TrendSource":{"type":"string","enum":["tracked_graph","x_counts","x_native_trends"]},"TrendWindow":{"type":"string","enum":["1h","4h","24h","48h","7d","30d","90d","12m","custom"]},"TrendNowWindow":{"type":"string","enum":["4h","24h","48h","7d"]},"TrendRange":{"type":"object","required":["window","start","end","granularity"],"properties":{"window":{"$ref":"#/components/schemas/TrendWindow"},"start":{"type":"string","format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$"},"end":{"type":"string","format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$"},"granularity":{"type":"string","enum":["hour","day"]}},"additionalProperties":false},"TrendAvailabilityProvider":{"type":"object","required":["available","status","endpoints"],"properties":{"available":{"type":"boolean"},"status":{"type":["string","null"]},"endpoints":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"TrendEntity":{"type":"object","required":["id","key","type","name","categoryKey"],"properties":{"id":{"type":"string"},"key":{"type":"string"},"type":{"type":"string"},"name":{"type":"string"},"categoryKey":{"type":"string"}},"additionalProperties":false},"TrendEntityAlias":{"type":"object","required":["alias","kind"],"properties":{"alias":{"type":"string"},"kind":{"type":"string"}},"additionalProperties":false},"TrendCoverage":{"type":"object","required":["coveredHandleSeconds","expectedHandleSeconds","ratio","flag"],"properties":{"coveredHandleSeconds":{"type":"integer","minimum":0},"expectedHandleSeconds":{"type":"integer","minimum":0},"ratio":{"type":"number","minimum":0,"maximum":1},"flag":{"type":"string","enum":["complete","partial","suppressed"]}},"additionalProperties":false},"TrendVersions":{"type":"object","required":["taxonomyVersionId","extractorVersionId"],"properties":{"taxonomyVersionId":{"type":["string","null"],"format":"uuid"},"extractorVersionId":{"type":["string","null"],"format":"uuid"}},"additionalProperties":false},"TrendPointValue":{"type":"object","required":["mentionVolume","postVolume","corpusTotal","sharePer10k","relativeCoverage"],"properties":{"mentionVolume":{"type":"integer","minimum":0},"postVolume":{"type":"integer","minimum":0},"corpusTotal":{"type":"integer","minimum":0},"sharePer10k":{"type":"number","minimum":0,"maximum":10000},"relativeCoverage":{"type":"number","minimum":0,"maximum":100}},"additionalProperties":false},"TrendSeriesSummary":{"type":"object","required":["mentionVolume","postVolume","corpusTotal","sharePer10k","relativeCoverage","complete"],"properties":{"mentionVolume":{"type":"integer","minimum":0},"postVolume":{"type":"integer","minimum":0},"corpusTotal":{"type":"integer","minimum":0},"sharePer10k":{"type":"number","minimum":0,"maximum":10000},"relativeCoverage":{"type":"number","minimum":0,"maximum":100},"complete":{"type":"boolean"}},"additionalProperties":false},"TrendSeriesBucket":{"type":"object","required":["start","end","complete","corpusTotal","values"],"properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"},"complete":{"type":"boolean"},"corpusTotal":{"type":"integer","minimum":0},"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/TrendPointValue"}}},"additionalProperties":false},"TrendSeries":{"type":"object","required":["source","metric","window","entities","buckets","coverage","versions","generatedAt","dataThrough","provider"],"properties":{"source":{"$ref":"#/components/schemas/TrendSource"},"metric":{"type":"string","enum":["volume","relative"]},"window":{"$ref":"#/components/schemas/TrendRange"},"entities":{"type":"array","items":{"$ref":"#/components/schemas/TrendEntity"},"maxItems":5},"buckets":{"type":"array","items":{"$ref":"#/components/schemas/TrendSeriesBucket"},"maxItems":366},"coverage":{"$ref":"#/components/schemas/TrendCoverage"},"versions":{"$ref":"#/components/schemas/TrendVersions"},"generatedAt":{"type":"string","format":"date-time"},"dataThrough":{"type":["string","null"],"format":"date-time"},"provider":{"type":["object","null"],"additionalProperties":true}},"additionalProperties":false},"TrendRelatedRow":{"type":"object","required":["entity","support","lift","growth"],"properties":{"entity":{"$ref":"#/components/schemas/TrendEntity"},"support":{"type":"integer","minimum":0},"lift":{"type":"number","minimum":0},"growth":{"type":["number","null"]}},"additionalProperties":false},"TrendRelated":{"type":"object","required":["source","entity","window","top","rising","coverage","versions","generatedAt","dataThrough"],"properties":{"source":{"type":"string","const":"tracked_graph"},"entity":{"$ref":"#/components/schemas/TrendEntity"},"window":{"$ref":"#/components/schemas/TrendRange"},"top":{"type":"array","items":{"$ref":"#/components/schemas/TrendRelatedRow"}},"rising":{"type":"array","items":{"$ref":"#/components/schemas/TrendRelatedRow"}},"coverage":{"$ref":"#/components/schemas/TrendCoverage"},"versions":{"$ref":"#/components/schemas/TrendVersions"},"generatedAt":{"type":"string","format":"date-time"},"dataThrough":{"type":["string","null"],"format":"date-time"}},"additionalProperties":false},"TrendNowRow":{"type":"object","required":["source","entity","volume","authorCount","latest","growth","detectedAt","status","sparkline","cursor","aliases"],"properties":{"source":{"$ref":"#/components/schemas/TrendSource"},"entity":{"$ref":"#/components/schemas/TrendEntity"},"volume":{"type":"integer","minimum":0},"authorCount":{"type":["integer","null"],"minimum":0},"latest":{"anyOf":[{"type":"null"},{"type":"object","required":["authorHandle","postedAt","xPostId","postText"],"additionalProperties":false,"properties":{"authorHandle":{"type":"string"},"postedAt":{"type":"string","format":"date-time"},"xPostId":{"type":["string","null"]},"postText":{"type":["string","null"]}}}]},"growth":{"type":["number","null"]},"detectedAt":{"type":["string","null"],"format":"date-time"},"status":{"type":"string","enum":["breakout","rising","top","stable","insufficient_data"]},"sparkline":{"type":"array","items":{"type":"number"}},"cursor":{"type":"string"},"aliases":{"type":"array","items":{"$ref":"#/components/schemas/TrendEntityAlias"}}},"additionalProperties":false},"TrendNow":{"type":"object","required":["source","window","rows","nextCursor","coverage","versions","generatedAt","dataThrough","provider"],"properties":{"source":{"$ref":"#/components/schemas/TrendSource"},"window":{"$ref":"#/components/schemas/TrendRange"},"rows":{"type":"array","items":{"$ref":"#/components/schemas/TrendNowRow"}},"nextCursor":{"type":["string","null"]},"coverage":{"$ref":"#/components/schemas/TrendCoverage"},"versions":{"$ref":"#/components/schemas/TrendVersions"},"generatedAt":{"type":"string","format":"date-time"},"dataThrough":{"type":["string","null"],"format":"date-time"},"provider":{"type":["object","null"],"additionalProperties":true}},"additionalProperties":false},"TrendEvidencePost":{"type":"object","description":"An observed post assigned to the tracked entity in the requested window.","required":["id","xPostId","authorHandle","postedAt","postText","canonicalUrl"],"properties":{"id":{"type":"string","format":"uuid"},"xPostId":{"type":"string","pattern":"^[0-9]+$"},"authorHandle":{"type":"string"},"postedAt":{"type":"string","format":"date-time"},"postText":{"type":["string","null"]},"canonicalUrl":{"type":"string","format":"uri"}},"additionalProperties":false},"TrendEvidence":{"type":"object","required":["source","entity","posts","coverage","versions","generatedAt","dataThrough"],"properties":{"source":{"type":"string","const":"tracked_graph"},"entity":{"$ref":"#/components/schemas/TrendEntity"},"posts":{"type":"array","items":{"$ref":"#/components/schemas/TrendEvidencePost"}},"coverage":{"$ref":"#/components/schemas/TrendCoverage"},"versions":{"$ref":"#/components/schemas/TrendVersions"},"generatedAt":{"type":"string","format":"date-time"},"dataThrough":{"type":["string","null"],"format":"date-time"}},"additionalProperties":false},"TrendEntityDetail":{"type":"object","required":["source","entity","aliases","variants","seriesSummary","related","topAccounts","evidence","coverage","versions","generatedAt","dataThrough"],"properties":{"source":{"type":"string","const":"tracked_graph"},"entity":{"$ref":"#/components/schemas/TrendEntity"},"aliases":{"type":"array","items":{"$ref":"#/components/schemas/TrendEntityAlias"}},"variants":{"type":"array","items":{"type":"string"}},"seriesSummary":{"$ref":"#/components/schemas/TrendSeriesSummary"},"related":{"type":"object","required":["top","rising"],"properties":{"top":{"type":"array","items":{"$ref":"#/components/schemas/TrendRelatedRow"}},"rising":{"type":"array","items":{"$ref":"#/components/schemas/TrendRelatedRow"}}},"additionalProperties":false},"topAccounts":{"type":"array","items":{"type":"object","required":["handle","mentionVolume"],"properties":{"handle":{"type":"string"},"mentionVolume":{"type":"integer","minimum":0}},"additionalProperties":false}},"evidence":{"type":"array","items":{"type":"object","required":["id","canonicalUrl"],"properties":{"id":{"type":"string","format":"uuid"},"canonicalUrl":{"type":"string"}},"additionalProperties":false}},"coverage":{"$ref":"#/components/schemas/TrendCoverage"},"versions":{"$ref":"#/components/schemas/TrendVersions"},"generatedAt":{"type":"string","format":"date-time"},"dataThrough":{"type":["string","null"],"format":"date-time"}},"additionalProperties":false},"TrendAvailability":{"type":"object","required":["reliableStart","watermark","windows","nowWindows","resolutions","filters","providers","hiddenControls","generatedAt"],"properties":{"reliableStart":{"type":["string","null"],"format":"date-time"},"watermark":{"type":["string","null"],"format":"date-time"},"windows":{"type":"array","items":{"$ref":"#/components/schemas/TrendWindow"}},"nowWindows":{"type":"array","items":{"$ref":"#/components/schemas/TrendNowWindow"},"description":"Trending Now snapshot windows that have passed automatic publication readiness."},"resolutions":{"type":"object","additionalProperties":{"type":"string","enum":["hour","day"]}},"filters":{"type":"object","required":["categories","postTypes","languages"],"properties":{"categories":{"type":"array","items":{"type":"string"}},"postTypes":{"type":"array","items":{"type":"string","enum":["all","original","reply","quote","repost"]}},"languages":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"providers":{"type":"object","required":["tracked_graph","x_counts","x_native_trends"],"properties":{"tracked_graph":{"$ref":"#/components/schemas/TrendAvailabilityProvider"},"x_counts":{"$ref":"#/components/schemas/TrendAvailabilityProvider"},"x_native_trends":{"$ref":"#/components/schemas/TrendAvailabilityProvider"}},"additionalProperties":false},"hiddenControls":{"type":"array","items":{"$ref":"#/components/schemas/TrendSource"}},"generatedAt":{"type":"string","format":"date-time"}},"additionalProperties":false},"TrendEntityCollection":{"type":"object","required":["entities"],"properties":{"entities":{"type":"array","items":{"$ref":"#/components/schemas/TrendEntity"},"maxItems":20}},"additionalProperties":false}}}}