{ "openapi": "3.1.0", "info": { "title": "FranchisePulse API", "description": "Global franchise intelligence API. AI-synthesized franchise discovery, FDD analysis, total cost modeling, SBA loan analysis, resale valuation, online/absentee franchise opportunities, and franchise broker comparison. Covers 4,000+ active US franchises plus international expansion opportunities. SBA lender affiliates (Benetrends, FranFund, Guidant), FranNet consultant network, and BizBuySell marketplace included. All endpoints support any language via ?lang=. Pricing: $0.10–$0.20 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": "# FranchisePulse API (x402 pay-per-call)\n\nNeutral franchise discovery and due diligence engine. 9 endpoints covering FDD analysis (Item 7/19/20/21), franchise opportunity discovery, comparison, due diligence vetting, total cost analysis, resale listings, online business acquisition, SBA financing, and broker conflict-of-interest education. Pay-per-query via x402 micropayments on Base.\n\nBase URL: https://franchisepulse.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/franchise/fdd — $0.2 — FDD analysis — Item 7 (total investment), Item 19 (unit economics), Item 20 (opened/closed units), Item 21 (financials), ongoing fees, verdict. Highest-value re\n- GET /api/franchise/discover — $0.15 — Ranked franchise opportunities filtered by industry, max investment, territory type, and ownership style. Neutral — not broker-curated.\n- GET /api/franchise/compare — $0.15 — Side-by-side comparison of 2-3 franchise concepts with standardized metrics and decisive recommendation.\n- GET /api/franchise/vet — $0.15 — Due diligence on a named franchisor — litigation, failure rates, franchisee satisfaction, FTC actions, verdict: looks_legitimate|proceed_with_caution|avoid|insu\n- GET /api/franchise/total-cost — $0.1 — All-in investment breakdown: initial costs, all ongoing fees, 5-year projection, break-even estimate, hidden costs checklist.\n- GET /api/franchise/resale — $0.1 — Existing franchise units for sale on BizBuySell and BizQuest with SDE multiples, seller financing flags, and acquisition due diligence checklist.\n- GET /api/franchise/online — $0.1 — Digital businesses for sale on Empire Flippers, Flippa, Acquire.com — SaaS, content, ecommerce with current market multiples.\n- GET /api/franchise/sba — $0.08 — SBA Franchise Registry eligibility check, SBA 7(a)/504 overview, ROBS 401k rollover structure, franchise-specialized lender guidance.\n- GET /api/franchise/broker — $0.08 — Franchise broker and consultant education — how they are paid, conflicts of interest, red flags, how to find independent advisors, questions to ask.\n\nMore APIs from this provider: https://pulsenetwork.theaslangroupllc.com (grouped catalog, all x402)." }, "servers": [ { "url": "https://franchisepulse.theaslangroupllc.com" } ], "paths": { "/api/franchise/fdd": { "get": { "summary": "Franchise Disclosure Document analysis", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "franchisor", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "lang", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Item 7/19/20/21 analysis, ongoing fees, 5-year projection, verdict" }, "402": { "description": "$0.20" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "FDD analysis — chain after /api/franchise/discover for detailed due diligence; pairs with LegalPulse for FDD legal review", "x-price-usd": 0.2, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.200000" }, "protocols": [ { "x402": {} } ] } } }, "/api/franchise/discover": { "get": { "summary": "Franchise opportunity discovery", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "industry", "in": "query", "schema": { "type": "string" } }, { "name": "investment_max", "in": "query", "schema": { "type": "string" } }, { "name": "type", "in": "query", "schema": { "type": "string" }, "description": "new_unit|resale|both" }, { "name": "territory", "in": "query", "schema": { "type": "string" } }, { "name": "lang", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Ranked franchise opportunities with investment, royalty, Item 19 status, red flags" }, "402": { "description": "$0.15" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Start here for franchise discovery — SBA lender + consultant affiliate links auto-appended; chain to /api/franchise/total-cost for investment analysis", "x-price-usd": 0.15, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.150000" }, "protocols": [ { "x402": {} } ] } } }, "/api/franchise/compare": { "get": { "summary": "Side-by-side franchise comparison", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "concepts", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Comma-separated franchise names (min 2)" }, { "name": "lang", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Comparison table with decisive recommendation" }, "402": { "description": "$0.15" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Side-by-side franchise comparison — chain after /api/franchise/discover to shortlist candidates", "x-price-usd": 0.15, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.150000" }, "protocols": [ { "x402": {} } ] } } }, "/api/franchise/vet": { "get": { "summary": "Franchise due diligence", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "franchisor", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "lang", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Litigation, failure rates, franchisee satisfaction, verdict" }, "402": { "description": "$0.15" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Franchise vetting — run before any investment; chain with /api/franchise/fdd for comprehensive due diligence", "x-price-usd": 0.15, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.150000" }, "protocols": [ { "x402": {} } ] } } }, "/api/franchise/total-cost": { "get": { "summary": "All-in investment and cost analysis", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "franchisor", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "lang", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Full cost breakdown, 5-year projection, break-even estimate" }, "402": { "description": "$0.10" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Total investment calculator — chain after /api/franchise/discover; SBA financing links auto-appended", "x-price-usd": 0.1, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } }, "/api/franchise/resale": { "get": { "summary": "Existing franchise units for sale", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "industry", "in": "query", "schema": { "type": "string" } }, { "name": "location", "in": "query", "schema": { "type": "string" } }, { "name": "max_price", "in": "query", "schema": { "type": "string" } }, { "name": "lang", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Franchise resale listings with SDE multiples and due diligence checklist" }, "402": { "description": "$0.10" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Existing franchise acquisition — BizBuySell affiliate link included; often better ROI than new franchise", "x-price-usd": 0.1, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } }, "/api/franchise/online": { "get": { "summary": "Online business acquisition discovery", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "category", "in": "query", "schema": { "type": "string" }, "description": "SaaS|content|ecommerce|newsletter|app|service" }, { "name": "min_revenue", "in": "query", "schema": { "type": "string" } }, { "name": "max_multiple", "in": "query", "schema": { "type": "string" } }, { "name": "lang", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Digital businesses for sale with market multiples context" }, "402": { "description": "$0.10" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Online/absentee franchise opportunities — pairs with CareerPulse for income replacement modeling", "x-price-usd": 0.1, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } }, "/api/franchise/sba": { "get": { "summary": "SBA eligibility and franchise financing", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "franchisor", "in": "query", "schema": { "type": "string" } }, { "name": "loan_amount", "in": "query", "schema": { "type": "string" } }, { "name": "lang", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "SBA registry status, 7(a)/504 overview, ROBS structure, lender guidance" }, "402": { "description": "$0.08" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "SBA 7(a) loan analysis — SBA lender affiliate links auto-appended; pairs with WealthPulse for capital allocation", "x-price-usd": 0.08, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.080000" }, "protocols": [ { "x402": {} } ] } } }, "/api/franchise/broker": { "get": { "summary": "Franchise broker and consultant guidance", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "location", "in": "query", "schema": { "type": "string" } }, { "name": "specialty", "in": "query", "schema": { "type": "string" } }, { "name": "lang", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Broker compensation conflicts, red flags, how to find independent advisors" }, "402": { "description": "$0.08" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Franchise broker comparison — FranNet + franchise consultant affiliates included", "x-price-usd": 0.08, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.080000" }, "protocols": [ { "x402": {} } ] } } } } }