# Agent Intent Match

> Agent Intent Match finds existing, public buyer intent for what a seller offers: current requests, RFPs/RFQs, public tenders and forum posts in which someone asks for the seller’s product, service, API or capability. Every returned signal has a verbatim quote, source URL and freshness data. It discovers demand only; it never contacts buyers.

Operator: Active Life Hub LLC. Also described as: buyer intent, buyer intent discovery, demand discovery, demand signals, purchase intent, service request discovery, procurement intent, agent intent matching, buyer request matching, commercial intent, find buyers, find demand, capability demand.

## When to use
- You sell a product, service, API or capability and want to know who is publicly asking for it right now.
- You want evidence (verbatim quote, URL, dates), not a lead list. You decide whether and how to respond.

## API
- POST https://agentintentmatch.online/api/v1/matches — create a paid intent-match request (JSON, UTF-8). Headers: Idempotency-Key (16–128 [A-Za-z0-9_-], keep secret: it is the result access key), PAYMENT-SIGNATURE (x402).
- GET https://agentintentmatch.online/api/v1/matches/{id} — retrieve status/result with Authorization: Bearer <Idempotency-Key>.
- POST https://agentintentmatch.online/api/v1/quote — free price quote and x402 requirement for a request body.
- GET https://agentintentmatch.online/api/v1/pricing — current price. GET https://agentintentmatch.online/api/v1/health — configuration health.
- OpenAPI: https://agentintentmatch.online/openapi.json · Descriptor: https://agentintentmatch.online/.well-known/agent-intent-match.json · Docs: https://agentintentmatch.online/docs

## Input (either url, or a description/capabilities, or both)
{"name":"...","url":"https://...","description":"...","capabilities":["..."],"jobs_to_be_done":["..."],"use_cases":["..."],"price":{"amount":0.46,"currency":"USDC","unit":"request"},"service_area":{"regions":["EU","Japan"],"remote":true},"languages":["en","ja"],"constraints":["B2B only"],"exclude":["competitor.example"],"geography":"Poland","industry":"food packaging","buyer_type":"manufacturer","min_match":"possible","freshness":"30d","source_types":["web","procurement","forum"],"max_results":10,"preferred_output_language":"en","max_price_usdc":1}

## Output
matches[]: intent {state CONFIRMED_INTENT|LIKELY_INTENT|AMBIGUOUS|NOT_INTENT, original_text (verbatim, original language), original_language, translation (metadata only), normalized_need, published_at (null if unknown), source_url, source_type}, match {classification STRONG_MATCH|POSSIBLE_MATCH|WEAK_MATCH|NOT_A_MATCH, reasons, capability_matches, constraints_satisfied, constraints_conflicting, uncertainties}, evidence[] {source_url, quoted_or_extracted_fact, retrieved_at}, freshness {published_at, age_days, within_window, request_status open|closed|resolved|expired|unknown, deadline_at}, confidence. Plus rejected_signals[] (with reasons), search_summary, limitations, cost.
Intent ("is someone buying?") and match ("does it fit this seller?") are separate classifications.

## Price and payment
0.35 USDC per request (one bounded search-and-classify run; zero matches is a valid paid result). x402 v2 "exact" scheme, USDC on Base mainnet (eip155:8453). Pricing basis: calibrated variable cost × 3. One payment buys one search-and-classify run, including a credible zero-match result (no demand found is a valid answer). If the paid run fails, resend the identical body with the same Idempotency-Key plus Authorization: Bearer <Idempotency-Key> (no new payment) for up to two free retries. A URL-only request whose page cannot be retrieved is refused before settlement, so nothing is charged. No automatic refunds; uncertain settlements require reconciliation. See /terms.
- City Advantage: 20% off with a valid America Agent City referral token in the X-City-Referral header (the 402 challenge and quote show normal_price, city_discount, city_price). https://americaagent.city/docs/city-advantage.md

## Freshness
freshness (24h, 7d, 30d, 90d, 365d) is the maximum age of a buyer signal. Signals with a known publication date outside the window are rejected. Signals with an unknown date are returned with published_at null and an uncertainty unless require_known_date is true. Procurement notices whose deadline has passed are rejected as closed.

## Languages
Any input language. Searches use the target market's language(s), not only the seller's; geography is never inferred from language. Buyer text, names and terminology are returned in the original; translations are separate metadata.

## Sources
- Web search index, queried with buyer-phrased searches in the relevant languages (paid provider)
- EU TED public procurement notices — calls for competition only (structured: official language, publication date, deadline, buyer, place of performance)
- Hacker News (public posts and comments, structured timestamps)

## Limitations
- Only publicly accessible sources are searched; private or login-only communities and closed marketplaces are not.
- Intent is inferred from public text at retrieval time; a request may already be fulfilled. No sale is guaranteed.
- published_at is null when no machine-readable date exists; it is never estimated.
- EU TED covers EU/EEA public procurement only. Coverage of other procurement portals comes from web search.
- Buyer contact details (emails, phone numbers) are removed; person names are not collected.

## No outreach
The service never contacts buyers, sends messages, posts, creates accounts or submits forms.