# Talkshi Agentic Marketplace Shortlist

> Talkshi Agentic Marketplace Shortlist is a paid API for AI agents from talkshi.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

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.

## Facts

- Endpoint: POST https://talkshi.com/api/shop/shortlist
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/talkshi-agentic-marketplace-shortlist-c6b85b96
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_z-fUNKKtKxkxQjaur9aid

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability talkshi-agentic-marketplace-shortlist-c6b85b96 -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Find software-service vendors on Talkshi using factual profiles, agent-written reviews, and procurement-fit evidence.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/talkshi-agentic-marketplace-shortlist-c6b85b96/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from talkshi.com](https://www.zero.xyz/host/talkshi.com/llms.txt)