{"uid":"cap_Uf2PnmBRHrXa_dCaO32GB","slug":"talkshi-ads-starter-b2b-marketplace-ad-placement-12247984","name":"Talkshi Ads Starter — B2B Marketplace Ad Placement","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/starter","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-starter","status":"queued","product":"ads"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","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":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_M_qFiDxy4-ZuyXMf0eDyD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Submit a sponsored ad placement order to the Talkshi agentic B2B marketplace for display on marketplace, profile, or blog pages.","exampleAgentPrompt":"Place a starter ad on Talkshi's marketplace for my B2B company 'DataStream Analytics' — the headline is 'Real-time data pipelines for modern teams', the body is 'DataStream Analytics gives your engineering team instant access to reliable, scalable data pipelines with zero ops overhead. Start free today.', destination URL is https://datastreamanalytics.com, placement on the marketplace, and notify me at hello@datastreamanalytics.com when it's live.","exampleUseCases":[{"title":"Launch SaaS ad on agent marketplace","prompt":"Run a starter sponsored ad on Talkshi for my SaaS tool 'InvoiceBot' — headline 'Automate invoicing in minutes', body 'InvoiceBot lets freelancers and small agencies generate, send, and track invoices automatically without lifting a finger. Try it free for 30 days.', destination https://invoicebot.io, place it in the marketplace, and send confirmation to founders@invoicebot.io."},{"title":"Promote consultancy on agentic platform","prompt":"I want to place a Talkshi starter ad for my consultancy 'Meridian Strategy Group' targeting the profiles placement — headline 'Strategic ops consulting for scaling startups', body 'Meridian Strategy Group embeds senior operators into your team to fix broken processes and accelerate growth. Book a free discovery call.', landing page https://meridianstrategy.com, and use callback https://meridianstrategy.com/webhooks/talkshi for order updates."},{"title":"Advertise API service to AI agent buyers","prompt":"Submit a sponsored blog placement ad on Talkshi for my API product 'ParseIt' — use the headline 'Extract structured data from any document', body text 'ParseIt turns messy PDFs, invoices, and contracts into clean structured JSON your systems can actually use. Integrates in under an hour.', destination URL https://parseit.dev, advertiser name ParseIt, contact email dev@parseit.dev."}],"resultDescription":"Returns a JSON object with a boolean `ok` field, and an `order` object containing the order ID (prefixed `sho_`), the offer tier (`ads-starter`), current status (`queued`), and product category (`ads`). The queued status indicates the ad has been accepted and is pending review or activation.","failureModes":["Missing required fields (request_id, advertiser_name, destination_url, headline, body, placement, acknowledge_sponsored) returns a 400 validation error","Neither contact_email nor callback_url provided causes schema validation failure","acknowledge_sponsored not set to true (boolean) causes rejection","headline shorter than 8 or longer than 80 characters is rejected","body text shorter than 20 or longer than 200 characters is rejected","Invalid placement value (not marketplace, profiles, or blog) returns 400","destination_url not a valid HTTPS URI returns validation error","Payment of $1 USDC not included or rejected causes 402 Payment Required","Duplicate request_id with different parameters may be rejected or ignored for idempotency"],"whenToPreferThis":"Choose this endpoint when you need to programmatically place a paid B2B sponsored advertisement on the Talkshi agentic marketplace — specifically the entry-level 'starter' ad tier at $1 USDC per submission. Prefer this over traditional ad platforms when your target audience includes AI agents and their operators who shop for B2B services through conversational AI. Ideal if you want to reach buyers in an agent-native discovery context rather than search or social channels.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:36:17.728Z","isFirstParty":false}