---
title: "Marketplace Sponsored Listing"
method: POST
path: "/v1/marketplace/sponsored-episodes"
---

# Marketplace Sponsored Listing

`POST /v1/marketplace/sponsored-episodes`

## Request

- Base URL: `https://api.storyflo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.storyflo.com/v1/marketplace/sponsored-episodes`
- Auth: none declared

D-2.5 · Public submission endpoint for sponsored-episode bids.

A merchant fills out the form on /partner/sponsor with:
  - which article they want to sponsor (article_slug)
  - sponsor name + url + 30-second creative text
  - bid_micros_per_play (the price they'll pay per completed listen)

We return a placeholder review status; an operator approves
via /admin/sponsorships/{id}/approve in a follow-up. The submission
itself is bounded by the existing rate limiter, IP-logged for
abuse triage.

## Headers

- `idempotency-key` string, nullable

## Request body

- SponsoredListing
  - `article_slug` string, required
  - `sponsor_name` string, required
  - `sponsor_email` string, nullable
  - `sponsor_url` string, nullable
  - `creative_text` string, nullable
  - `bid_micros_per_play` integer, required
  - `starts_at` string, nullable
  - `ends_at` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/storyflo/apis/storyflo-inference-router.md) · [All operations](https://skmtc.dev/storyflo/apis/storyflo-inference-router/llms.txt) · [OpenAPI document](https://skmtc.dev/storyflo/apis/storyflo-inference-router/revisions/c3a1a735ac7a?raw)