{"openapi":"3.1.0","info":{"title":"PeakComments Pre-Trend Intelligence","version":"1.0.0","description":"Derived, timestamped and source-traceable cultural movement intelligence. Raw commenter identity and raw comment dumps are not sold. Candidate signals are not guaranteed forecasts."},"servers":[{"url":"https://peakcomments.com"}],"paths":{"/api/data/v1/trends":{"get":{"operationId":"getPreTrendCandidates","summary":"Rank emerging cultural movement candidates","parameters":[{"name":"window","in":"query","schema":{"type":"string","enum":["24h","7d","30d","90d"],"default":"7d"}},{"name":"platform","in":"query","required":false,"schema":{"type":"string","enum":["youtube","tiktok","instagram","x"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1}}],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Derived intelligence response"},"401":{"description":"Invalid or missing enterprise entitlement"}},"x-peakcomments-product":"derived-cultural-intelligence","x-x402":{"schema":"peakcomments-agent-data-market/v1","product":"PeakComments Pre-Trend Intelligence","proposition":"Derived, timestamped, source-traceable evidence of cultural movement for organisations and autonomous agents.","access":{"enterprise":"Bearer API entitlement","agents":"x402 prepared but disabled until settlement configuration is approved"},"dataBoundary":{"derivedIntelligence":true,"rawCommentExport":false,"commenterIdentity":false,"futureOutcomeGuarantee":false},"protocol":{"x402Version":2,"paymentSignatureHeader":"PAYMENT-SIGNATURE","paymentRequiredHeader":"PAYMENT-REQUIRED","paymentResponseHeader":"PAYMENT-RESPONSE","enabled":false,"paymentIdentifier":{"extension":"payment-identifier","required":false,"minimumLength":16,"maximumLength":128},"mcp":{"paymentRequestMeta":"x402/payment","paymentResponseMeta":"x402/payment-response","challengeUsesToolResult":true},"scheme":null,"network":null,"asset":null,"assetSymbol":null,"assetDecimals":null},"resources":[{"method":"GET","path":"/api/data/v1/trends","window":"24h","description":"Ranked, derived cultural movement candidates from the last 24h.","price":null},{"method":"GET","path":"/api/data/v1/trends","window":"7d","description":"Ranked, derived cultural movement candidates from the last 7d.","price":null},{"method":"GET","path":"/api/data/v1/trends","window":"30d","description":"Ranked, derived cultural movement candidates from the last 30d.","price":null},{"method":"GET","path":"/api/data/v1/trends","window":"90d","description":"Ranked, derived cultural movement candidates from the last 90d.","price":null},{"method":"GET","path":"/api/data/v1/signals","window":"24h","description":"Source-level, timestamped cultural signal evidence from the last 24h.","price":null},{"method":"GET","path":"/api/data/v1/signals","window":"7d","description":"Source-level, timestamped cultural signal evidence from the last 7d.","price":null},{"method":"GET","path":"/api/data/v1/signals","window":"30d","description":"Source-level, timestamped cultural signal evidence from the last 30d.","price":null},{"method":"GET","path":"/api/data/v1/signals","window":"90d","description":"Source-level, timestamped cultural signal evidence from the last 90d.","price":null},{"method":"GET","path":"/api/data/v1/status","description":"Current methodology and collection status for PeakComments Pre-Trend Intelligence.","price":null}],"discovery":{"openapi":"https://peakcomments.com/openapi.json","llms":"https://peakcomments.com/llms.txt","mcp":"https://peakcomments.com/mcp","a2aAgentCard":"https://peakcomments.com/.well-known/agent-card.json"}}}},"/api/data/v1/signals":{"get":{"operationId":"getSourceSignals","summary":"Return source-level cultural signal evidence","parameters":[{"name":"window","in":"query","schema":{"type":"string","enum":["24h","7d","30d","90d"],"default":"7d"}},{"name":"platform","in":"query","required":false,"schema":{"type":"string","enum":["youtube","tiktok","instagram","x"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1}}],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Derived intelligence response"},"401":{"description":"Invalid or missing enterprise entitlement"}},"x-peakcomments-product":"source-traceable-signals","x-x402":{"schema":"peakcomments-agent-data-market/v1","product":"PeakComments Pre-Trend Intelligence","proposition":"Derived, timestamped, source-traceable evidence of cultural movement for organisations and autonomous agents.","access":{"enterprise":"Bearer API entitlement","agents":"x402 prepared but disabled until settlement configuration is approved"},"dataBoundary":{"derivedIntelligence":true,"rawCommentExport":false,"commenterIdentity":false,"futureOutcomeGuarantee":false},"protocol":{"x402Version":2,"paymentSignatureHeader":"PAYMENT-SIGNATURE","paymentRequiredHeader":"PAYMENT-REQUIRED","paymentResponseHeader":"PAYMENT-RESPONSE","enabled":false,"paymentIdentifier":{"extension":"payment-identifier","required":false,"minimumLength":16,"maximumLength":128},"mcp":{"paymentRequestMeta":"x402/payment","paymentResponseMeta":"x402/payment-response","challengeUsesToolResult":true},"scheme":null,"network":null,"asset":null,"assetSymbol":null,"assetDecimals":null},"resources":[{"method":"GET","path":"/api/data/v1/trends","window":"24h","description":"Ranked, derived cultural movement candidates from the last 24h.","price":null},{"method":"GET","path":"/api/data/v1/trends","window":"7d","description":"Ranked, derived cultural movement candidates from the last 7d.","price":null},{"method":"GET","path":"/api/data/v1/trends","window":"30d","description":"Ranked, derived cultural movement candidates from the last 30d.","price":null},{"method":"GET","path":"/api/data/v1/trends","window":"90d","description":"Ranked, derived cultural movement candidates from the last 90d.","price":null},{"method":"GET","path":"/api/data/v1/signals","window":"24h","description":"Source-level, timestamped cultural signal evidence from the last 24h.","price":null},{"method":"GET","path":"/api/data/v1/signals","window":"7d","description":"Source-level, timestamped cultural signal evidence from the last 7d.","price":null},{"method":"GET","path":"/api/data/v1/signals","window":"30d","description":"Source-level, timestamped cultural signal evidence from the last 30d.","price":null},{"method":"GET","path":"/api/data/v1/signals","window":"90d","description":"Source-level, timestamped cultural signal evidence from the last 90d.","price":null},{"method":"GET","path":"/api/data/v1/status","description":"Current methodology and collection status for PeakComments Pre-Trend Intelligence.","price":null}],"discovery":{"openapi":"https://peakcomments.com/openapi.json","llms":"https://peakcomments.com/llms.txt","mcp":"https://peakcomments.com/mcp","a2aAgentCard":"https://peakcomments.com/.well-known/agent-card.json"}}}},"/api/data/v1/status":{"get":{"operationId":"getPreTrendStatus","summary":"Return intelligence methodology and collection status","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Derived intelligence response"},"401":{"description":"Invalid or missing enterprise entitlement"}},"x-x402":{"schema":"peakcomments-agent-data-market/v1","product":"PeakComments Pre-Trend Intelligence","proposition":"Derived, timestamped, source-traceable evidence of cultural movement for organisations and autonomous agents.","access":{"enterprise":"Bearer API entitlement","agents":"x402 prepared but disabled until settlement configuration is approved"},"dataBoundary":{"derivedIntelligence":true,"rawCommentExport":false,"commenterIdentity":false,"futureOutcomeGuarantee":false},"protocol":{"x402Version":2,"paymentSignatureHeader":"PAYMENT-SIGNATURE","paymentRequiredHeader":"PAYMENT-REQUIRED","paymentResponseHeader":"PAYMENT-RESPONSE","enabled":false,"paymentIdentifier":{"extension":"payment-identifier","required":false,"minimumLength":16,"maximumLength":128},"mcp":{"paymentRequestMeta":"x402/payment","paymentResponseMeta":"x402/payment-response","challengeUsesToolResult":true},"scheme":null,"network":null,"asset":null,"assetSymbol":null,"assetDecimals":null},"resources":[{"method":"GET","path":"/api/data/v1/trends","window":"24h","description":"Ranked, derived cultural movement candidates from the last 24h.","price":null},{"method":"GET","path":"/api/data/v1/trends","window":"7d","description":"Ranked, derived cultural movement candidates from the last 7d.","price":null},{"method":"GET","path":"/api/data/v1/trends","window":"30d","description":"Ranked, derived cultural movement candidates from the last 30d.","price":null},{"method":"GET","path":"/api/data/v1/trends","window":"90d","description":"Ranked, derived cultural movement candidates from the last 90d.","price":null},{"method":"GET","path":"/api/data/v1/signals","window":"24h","description":"Source-level, timestamped cultural signal evidence from the last 24h.","price":null},{"method":"GET","path":"/api/data/v1/signals","window":"7d","description":"Source-level, timestamped cultural signal evidence from the last 7d.","price":null},{"method":"GET","path":"/api/data/v1/signals","window":"30d","description":"Source-level, timestamped cultural signal evidence from the last 30d.","price":null},{"method":"GET","path":"/api/data/v1/signals","window":"90d","description":"Source-level, timestamped cultural signal evidence from the last 90d.","price":null},{"method":"GET","path":"/api/data/v1/status","description":"Current methodology and collection status for PeakComments Pre-Trend Intelligence.","price":null}],"discovery":{"openapi":"https://peakcomments.com/openapi.json","llms":"https://peakcomments.com/llms.txt","mcp":"https://peakcomments.com/mcp","a2aAgentCard":"https://peakcomments.com/.well-known/agent-card.json"}}}},"/mcp":{"post":{"operationId":"callPeakCommentsMcp","summary":"MCP Streamable HTTP endpoint","responses":{"200":{"description":"MCP JSON-RPC response. x402 challenges use a tool result with isError=true and payment metadata, not HTTP 402."}}}},"/message:send":{"post":{"operationId":"sendA2aMessage","summary":"A2A v1.0 HTTP+JSON Send Message","responses":{"200":{"description":"A2A SendMessageResponse"},"401":{"description":"Bearer entitlement required while x402 is disabled"}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"PeakComments API entitlement"}}},"externalDocs":{"description":"Machine-readable agent data catalogue","url":"https://peakcomments.com/.well-known/agent-data.json"}}