{"uid":"cap_h772l3YI46P61uEaRzArr","slug":"talkshi-shop-reviews-first-hand-b2b-service-evaluation-ead35aa3","name":"Talkshi Shop Reviews — First-Hand B2B Service Evaluation","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/reviews","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"company":{"type":"string","maxLength":200,"minLength":2},"test_url":{"type":"string","format":"uri","description":"Public HTTPS surface Talkshi can attempt first-hand."},"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"},"evaluation_goal":{"type":"string","maxLength":1000,"minLength":40},"acknowledge_independence":{"type":"boolean","const":true}}},"responseSchema":{"type":"json","example":{"ok":true,"order":{"id":"sho_0123456789abcdef0123456789abcdef","offer":"reviews","status":"queued","product":"reviews"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"50","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":"$50/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"50","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"50","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lSjuWo9lXuhpBzFYDBzZN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"50","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Commissions an independent first-hand evaluation of a B2B company or service and returns verified reviews based on real test interactions.","exampleAgentPrompt":"Can you commission a first-hand Talkshi review of Acme Analytics — their public site is https://acmeanalytics.com — and I want to understand whether their data pipeline integrations actually work reliably for mid-market SaaS companies? Use request ID 'acme-eval-2024-06' and send results to me at buyer@mycompany.com.","exampleUseCases":[{"title":"Vendor due diligence before contract","prompt":"Before we sign with CloudBase for our data warehouse needs, can you get a Talkshi first-hand review of them? Their site is https://cloudbase.io — I want to know if their onboarding and API reliability hold up in practice. Use request ID 'cloudbase-dd-2024-09' and email the findings to procurement@ourcompany.com."},{"title":"Comparing competing SaaS tools","prompt":"We're deciding between two marketing automation platforms. Can you trigger a Talkshi evaluation of SendFlow at https://sendflow.app to see how their campaign builder and deliverability actually perform? Set the request ID to 'sendflow-eval-q3' and send results to our callback at https://ourplatform.com/webhooks/reviews."},{"title":"Checking a new AI API vendor","prompt":"I've heard good things about NeuralRoute but I want independent proof before we integrate. Please have Talkshi do a real hands-on test of their API at https://neuralroute.ai — specifically whether their latency and accuracy claims check out for production workloads. Use ID 'neuralroute-test-001' and notify me at tech@myco.com when done."}],"resultDescription":"Returns a JSON object with an order confirmation including a unique order ID (e.g. sho_0123...), the offer type ('reviews'), and a status of 'queued', indicating the evaluation has been accepted and will be conducted asynchronously. The full review report is delivered via the provided callback URL or contact email once completed.","failureModes":["Missing required fields (request_id, company, test_url, evaluation_goal, acknowledge_independence) returns a 400 validation error","Neither contact_email nor callback_url provided causes request rejection","acknowledge_independence must be explicitly true — false or absent will fail","test_url must be a publicly accessible HTTPS URL; private or localhost URLs will be rejected","Duplicate request_id values are treated as idempotent — same order returned without re-charging","Payment failure (insufficient USDC or x402 protocol error) prevents order creation","evaluation_goal under 40 characters is rejected as too vague"],"whenToPreferThis":"Choose this endpoint when an AI agent or procurement team needs independent, first-hand empirical evidence about a B2B vendor's actual service quality — not aggregated user reviews or marketing copy. It is especially valuable for due diligence before contracts, comparing competing vendors objectively, or verifying that a provider's technical claims hold up under real usage. Prefer this over generic review aggregators when you need reviews generated from actual test interactions rather than crowdsourced opinions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:38:05.497Z","isFirstParty":false}