{"uid":"cap_AhwgLgDXeuovA8VOQWQnb","slug":"forgemesh-x402-ads-intent-report-e1002961","name":"ForgeMesh x402 Ads – Intent Report","description":"Returns a per-service bounce funnel: total probes, bounces, paid count, conversion rate, traffic-class split, and top abandoned endpoints. Shows why agents probe but don't pay. Free for publishers via x-publisher-key.","url":"https://ads.forgemesh.io/api/intent/report","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["service"],"properties":{"window":{"enum":["24h","7d","30d","all"],"type":"string"},"service":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"funnel":{"type":"object"},"service":{"type":"string"},"traffic_classes":{"type":"array"},"top_abandoned_endpoints":{"type":"array"}}}}}}},"responseSchema":{"type":"json","example":{"funnel":{"paid":4303,"bounces":185911,"total_probes":190214,"conversion_rate":"2.26%"},"service":"coinopai"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Pjzm_wVpsDfrp6fAvfKel","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns paid agent demand analytics for a specific x402 service, including funnel metrics like probe volume, paid conversions, bounces, and conversion rate.","exampleAgentPrompt":"Pull the intent report for the 'coinopai' service on the x402 network — I want to see how many agent probes it's getting, how many are converting to paid calls, and the bounce rate.","exampleUseCases":[{"title":"Monitor my x402 service conversion funnel","prompt":"Show me the conversion funnel analytics for my x402 service 'coinopai' — how many total agent probes, how many paid, how many bounced, and what's the conversion rate?"},{"title":"Benchmark competitor demand on x402","prompt":"I want to see the intent report for the 'imagegen' service on the x402 network — I'm trying to understand how much paid agent traffic they're pulling versus how many are just probing without paying."},{"title":"Validate product-market fit for new x402 API","prompt":"We just launched a new x402 endpoint under the service name 'translationpro' — can you pull the demand analytics report for it so I can see if agents are discovering and paying for it, or mostly bouncing?"}],"resultDescription":"A JSON object containing a funnel breakdown for the requested service: total probe count, paid conversions, bounce count, and conversion rate as a percentage string, alongside the service name identifier.","failureModes":["Unknown or unrecognized service name returns empty or null funnel data","Payment failure via x402 protocol blocks the response","Rate limiting or quota exhaustion returns an error","Stale or delayed data if analytics pipeline lags behind real-time events","Malformed service name parameter yields a 400 or empty result"],"whenToPreferThis":"Use this endpoint when you need per-service intent and conversion funnel analytics for a specific x402 service — specifically paid probe vs bounce breakdowns. Prefer it over the network-wide totals endpoint when you need granular per-service metrics rather than aggregate x402 network statistics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:38:03.119Z","isFirstParty":false}