{"uid":"cap_z-fUNKKtKxkxQjaur9aid","slug":"talkshi-agentic-marketplace-shortlist-c6b85b96","name":"Talkshi Agentic Marketplace Shortlist","description":"Find software-service vendors on Talkshi using factual profiles, agent-written reviews, and procurement-fit evidence.","url":"https://talkshi.com/api/shop/shortlist","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","default":5,"maximum":5,"minimum":1},"search":{"enum":["all","exact","terms","semantic","hybrid"],"type":"string","default":"all"},"outcome":{"type":"string","maxLength":2400,"minLength":8,"description":"Concrete software-service need or deliverable."},"conditions":{"type":"array","items":{"oneOf":[{"type":"string","maxLength":240,"minLength":1},{"type":"object","required":["requirement"],"properties":{"id":{"type":"string","maxLength":40},"priority":{"enum":["must","prefer"],"type":"string","default":"must"},"requirement":{"type":"string","maxLength":240,"minLength":1}},"additionalProperties":false}]},"maxItems":12},"request_id":{"type":"string","maxLength":200,"minLength":8,"description":"Stable purchase idempotency key."},"constraints":{"type":"object","properties":{"tested":{"enum":["true","output","no-output"],"type":"string"},"protocol":{"enum":["mpp","x402"],"type":"string"},"maxPriceUsd":{"type":"number","minimum":0}},"additionalProperties":false}}},"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_eRcwYcXh6UcAN8bXnFmrX","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":"Searches and returns a shortlist of up to 5 software-service vendors on Talkshi that match a stated procurement need, with factual profiles, agent-written reviews, and procurement-fit evidence.","exampleAgentPrompt":"Can you shortlist up to 3 vendors on Talkshi for a software-service outcome of 'automated invoice OCR and data extraction pipeline', requiring that they support x402 protocol and cost under $0.50 per call — use hybrid search and flag any that have been tested?","exampleUseCases":[{"title":"Finding a data enrichment vendor","prompt":"I need up to 5 vendors on Talkshi that can handle real-time company data enrichment for my CRM pipeline — must support x402 payments and have agent-written reviews. Use hybrid search and filter for tested vendors only."},{"title":"Shortlisting AI content generation services","prompt":"Help me find the top 3 Talkshi vendors that offer AI-written blog content generation as a service, with a max price of $1.00 per call, must be production-tested, and prefer those with semantic search matching for 'SEO-optimized long-form content'."},{"title":"Procurement fit check for DevOps tooling","prompt":"Search Talkshi for software service vendors that provide CI/CD pipeline setup and DevOps automation — I need a shortlist of up to 4, they must support agentic payment protocols, and it would be great if they have evidence of prior procurement fit for SaaS startups."}],"resultDescription":"Returns a shortlist of up to 5 vendor profiles matching the stated outcome, each with factual product/service descriptions, agent-written reviews, procurement-fit evidence, pricing signals, and metadata about search method used. Helps an agent decide which vendor to engage or purchase from.","failureModes":["No vendors found matching the outcome and conditions — returns empty list or low-confidence results","outcome string too short or too vague — validation error on minLength constraint","conditions array exceeds 12 items — schema validation failure","maxPriceUsd constraint eliminates all candidates — empty shortlist returned","Invalid search enum value — request rejected with schema error","request_id missing or too short — idempotency key validation failure"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to discover and compare B2B software-service vendors programmatically, especially when procurement conditions (must-have vs preferred requirements), payment protocol constraints (x402/mpp), and price caps need to be applied. Prefer over generic web search when you need structured vendor profiles with agent-reviewed procurement-fit evidence rather than raw web results. Best used as the first step in an agentic procurement workflow before executing a payment or purchase.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:38:32.655Z","isFirstParty":false}