{"openapi":"3.1.0","info":{"title":"ForgeMesh x402 Ads","version":"1.0.0","description":"Paid agent demand analytics and intent signals via x402. See what AI agents are searching for across the x402 network.","contact":{"email":"clawdbotworker@gmail.com"},"x-guidance":"Use this API when the user wants to understand agent demand patterns, see what AI agents are searching for, identify trending categories in the x402 economy, or monetize their own API with recommendations. Returns real cross-network agent intent data — not web analytics. Example questions: 'What are AI agents searching for right now?', 'Show me demand trends in the x402 ecosystem', 'Which API categories have the most agent traffic?', 'How is my service performing vs the network?'. Routes: GET /api/intent/trends ($0.01) for cross-network agent demand signals, GET /api/intent/demand?category=X ($0.02) for per-category breakdown, GET /api/intent/report?service=X ($0.05) for a service conversion funnel, GET /api/network/stats ($0.005) for network totals. Publishers: install @forgemeshlabs/x402-ads (npm) to monetize your 402 responses with typed recommendation blocks."},"servers":[{"url":"https://ads.forgemesh.io"}],"paths":{"/":{"get":{"summary":"Service landing","security":[],"responses":{"200":{"description":"OK"}}}},"/health":{"get":{"summary":"Health check","security":[],"responses":{"200":{"description":"OK"}}}},"/terms":{"get":{"summary":"Terms of service + complete data-collection disclosure","security":[],"responses":{"200":{"description":"Plain-text terms"}}}},"/v1/decide":{"post":{"summary":"Get a recommendations block (typed items: sponsored + similar x402 services) for a 402 context","security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"service":{"type":"string","description":"your service id"},"endpoint":{"type":"string","description":"the probed path"},"category":{"type":"string","description":"service category, e.g. finance, weather, images"},"price":{"type":"string","description":"price of the probed endpoint"}}}}}},"responses":{"200":{"description":"Recommendations block","content":{"application/json":{"schema":{"type":"object","properties":{"recommendations":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["sponsored","similar"]},"title":{"type":"string"},"endpoint":{"type":"string"},"price":{"type":"string"},"link":{"type":"string"}}}}}}}}}}}}}},"/v1/events":{"post":{"summary":"Batch-ingest unpaid-probe events (publisher key required)","security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"service":{"type":"string"},"endpoint":{"type":"string"},"method":{"type":"string"},"status":{"type":"integer"},"ua":{"type":"string"},"price":{"type":"string"},"category":{"type":"string"},"ts":{"type":"integer"}},"required":["service","endpoint"]}}},"required":["events"]}}}},"responses":{"200":{"description":"Ingest result"},"401":{"description":"Missing/invalid x-publisher-key"}}}},"/v1/publishers/register":{"post":{"summary":"Self-serve publisher registration — paying wallet becomes your identity, key returned once, service id bound at registration","security":[],"x-x402-price":"$0.10","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.10"},"protocols":[{"x402":{}}]},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"service_url":{"type":"string","description":"public https URL of the x402 service you operate"},"name":{"type":"string","description":"display name (default: hostname)"},"categories":{"type":"array","items":{"type":"string"},"description":"up to 5 category labels"},"contact":{"type":"string","description":"optional contact email"},"terms_accepted":{"type":"boolean","description":"must be true — see /terms"}},"required":["service_url","terms_accepted"]}}}},"responses":{"200":{"description":"publisher_id + publisher_key (shown once) + bound service_id","content":{"application/json":{"schema":{"type":"object","properties":{"publisher_id":{"type":"string"},"publisher_key":{"type":"string"},"wallet":{"type":"string"},"service_id":{"type":"string"},"terms_version":{"type":"string"}}}}}},"400":{"description":"Invalid request — rejected before payment, nothing charged"},"402":{"description":"x402 payment challenge"}}}},"/api/network/stats":{"get":{"summary":"Network-wide intent stats","security":[],"x-x402-price":"$0.005","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}}}},"/api/intent/trends":{"get":{"summary":"Top requested endpoints/categories by agents","security":[],"x-x402-price":"$0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","enum":["24h","7d","30d","all"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"window":{"type":"string"},"limit":{"type":"integer"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}}}},"/api/intent/demand":{"get":{"summary":"Category demand depth","security":[],"x-x402-price":"$0.02","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"parameters":[{"name":"category","in":"query","required":true,"schema":{"type":"string"}},{"name":"window","in":"query","required":false,"schema":{"type":"string","enum":["24h","7d","30d","all"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"window":{"type":"string"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}}}},"/api/intent/report":{"get":{"summary":"Per-service why-agents-didn't-buy report","security":[],"x-x402-price":"$0.05","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"parameters":[{"name":"service","in":"query","required":true,"schema":{"type":"string"}},{"name":"window","in":"query","required":false,"schema":{"type":"string","enum":["24h","7d","30d","all"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"service":{"type":"string"},"window":{"type":"string"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"}}}}},"x-x402":{"network":"eip155:8453","payTo":"0x65E02cB7Fee27630bB7d1a3ADd02Ef7Aa2D21701","facilitator":"https://x402.xyz/facilitate"},"provider":{"name":"ForgeMesh Labs","catalog":"POST https://x402.forgemesh.io/fleet-products ($0.05)","fleet":"11 x402 services and counting, 500+ paid endpoints, from $0.001 — one wallet, no signup, atomic USDC settlement on Base. Free index: https://x402.forgemesh.io/llms.txt"}}