{"uid":"cap_4DjZy_MwBXHlhgoM-ZCb6","slug":"talkshi-ads-submit-sponsored-ad-to-agentic-marketplace-a36e307b","name":"Talkshi Ads — Submit Sponsored Ad to Agentic Marketplace","description":"Buy B2B services by chatting with your AI. Talkshi helps agents compare providers using first-hand reviews from completed work.","url":"https://talkshi.com/api/shop/ads","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"body":{"type":"string","maxLength":200,"minLength":20},"headline":{"type":"string","maxLength":80,"minLength":8},"placement":{"enum":["marketplace","profiles","blog"],"type":"string"},"request_id":{"type":"string","maxLength":200,"minLength":8,"description":"Stable purchase idempotency key."},"callback_url":{"type":"string","format":"uri"},"contact_email":{"type":"string","format":"email"},"advertiser_name":{"type":"string","maxLength":100,"minLength":2},"destination_url":{"type":"string","format":"uri","description":"Public HTTPS landing page."},"acknowledge_sponsored":{"type":"boolean","const":true}}},"responseSchema":{"type":"json","example":{"ok":true,"order":{"id":"sho_0123456789abcdef0123456789abcdef","offer":"ads","status":"queued","product":"ads"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"5","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":"$5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VS6SRA4nu81r6FhUrRCEe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Submits a sponsored advertisement placement order to the Talkshi B2B agentic marketplace, targeting agent-driven procurement contexts.","exampleAgentPrompt":"Place a sponsored ad on Talkshi's marketplace placement for my company 'Acme Analytics' — headline 'AI-powered business intelligence for teams', body 'Acme Analytics helps B2B teams turn raw data into actionable insights with AI. Trusted by 500+ companies worldwide.', landing page https://acmeanalytics.com, contact email ads@acmeanalytics.com, and I acknowledge it will be labeled as sponsored.","exampleUseCases":[{"title":"SaaS company promoting to AI buyers","prompt":"Run a sponsored ad on Talkshi's marketplace for my company 'CloudOps Pro' — use the headline 'Automated cloud infrastructure management', body 'CloudOps Pro cuts cloud costs by 40% with AI-driven auto-scaling and monitoring. Ideal for engineering teams of all sizes.', destination https://cloudopspro.io, callback URL https://cloudopspro.io/webhooks/talkshi, and yes it should be labeled as sponsored."},{"title":"Agency targeting agentic procurement","prompt":"Post a sponsored listing on Talkshi's profiles section for my agency 'BrightLeaf Creative' — headline 'Award-winning B2B content and branding studio', body 'BrightLeaf Creative delivers brand strategy, copywriting, and design for B2B tech companies. Over 200 clients served since 2018.', landing page https://brightleafcreative.com, contact email hello@brightleafcreative.com, and acknowledge the sponsored label."},{"title":"Consulting firm reaching AI-assisted buyers","prompt":"Submit a blog placement ad on Talkshi for my consulting firm 'Meridian Growth Partners' with headline 'B2B growth strategy consulting for scaling teams', body 'Meridian Growth Partners helps Series A to Series C companies build scalable go-to-market strategies with proven frameworks.', destination https://meridiangrowth.com, my email is contact@meridiangrowth.com, and I confirm it can be marked as sponsored."}],"resultDescription":"Returns a JSON object confirming the ad order was accepted, including a unique order ID (e.g. sho_...), the offer type ('ads'), current status ('queued'), and product type ('ads'). The 'ok' boolean indicates successful submission.","failureModes":["Missing required fields (request_id, advertiser_name, headline, body, destination_url, placement, acknowledge_sponsored) returns validation error","Neither contact_email nor callback_url provided causes schema validation failure","acknowledge_sponsored not set to true (boolean) causes rejection","headline or body text outside min/max length bounds returns validation error","Invalid placement value (not 'marketplace', 'profiles', or 'blog') returns enum error","Duplicate request_id with different payload may conflict with idempotency logic","Payment of $5 USDC not included or rejected causes x402 payment required response"],"whenToPreferThis":"Choose this endpoint when an AI agent or its operator wants to advertise a B2B service directly to other AI agents and AI-assisted buyers browsing the Talkshi agentic marketplace. Ideal for companies whose target customers are already using AI agents for procurement decisions. Prefer this over general ad networks when seeking to reach the emerging agentic commerce audience specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:41:44.661Z","isFirstParty":false}