Skip to main content

​
API Tiers & Rate Limits

Our API offers three usage tiers designed to scale with your application needs. Each tier provides different rate limits and features to support everything from development and testing to enterprise-scale (and on-premises) production deployments.

​
Pricing Tiers

Developer

  • Ideal for prototyping and small applications
  • Simple rate limits to get you started
  • Community Discord Support
  • $5 in credits added to your account

Scale

  • Higher rate limits across all endpoints
  • Production-ready performance
  • Dedicated Slack Support
  • Custom rate limit discussions

Enterprise

  • Everything in the Scale tier, and…
  • Dedicated on-premises deployment
  • Custom integration assistance
  • SLA guarantees
All users start on the Developer tier automatically. To upgrade your tier, please contact us at [email protected] with the subject line “API Tier Upgrade”.

​
Default Rate Limits

Our rate limits are applied per organization and reset at the specified intervals. The limits below are the default values for each tier:

​
Developer Tier

EndpointLimitDescription
GET /journals/list25 requestsList user’s journals
GET /journals/content/{id}10 requestsGet journal content
POST /video/create3 requestsCreate new videos
POST /interactives/flashcards/create5 requestsGenerate flashcard sets
POST /interactives/practice/create3 requestsCreate practice problems
POST /interactives/practice/grade2 requestsGrade practice responses
EndpointLimitDescription
POST /video/create50 requestsDaily video creation limit
POST /interactives/flashcards/create100 requestsDaily flashcard generation

​
Scale Tier

EndpointLimitDescription
GET /journals/list100 requestsList user’s journals
GET /journals/content/{id}100 requestsGet journal content
POST /video/create10 requestsCreate new videos
POST /interactives/flashcards/create50 requestsGenerate flashcard sets
POST /interactives/practice/create10 requestsCreate practice problems
POST /interactives/practice/grade10 requestsGrade practice responses
EndpointLimitDescription
POST /video/create1,000 requestsDaily video creation limit
POST /interactives/flashcards/create2,000 requestsDaily flashcard generation

​
Enterprise Tier

EndpointLimitDescription
GET /journals/list10,000 requestsList user’s journals
GET /journals/content/{id}1,000 requestsGet journal content
POST /video/create100 requestsCreate new videos
POST /interactives/flashcards/create500 requestsGenerate flashcard sets
Practice endpointsCustom limitsContact us for requirements
EndpointLimitDescription
POST /video/create10,000 requestsDaily video creation limit
POST /interactives/flashcards/create20,000 requestsDaily flashcard generation

​
Handling Rate Limit Errors

When you exceed a rate limit, the API returns a 429 Too Many Requests response: 
{
  "error": "Rate limit exceeded for journal_list",
  "retry_after": 30,
  "limit_type": "minute"
}
Best Practices:
  • Implement exponential backoff when you receive 429 responses
  • Monitor the Retry-After header on rate limited operations to pace your requests
    • This is the best way to make sure that you don’t continue pinging endpoints that are throwing errors.
  • Cache responses when possible to reduce API calls
  • Use webhooks instead of polling for status updates for videos and problems.

​
Credits & Pricing

The Opennote API uses a direct monetary value pricing model. Different endpoints consume different amounts of money based on their computational complexity. Our pricing is flexible, and varies request-to-request. More detailed per-input and per-output pricing information is coming soon, and can be requested by contacting us at [email protected].

​
Managing Your Credits

  • View Balance: Check your current credit balance in the API Dashboard
  • Usage Tracking: Monitor credit consumption per endpoint in real-time
Auto-renewal and alerts are coming soon. When you need more credits, you can visit your API Dashboard and head to your Settings -> Billing tab, and click the Add Credits button.

​
Custom Rate Limits

Need higher limits for your application? We offer custom rate limit configurations for all tiers, which you can request by contacting us at [email protected] with the subject line “API Rate Limit Increase”.

​
Need Help?

  • Technical Support: [email protected]
  • Tier Upgrades: Include “API Tier Upgrade” in your subject line
  • Custom Limits: Include “API Rate Limit Increase” in your subject line
  • Billing Questions: Include “API Billing” in your subject line
We typically respond to all inquiries within 24 hours.