{
  "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–$0.15 USDC/call via x402 micropayment.",
    "version": "1.2.0",
    "contact": {
      "name": "The Aslan Group LLC",
      "url": "https://pulsenetwork.theaslangroupllc.com",
      "email": "info@theaslangroupllc.com"
    },
    "x-guidance": "# FanPulse API (x402 pay-per-call)\n\nSuper-fan intelligence API for iconic franchises and artists. 9 endpoints: lore Q&A, character profiles, trivia generation, Easter egg analysis, discography deep dives, personality sorting, canonical timelines, cross-franchise comparisons, and collectibles market intelligence (vinyl Discogs pricing, K-pop photocards, autograph authentication). Pay-per-query via x402 micropayments on Base.\n\nBase URL: https://fanpulse.theaslangroupllc.com\n\n## Payment\nAll paid endpoints use the x402 protocol (HTTP 402): USDC on Base mainnet (eip155:8453). No API keys, no accounts, no subscriptions — pay per call.\n\n## Agent workflow\n1. Request the endpoint. Unpaid requests receive a 402 challenge with exact price and pay-to details (the challenge is returned before request validation).\n2. Settle with any x402 client (agentcash fetch, x402-fetch, x402-axios) and retry with the X-PAYMENT header.\n3. Responses are JSON. Prices below are fixed per call.\n\n## Paid endpoints\n- GET /api/fan/lore — $0.1 — Deep canon lore Q&A for any franchise — cites sources, distinguishes canon tiers, flags fandom debates.\n- GET /api/fan/character — $0.08 — Full character or artist profile — arc, traits, relationships, best moments, quotes, legacy, fandom perspective.\n- GET /api/fan/quiz — $0.08 — 10-question AI trivia with options, answers, explanations, and scoring guide. Easy to hard difficulty.\n- GET /api/fan/easter-eggs — $0.15 — Hidden meanings, lyric callbacks, confirmed secrets for music artists (especially Taylor Swift) and film/TV franchises.\n- GET /api/fan/discography — $0.1 — Artist catalog deep dive — eras, evolution, essential listening, underrated gems, cultural legacy.\n- GET /api/fan/sorting — $0.08 — Personality-based sorting into franchise factions — Hogwarts house, Jedi/Sith, Fellowship role, Starfleet division.\n- GET /api/fan/timeline — $0.1 — Canonical in-universe chronology — eras, pivotal events, recommended watch/read order, canon conflicts.\n- GET /api/fan/collect — $0.1 — Collectibles market intelligence — pricing by condition, authentication services (PSA/JSA/CGC/Beckett), where to buy/sell, counterfeit red flags, investment out\n- GET /api/fan/compare — $0.1 — Decisive cross-franchise comparisons — Gandalf vs Dumbledore, Beatles vs Stones, etc. Always picks a winner.\n\nMore APIs from this provider: https://pulsenetwork.theaslangroupllc.com (grouped catalog, all x402)."
  },
  "servers": [
    {
      "url": "https://fanpulse.theaslangroupllc.com"
    }
  ],
  "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 — chain after /api/fan/character; highest engagement for active fandoms",
        "x-price-usd": 0.1,
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/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 — chain to /api/fan/lore for universe context; pairs with /api/fan/compare for character comparisons",
        "x-price-usd": 0.08,
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.080000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/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 — highest engagement for community apps; pairs with /api/fan/character",
        "x-price-usd": 0.08,
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.080000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/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 — highest virality endpoint; pairs with /api/fan/timeline for chronological context",
        "x-price-usd": 0.15,
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.150000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/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 — Vinyl + streaming affiliate links; pairs with /api/fan/collect for collectible albums",
        "x-price-usd": 0.1,
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/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) — viral social content; pairs with /api/fan/character",
        "x-price-usd": 0.08,
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.080000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/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 — chain with /api/fan/lore for full universe map; useful for new fan onboarding agents",
        "x-price-usd": 0.1,
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/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 — K-pop photocard, vinyl, signed memorabilia; Amazon merch + Fanatics + Weverse links auto-appended",
        "x-price-usd": 0.1,
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/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 — viral social content; chain with /api/fan/lore for context",
        "x-price-usd": 0.1,
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    }
  }
}