# 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}&country={country}&location={location}
- Returns: matched grants worldwide (US, UK, EU, Canada, Australia, Germany, India and beyond) with competitiveness rating, application tips, quick wins, free help sources
- category required; country optional but recommended — omitting it does not default to US, it broadens the search across major national/regional systems
- Price: $0.10

GET /api/find/scholarship?field={field}&profile={profile}&country={country}&state={state}
- Returns: matched scholarships worldwide, including international-student awards (Chevening, Fulbright, DAAD, MEXT, Australia Awards), hidden opportunities, applicable financial-aid system note (FAFSA/US, Student Finance/UK, OSAP/Canada, Centrelink/Australia, BAföG/Germany, NSP/India, etc.), institutional aid advice
- field or profile required; country optional but recommended — omitting it does not default to US
- 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

GET /api/find/ethical?product_or_category={category}&values={values}&budget={budget}&lang={lang}
- Returns: ranked ethically-sourced recommendations with certifications, honest trade-offs, greenwashing cautions, where to buy, verify-before-you-buy checklist
- product_or_category required; values is a comma list (fair-trade, cruelty-free, vegan, sustainable, union-made, small-business, plastic-free)
- Price: $0.10

## Discovery

- OpenAPI spec: https://findpulse.theaslangroupllc.com/openapi.json
- Agent discovery: https://findpulse.theaslangroupllc.com/.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
- Grant/scholarship endpoints are global-first: pass ?country= for a specific country; omitting it searches across major systems (US, UK, EU, Canada, Australia, Germany, India) rather than assuming US
- /api/find/ethical only cites certifications it is confident are current; uncertain claims are flagged "verify current status" rather than asserted