Rate Limits

Two kinds of limits

Pull/story applies two independent limits to story creation and polling:

Rate limit — how many requests per minute you can make
Minute quota — how much generated video you can create per month

Endpoint type	Limit
`POST /api/v1/stories` (creation)	10 / minute
`GET /api/v1/stories/:id` (polling)	120 / minute
Auth failures and other protected API traffic	best-effort IP throttling

When exceeded you receive:

HTTP 429 Too Many Requests

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Retry after 18 seconds.",
    "retry_after": 18
  }
}

The Retry-After HTTP header is also set.

Minute quota

Plan	Video minutes per month	Price
Free	10 min	`$0`
Pro	120 min	`$19 / mo`

Each generated pull story consumes minutes equal to its video duration. A short brief is usually ~1 minute; a large brief is 3-5 minutes. When you run out of minutes:

HTTP 402 Payment Required

{
  "error": {
    "code": "insufficient_minutes",
    "message": "Monthly video quota exceeded.",
    "minutes_remaining": 0,
    "minutes_required": 3,
    "upgrade_url": "https://pullstory.com/dashboard"
  }
}

Handling limits in your code

async function createStory(payload) {
  for (let attempt = 0; attempt < 3; attempt++) {
    const res = await fetch("https://pullstory.com/api/v1/stories", {
      method: "POST",
      headers: {
        Authorization: `Bearer ${process.env.PULLSTORY_API_KEY}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify(payload),
    });

    if (res.status === 429) {
      const retryAfter = Number(res.headers.get("retry-after") ?? 10);
      await new Promise((r) => setTimeout(r, retryAfter * 1000));
      continue;
    }

    return res.json();
  }
}

import time
import requests

def create_story(payload):
    for attempt in range(3):
        r = requests.post(
            "https://pullstory.com/api/v1/stories",
            headers={"Authorization": f"Bearer {API_KEY}"},
            json=payload,
        )
        if r.status_code == 429:
            time.sleep(int(r.headers.get("Retry-After", 10)))
            continue
        return r.json()

Need more?

If 120 minutes isn’t enough for your team, email us — we’ll get you on a custom plan.

Getting Started

Integrations

Rate Limits

Two kinds of limits

Rate limits

Minute quota

Handling limits in your code

Need more?

​Two kinds of limits

​Rate limits

​Minute quota

​Handling limits in your code

​Need more?

Two kinds of limits

Rate limits

Minute quota

Handling limits in your code

Need more?