{ "openapi": "3.1.0", "info": { "title": "FanPulse API", "description": "Global fandom intelligence API. AI-synthesized fan guides, lore analysis, collectibles valuation, discography deep-dives, character analysis, easter egg discovery, quiz generation, and timeline reconstruction. Covers Western film/TV, K-pop (BTS, BLACKPINK, Stray Kids), anime (Naruto, One Piece, Demon Slayer), Bollywood, Mandopop, and 200+ franchises globally. Amazon merchandise, Fanatics, Weverse (K-pop), and StubHub event ticket affiliates included. All endpoints support any language via ?lang=. Pricing: $0.05\u2013$0.15 USDC/call via x402 micropayment.", "version": "1.2.0" }, "servers": [ { "url": "https://fanpulse-tau.vercel.app" } ], "paths": { "/api/fan/lore": { "get": { "summary": "Deep canon lore Q&A", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "franchise", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "query", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "lang", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Canon answer with sources, canon_status, related lore, fandom debates, trivia tidbit" }, "402": { "description": "$0.10" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Universe lore and world-building \u2014 chain after /api/fan/character; highest engagement for active fandoms", "x-price-usd": 0.1 } }, "/api/fan/character": { "get": { "summary": "Character or artist deep profile", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "franchise", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "name", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "lang", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Full profile: arc, traits, relationships, best moments, quotes, legacy, fandom perspective" }, "402": { "description": "$0.08" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Character deep-dive \u2014 chain to /api/fan/lore for universe context; pairs with /api/fan/compare for character comparisons", "x-price-usd": 0.08 } }, "/api/fan/quiz": { "get": { "summary": "AI-generated trivia set", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "franchise", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "topic", "in": "query", "schema": { "type": "string" } }, { "name": "difficulty", "in": "query", "schema": { "type": "string" }, "description": "easy|medium|hard|mixed" }, { "name": "lang", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "10 trivia questions with options, answers, explanations, scoring guide" }, "402": { "description": "$0.08" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Fan quiz generation \u2014 highest engagement for community apps; pairs with /api/fan/character", "x-price-usd": 0.08 } }, "/api/fan/easter-eggs": { "get": { "summary": "Easter egg and hidden meaning analysis", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "artist", "in": "query", "schema": { "type": "string" }, "description": "For music artists" }, { "name": "franchise", "in": "query", "schema": { "type": "string" }, "description": "For film/TV franchises" }, { "name": "album", "in": "query", "schema": { "type": "string" } }, { "name": "lang", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Confirmed secrets, lyric callbacks, hidden messages, running themes with confirmation status" }, "402": { "description": "$0.15" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Hidden easter egg discovery \u2014 highest virality endpoint; pairs with /api/fan/timeline for chronological context", "x-price-usd": 0.1 } }, "/api/fan/discography": { "get": { "summary": "Artist discography deep dive", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "artist", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "focus", "in": "query", "schema": { "type": "string" } }, { "name": "lang", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Eras, essential listening, underrated gems, collaborations, cultural legacy" }, "402": { "description": "$0.10" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Artist discography analysis \u2014 Vinyl + streaming affiliate links; pairs with /api/fan/collect for collectible albums", "x-price-usd": 0.1 } }, "/api/fan/sorting": { "get": { "summary": "Personality-based character/faction sorting", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "franchise", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "personality", "in": "query", "schema": { "type": "string" } }, { "name": "lang", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "House/faction assignment with reasoning, character match, all options breakdown, destiny narrative" }, "402": { "description": "$0.08" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Personality-based sorting (house, faction, squad assignment) \u2014 viral social content; pairs with /api/fan/character", "x-price-usd": 0.05 } }, "/api/fan/timeline": { "get": { "summary": "Canonical franchise timeline", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "franchise", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "lang", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Canonical eras, pivotal events, watch/read order, canon conflicts, lore gaps" }, "402": { "description": "$0.10" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Franchise timeline \u2014 chain with /api/fan/lore for full universe map; useful for new fan onboarding agents", "x-price-usd": 0.1 } }, "/api/fan/collect": { "get": { "summary": "Collectibles and memorabilia market intelligence", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "franchise", "in": "query", "schema": { "type": "string" } }, { "name": "artist", "in": "query", "schema": { "type": "string" } }, { "name": "item_type", "in": "query", "schema": { "type": "string" }, "description": "vinyl|photocards|figures|signed|comics|cards|props|memorabilia|general" }, { "name": "item", "in": "query", "schema": { "type": "string" } }, { "name": "lang", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Pricing by condition, authentication guide, buy/sell platforms, counterfeit red flags, investment outlook" }, "402": { "description": "$0.10" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Collectibles market intelligence \u2014 K-pop photocard, vinyl, signed memorabilia; Amazon merch + Fanatics + Weverse links auto-appended", "x-price-usd": 0.1 } }, "/api/fan/compare": { "get": { "summary": "Decisive cross-franchise or cross-artist comparison", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "subject1", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "subject2", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "type", "in": "query", "schema": { "type": "string" }, "description": "character|franchise|artist|album" }, { "name": "lang", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Comparison table, strongest arguments, decisive winner with reasoning, fan consensus" }, "402": { "description": "$0.10" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Head-to-head character/franchise comparison \u2014 viral social content; chain with /api/fan/lore for context", "x-price-usd": 0.08 } } } }