{"uid":"cap_mVC6guFuWudhnnldj_uRA","slug":"ai-agent-hub-ad-impression-retrieval-6c191a2b","name":"AI Agent Hub Ad Impression Retrieval","description":"Pay a fraction of a cent to retrieve an ad payload for a given adId","url":"https://ai-agent-hub-backend-odzo.onrender.com/api/ads/impression","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"adId":{"type":"string","description":"The id of the ad to retrieve"},"agentId":{"type":"string","description":"Optional registered agent id for attribution"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JdXDpJWG6_SYyc0CWLKfI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches an ad payload for a given ad ID, recording an impression, in exchange for a micropayment","exampleAgentPrompt":"Fetch the ad payload for ad ID 'ad_abc123' from AI Agent Hub so I can display it — use my agent ID 'agent_xyz' for attribution.","exampleUseCases":[{"title":"Agent monetization via ad display","prompt":"Load the ad content for ad ID 'ad_789xyz' from AI Agent Hub using my registered agent ID 'agent_001' so I can render it inline for the user."},{"title":"Anonymous ad impression fetch","prompt":"Retrieve the ad payload for ad ID 'ad_promo42' — I don't have a registered agent ID, just fetch the ad so I can display it."},{"title":"Attributing impressions to a specific agent","prompt":"Pull the ad for ID 'ad_brand55' and make sure the impression is attributed to my agent 'agent_market_bot' so I get credit for the display."}],"resultDescription":"Returns a structured ad payload containing the creative content (e.g. text, image URL, link, title, description) for the specified ad, and records that an impression occurred. The micropayment of $0.001 USDC is charged per successful call.","failureModes":["Invalid or unknown adId returns an error or empty payload","Missing adId field causes a 400 bad request","Payment failure prevents ad retrieval","Network timeout on the Render-hosted backend","Invalid agentId format may cause attribution failure but not block the request"],"whenToPreferThis":"Use this endpoint when an AI agent needs to fetch and display a specific ad by its known ID, particularly within the AI Agent Hub ecosystem where micropayment-based ad monetization is expected. Prefer this over generic ad networks when you already have a specific adId and want per-impression attribution to a registered agent ID.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:31:59.080Z","isFirstParty":false}