{ "openapi": "3.1.0", "info": { "title": "FindPulse API", "description": "Universal finder and discovery API. AI-synthesized best product recommendations, alternative product discovery, grant and scholarship search, used/refurbished alternatives, hidden deals, local business discovery, product recall alerts, and rental vs. buy analysis. Covers global product catalog with Amazon affiliate links, cashback via Rakuten, and price tracking via CamelCamelCamel. Scholarship search via Bold.org and ScholarshipOwl for education verticals. 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://findpulse-omega.vercel.app" } ], "paths": { "/api/find/product": { "get": { "summary": "Best product for use case", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "use_case", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "schema": { "type": "string" } }, { "name": "preferences", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Ranked recommendations with Amazon links" }, "402": { "description": "$0.10" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Best-product-for-use-case finder \u2014 Amazon + price tracker affiliates auto-appended; start here for any product query", "x-price-usd": 0.1 } }, "/api/find/compare": { "get": { "summary": "Head-to-head product comparison", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "products", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Comparison table with winner by use case" }, "402": { "description": "$0.10" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Head-to-head product comparison \u2014 chain after /api/find/product to validate choice; Amazon links auto-included", "x-price-usd": 0.1 } }, "/api/find/alternative": { "get": { "summary": "Cheaper alternatives", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "product", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Alternatives with similarity ratings and trade-offs" }, "402": { "description": "$0.08" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Alternative/competitor product finder \u2014 chain after /api/find/product when budget is tight; pairs with DealPulse", "x-price-usd": 0.08 } }, "/api/find/hidden": { "get": { "summary": "Hidden gem products", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "category", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "use_case", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Underrated products enthusiasts recommend" }, "402": { "description": "$0.08" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Hidden gems and underrated alternatives \u2014 highest differentiation; pairs with /api/find/alternative", "x-price-usd": 0.1 } }, "/api/find/used": { "get": { "summary": "Used/refurbished sourcing guide", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "product", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Where to buy, price ranges, inspection checklist" }, "402": { "description": "$0.08" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Used/refurbished alternatives \u2014 significant savings for big-ticket items; pairs with DealPulse /api/deals/history", "x-price-usd": 0.08 } }, "/api/find/local": { "get": { "summary": "Local professional vetting", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "service", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "location", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Finding and vetting guide with red flags" }, "402": { "description": "$0.10" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Local business discovery and recommendation \u2014 hyperlocal context; pairs with TravelPulse for travel-based discovery", "x-price-usd": 0.08 } }, "/api/find/grant": { "get": { "summary": "Grant and funding finder", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "category", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "demographic", "in": "query", "schema": { "type": "string" } }, { "name": "location", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Matched grants with application strategy" }, "402": { "description": "$0.10" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Business and nonprofit grant finder \u2014 Bold.org affiliate included; pairs with GrantPulse for funded grant writing", "x-price-usd": 0.08 } }, "/api/find/scholarship": { "get": { "summary": "Scholarship finder", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "field", "in": "query", "schema": { "type": "string" } }, { "name": "profile", "in": "query", "schema": { "type": "string" } }, { "name": "state", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Matched scholarships with overlooked sources" }, "402": { "description": "$0.10" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Scholarship search \u2014 Bold.org + ScholarshipOwl affiliates auto-appended; pairs with EduPulse", "x-price-usd": 0.08 } }, "/api/find/rental": { "get": { "summary": "Rent vs buy analysis", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "item", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "location", "in": "query", "schema": { "type": "string" } }, { "name": "frequency", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Rent vs buy verdict with break-even and where to rent" }, "402": { "description": "$0.08" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Rent vs. buy analysis \u2014 pairs with DealPulse for pricing context; PropPulse for real estate overlay", "x-price-usd": 0.1 } }, "/api/find/recall": { "get": { "summary": "Product recall lookup", "parameters": [ { "name": "PAYMENT-SIGNATURE", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "product", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Recall status with risk level and action steps" }, "402": { "description": "$0.05" } }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Product safety recall alerts \u2014 CPSC + NHTSA data; most critical safety endpoint", "x-price-usd": 0.05 } } } }