{"uid":"cap_BNoxTt4FcJI_mtVoZe3Yb","slug":"agents-trust-api-recommender-65739997","name":"Agents Trust API Recommender","description":"API recommendation and x402 discovery for your task. Required query: need. Which API should I call? Describe a task in plain words and let Recommend find the right x402 API: up to five paid APIs, with URLs, prices, payment networks and how to call each. Agent API recommendations include paid delivery evidence and risk flags. Which API should my agent use? Required: need=. Discovery quote only; signed requests without need are rejected.","url":"https://api.agents-trust.com/recommend?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["need"],"properties":{"live":{"enum":[1],"type":"integer","default":1,"description":"Only live=1 is supported. Returned picks do not always have a current payment challenge. Free demo needs (weather, crypto prices, web search) can skip this check, as can paid answers. Unconstrained picks may use a positive stored liveness probe within 72 hours or remain unknown after a bounded fallback. Explicit chain or price filters require a validated challenge. A pick without a validated challenge has payment_preflight.status=not_checked, has_valid_recent_challenge=false and selected_offer=null. Read liveness_source, liveness_checked_at and payment_preflight.checked_at; none verifies paid delivery."},"need":{"type":"string","maxLength":300,"minLength":2,"description":"A phrase describing the required work, with at least two letters or digits. The limit counts Unicode characters in the original input, including whitespace. Accepted text is normalized without truncation and matched against indexed endpoint descriptions."},"view":{"enum":["legacy","compact","evidence","debug"],"type":"string","default":"legacy","description":"Legacy preserves successful-response fields and types. The other views use recommend.v2. Compact includes routing facts, evidence adds measurements, and debug adds bounded retrieval diagnostics."},"chain":{"type":"string","pattern":"^[a-z0-9-]{2,16}:[A-Za-z0-9_=-]{1,64}$","description":"Provider payment network in CAIP-2 form, such as eip155:8453. This does not identify the blockchain analyzed by the service."},"limit":{"type":"integer","default":3,"maximum":5,"minimum":1,"description":"Maximum number of picks. Fewer results are returned when evidence is insufficient."},"max_price_usd":{"type":"number","minimum":0,"description":"Maximum nominal USD price of the selected provider offer. Separate from the 0.01 USDC recommendation fee. The provider challenge at call time is authoritative."}},"additionalProperties":false}}},"output":{"type":"object","properties":{"type":{"const":"json"},"example":{"type":"object","required":["picks"],"properties":{"picks":{"type":"array","items":{"type":"object","required":["url","description","selected_offer","risk_flags","delivery_verification"],"properties":{"url":{"type":"string"},"risk_flags":{"type":"array","items":{"type":"string"}},"description":{"type":["string","null"]},"selected_offer":{"anyOf":[{"type":"null"},{"type":"object","required":["price_usd","network"],"properties":{"network":{"type":"string"},"price_usd":{"type":["number","null"]}}}]},"delivery_verification":{"type":"object","required":["status"],"properties":{"status":{"enum":["not_tested","verified","quality_issue","failed_delivery",null],"type":["string","null"]},"delivery_result":{"type":["string","null"]}}}}}}}}},"description":"Illustrative customer-facing excerpt of a compact answer. Full response, errors and payment headers: https://agents-trust.com/openapi.json#/paths/~1recommend/get/responses"}}},"responseSchema":{"type":"json","example":{"picks":[{"url":"https://api.ideafactorylab.org/x402/weather","risk_flags":["SELLER_DESCRIPTION_UNVERIFIED","REQUIRED_INPUT_UNKNOWN"],"description":"Current weather for any city. Pass ?city=London","selected_offer":{"network":"eip155:8453","price_usd":0.001},"delivery_verification":{"status":"verified","delivery_result":"delivered"}}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qCZMeIAeMxhhG7V8prngL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches and recommends candidate paid x402 APIs matching a plain-language task description, returning ranked URLs, prices, payment terms, delivery evidence, and risk flags.","exampleAgentPrompt":"Search Agents Trust for up to 3 paid APIs that can do weather forecasting, priced under $0.05 each, and show me the compact view with delivery evidence and any risk flags.","exampleUseCases":[{"title":"Discover cheap geocoding APIs","prompt":"Find me up to 3 x402 APIs that can geocode addresses, priced under $0.02 each — I need to see their payment terms and whether delivery has been verified."},{"title":"Pre-flight API selection for translation task","prompt":"Before I pay anything, can you search for paid APIs that do text translation from English to Spanish and show me the risk flags and match strength for each one?"},{"title":"Budget-constrained API discovery for sentiment analysis","prompt":"Look up APIs that can do sentiment analysis on text, limit results to 2, and filter to ones costing no more than $0.01 per call so I can compare options before committing."}],"resultDescription":"A JSON object containing a ranked list of candidate API picks, each with: the callable URL, pricing and payment offer details (asset, amount, network, pay_to address), delivery verification evidence level, risk flags (e.g. SELLER_DESCRIPTION_UNVERIFIED), match strength, reason codes, and invocation status. Also includes metadata like result count, match strength summary, and a documentation URL.","failureModes":["No matching APIs found for the given need description — returns empty picks array","need query too vague or too short — validation error","max_price_usd filter too restrictive — results may be empty","chain filter returns no results if no APIs exist on that network","Retrieval floor widening triggered if initial search returns no results; flag set if widening also fails","Response may be unpaid/truncated if x402 fee not settled"],"whenToPreferThis":"Use this endpoint when an AI agent needs to dynamically discover and evaluate which paid x402 APIs can fulfill a specific subtask before committing payment. Especially valuable when the target API is unknown, when price budgets must be enforced, or when delivery verification evidence is required before trusting a vendor. Prefer over static API directories when freshness, payment proof, and risk assessment matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T00:31:04.273Z","isFirstParty":false,"canonicalSlug":"agents-trust-api-recommender-65739997"}