Skip to main content

​
Two kinds of limits

Pull/story applies two independent limits to story creation and polling:
  1. Rate limit — how many requests per minute you can make
  2. Minute quota — how much generated video you can create per month

​
Rate limits

Endpoint typeLimit
POST /api/v1/stories (creation)10 / minute
GET /api/v1/stories/:id (polling)120 / minute
Auth failures and other protected API trafficbest-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

PlanVideo minutes per monthPrice
Free10 min$0
Pro120 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();
  }
}

​
Need more?

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