AutoFeed API

Reddit Story Video API

Send a subreddit and a comment count. AutoFeed writes an original story in that subreddit's style, narrates it, times the captions to the voice and lays it over a looping gameplay background, then hands you the MP4.

An original story written in the style of any subreddit, plus 0 to 10 replies read after it
Background gameplay from 5 pools: Minecraft, GTA V, Subway Surfers, Fortnite, Satisfying
Word-timed captions with preset or fully custom styling
Vertical 9:16 only, which is what this format is made for

One Request

This exact body passes the live API schema and costs 1,000 credits, the same as making it in the dashboard.

Request

curl -X POST https://www.autofeed.ai/api/v1/videos \
  -H "Authorization: Bearer $AUTOFEED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "reddit_stories",
    "input": {
      "subreddit": "AskReddit",
      "commentsCount": 3,
      "backgroundCategory": "Minecraft",
      "captionStyle": "YouTuber"
    },
    "webhookUrl": "https://example.com/webhooks/autofeed",
    "idempotencyKey": "order-1042-reddit-stories"
  }'

202 Accepted

{
  "id": "1c9d6c3e-1f5b-4d2e-9c31-2b8b0f0f9a11",
  "type": "reddit_stories",
  "status": "processing",
  "costInCredits": 1000,
  "createdAt": "2026-11-02T12:00:00.000Z"
}

Webhook: video.completed

{
  "id": "1c9d6c3e-1f5b-4d2e-9c31-2b8b0f0f9a11",
  "type": "reddit_stories",
  "status": "completed",
  "error": null,
  "costInCredits": 1000,
  "createdAt": "2026-11-02T12:00:00.000Z",
  "completedAt": "2026-11-02T12:03:41.000Z",
  "url": "https://.../1c9d6c3e-1f5b-4d2e-9c31-2b8b0f0f9a11.mp4"
}

A Reddit story render with gameplay background, made by the pipeline this API calls.

Every Input Field

Read from the API's own schema. Unknown fields are rejected with a 400, never silently dropped.

Field	Type	Default	Notes
`author`	string (max 100)	"AutoFeed.ai"
`subreddit`	string	"AskReddit"	The subreddit whose style the story is written in. Any name, not only the dashboard suggestions.
`flairs`	string (max 500)	"" (none)
`commentsCount`	integer 0-10	3	How many replies are read after the story. Capped at 10, because each one adds narration at a flat price.
`backgroundCategory`	"Minecraft" \| "GTA V" \| "Subway Surfers" \| "Fortnite" \| "Satisfying"	"Minecraft"	The gameplay pool. The clip itself is picked at random from that pool on our side.
`music`	string (max 255)	"none"
`voice`	string	"JBFqnCBsd6RMkjVDRZzb"
`captionStyle`	one of 14 values	"YouTuber"
`customCaptions`	object	-	Required when captionStyle is "Custom". Any field you leave out comes from the preset.

What It Costs

The API is included with Ultimate and spends the same credits as the dashboard. Ultimate's 180k monthly credits cover about 180 requests like the one above. Rendered files are kept for 14 days.

See every Ultimate size →

Reddit Stories API Questions

Are these real Reddit threads?

No. The story and the replies are written fresh for every request, in the style of the subreddit you name, so there is no third-party post in the video and no thread to pick. You choose the subreddit, optional flairs and how many replies to read.

Can I get a horizontal Reddit video?

Not from this type. Reddit Stories renders 9:16 only, and the schema has no format field for it, so sending one is a 400 rather than a silently ignored setting.

How is a Reddit story video billed?

From the same credit balance as the dashboard, at the same price per video. The cost is in the 202 response before any work starts, and a failed render refunds it.

What the Reddit Stories API returns