Copy page

Usage, Limits & Reliability

Rate Limits Overview

The IntelCenter API enforces rate limits and quotas to ensure fair usage and system stability.

Limits vary depending on endpoint type and API key tier.

---

Rate Limit Types

Search Endpoints

Applies to:

• /videos
• /images
• /nl-search

Limits:

• Requests per minute

---

Detail & Media Endpoints

Applies to:

• /videos/{uuid}
• /images/{uuid}
• /player
• /viewer

Limits:

• Requests per minute

---

Domain GenAI Endpoints

Applies to:

• /domain-genai

Limits:

• Requests per minute
• Requests per hour
• Requests per day

These endpoints have stricter limits due to higher computational cost.

---

Quotas

In addition to rate limits:

• Daily request quotas may apply
• Monthly request quotas may apply

---

When Limits Are Exceeded

The API returns:

• 429 Too Many Requests

Example:

Code
{
  "error": "quota_exceeded",
  "message": "This API key exceeded a usage or rate limit and the request was blocked."
}

---

Best Practices

• Implement retry logic with backoff
• Cache results when possible
• Avoid unnecessary repeated requests
• Use pagination efficiently

---

Tip

Domain GenAI endpoints should be used sparingly and only when needed due to stricter limits.