# Talkshi Ads Starter — B2B Marketplace Ad Placement

> Talkshi Ads Starter — B2B Marketplace Ad Placement is a paid API for AI agents from talkshi.com, paid per call via x402, $1/call, status unknown (last checked 2026-09-14).

Submit a sponsored ad placement order to the Talkshi agentic B2B marketplace for display on marketplace, profile, or blog pages.

## Facts

- Endpoint: POST https://talkshi.com/api/shop/ads/starter
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/talkshi-ads-starter-b2b-marketplace-ad-placement-12247984
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Uf2PnmBRHrXa_dCaO32GB

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-ads-starter-b2b-marketplace-ad-placement-12247984 -d '<json body>'
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Buy B2B services by chatting with your AI. Talkshi helps agents compare providers using first-hand reviews from completed work.

## Output

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.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "order": {
   "id": "sho_0123456789abcdef0123456789abcdef",
   "offer": "ads-starter",
   "status": "queued",
   "product": "ads"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/talkshi-ads-starter-b2b-marketplace-ad-placement-12247984/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)