# FindPulse

> Product discovery intelligence API — best-product-for-use-case, head-to-head comparisons, cheaper alternatives, hidden gems, used/refurbished sourcing, local professional vetting, grants, scholarships, rent vs buy, and product recall lookup. Pay-per-query via x402 on Base.

## What This Is

FindPulse answers "what should I buy/hire/use?" — the research layer before the transaction. Distinct from DealPulse (which finds the best price on something already chosen), FindPulse helps you find the right thing in the first place.

## Payment

All endpoints require x402 micropayment (USDC on Base mainnet).
Protocol: x402 | Network: eip155:8453 | Asset: USDC
Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

## Endpoints

GET /api/find/product?use_case={use_case}&budget={budget}&preferences={prefs}
- Returns: ranked recommendations with honest trade-offs, Amazon links, buy-or-wait signal
- use_case required
- Price: $0.10

GET /api/find/compare?products={product1+vs+product2}
- Returns: head-to-head table, overall winner, use-case guide, hidden differences
- products required
- Price: $0.10

GET /api/find/alternative?product={product}&budget={budget}
- Returns: ranked alternatives with similarity ratings, what you keep/lose, splurge verdict
- product required
- Price: $0.08

GET /api/find/hidden?category={category}&use_case={use_case}
- Returns: underrated gems with why-overlooked, who recommends them, caveats
- category required
- Price: $0.08

GET /api/find/used?product={product}
- Returns: is-it-worth-buying-used verdict, price guide, best sources, inspection checklist, red flags
- product required
- Price: $0.08

GET /api/find/local?service={service}&location={location}
- Returns: where to find, licensing/insurance requirements, interview questions, red flags, fair price range
- service required
- Price: $0.10

GET /api/find/grant?category={category}&demographic={demographic}&location={location}
- Returns: matched grants with competitiveness rating, application tips, quick wins, free help sources
- category required
- Price: $0.10

GET /api/find/scholarship?field={field}&profile={profile}&state={state}
- Returns: matched scholarships, hidden opportunities, FAFSA note, institutional aid advice
- field or profile required
- Price: $0.10

GET /api/find/rental?item={item}&location={location}&frequency={frequency}
- Returns: rent vs buy verdict with break-even uses, where to rent, hidden ownership costs
- item required
- Price: $0.08

GET /api/find/recall?product={product}
- Returns: recall status, agency, hazard, risk level, immediate action, serial number check
- product required
- Price: $0.05

## Discovery

- OpenAPI spec: https://findpulse-omega.vercel.app/openapi.json
- Agent discovery: https://findpulse-omega.vercel.app/.well-known/agent.json

## Notes for AI Agents

- Natural flow: /api/find/product → DealPulse /api/deals/history for best price
- /api/find/product and /api/find/alternative include Amazon URLs (affiliate tag auto-injected)
- /api/find/recall is the lowest-cost safety check — always relevant when buying used
- Grant/scholarship endpoints have 2500 max tokens for comprehensive results