---
title: "Seed Substack"
method: POST
path: "/v1/admin/substack/seed"
tags: ["substack-wedge"]
---

# Seed Substack

`POST /v1/admin/substack/seed`

## 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/admin/substack/seed`
- Auth: none declared

Crawl ``domain`` and persist one ``SubstackCandidate`` per
discovered post. Idempotent on ``post_url`` — re-running the
seed against an already-crawled newsletter only inserts net-new
posts (the unique index on ``post_url`` swallows duplicates).

## Headers

- `x-storyflo-email-token` string, nullable

## Request body

- SeedRequest
  - `domain` string, required

## Response `200`

Successful Response

- SeedResponse
  - `domain` string, required
  - `discovered` integer, required
  - `inserted` integer, required
  - `skipped_existing` integer, required

## 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)