API Reference
API Limits
The FAQSIR API enforces rate limits and usage quotas to ensure fair usage and platform stability. Limits vary by endpoint and subscription plan.
Rate Limits
Stats Endpoint
The /stats endpoint has a dedicated rate limit to handle high-volume analytics ingestion:
| Limit | Value |
|---|---|
| Requests per minute | 1,200 |
| Max events per request | 100 |
When the rate limit is exceeded, the API returns a 429 Too Many Requests response with a Retry-After header indicating how many seconds to wait before retrying.
{
"message": "Too Many Attempts."
}
The rate limiter identifies clients by API token. If no token is present, the client IP address is used as a fallback.
Widget handles this automatically
The FAQSIR widget includes built-in retry logic with exponential backoff. If the stats endpoint returns a 429, the widget will queue events and retry after the Retry-After period. You do not need to implement retry logic when using the standard widget.
Other Endpoints
The /source and /chat endpoints do not have explicit per-minute rate limits, but are subject to the usage quotas described below.
Usage Quotas
Usage quotas are tied to your subscription plan and reset monthly on your billing date. These quotas control how many resources you can create and consume.
Press Releases (Sources)
All plans include unlimited press releases (sources) per month. There is no cap on the number of unique page URLs you can process.
Deduplication
Sources are deduplicated by URL within each site. The same URL submitted multiple times within a billing period is only processed once — the cached content is returned for subsequent requests.
Video Generations Per Month
Video summary generation is available on Plus and Pro plans. Each plan includes a monthly video generation allowance, with the option to purchase additional credits.
| Plan | Video Generations Per Month |
|---|---|
| Starter | 0 |
| Plus | 2 |
| Pro | 5 |
Additional video credits can be purchased separately. See Video Credits for pricing and details.
Event Validation
The /stats endpoint validates each event in a batch:
| Rule | Description |
|---|---|
occurred_at must be within the last 24 hours |
Events older than 24 hours are rejected |
occurred_at must not be more than 5 minutes in the future |
Prevents clock-skew abuse |
| Maximum 100 events per batch | Larger payloads are rejected with a 422 error |
Data Retention
FAQSIR retains analytics data according to the following schedule:
| Data Type | Retention Period |
|---|---|
| IP addresses | 30 days (GDPR compliance) |
| Raw event data | 90 days |
| Aggregated hourly rollups | Indefinite |
| Aggregated daily rollups | Indefinite |
After the raw data retention period, individual events are pruned and only aggregated data remains available in the engagement dashboard.
Privacy by design
IP addresses are automatically purged after 30 days to comply with GDPR and privacy regulations. Anonymous visitor IDs are hashed using a server-side salt, ensuring visitor tracking is privacy-preserving.
Monitoring Your Usage
You can monitor your current usage from the Billing page in the FAQSIR dashboard. The usage section shows a visual indicator for each quota:
- Normal — You are within your plan's allowance
- Warning — You have used more than 80% of your quota
- Critical — You have reached or exceeded your quota
Next Steps
Status Codes
Full reference of all HTTP status codes the API may return.
Plans & Pricing
Compare plans and find the right quota for your needs.
Billing
View your current usage and manage your subscription.
Source Endpoint
API reference for the source content endpoint.