SearchStax Site Search applies service limits to maintain stability and performance for all users and client applications.
This article lists Site Search service limits, including app-level request limits, payload and URL limits, Sandbox App limits, token and key maximums, and feature-specific caps.
Limits by Category
App-Level Request and Size Limits
| Limit | Maximum | Error Response |
|---|---|---|
| API requests per second | 20+ | 429 Error |
| Document size | 100 KB | Payload validation failure |
| Payload | 10 MB | 413 Error |
| Request size (query size) | 10 KB | 414 Error |
| URL length | 10,240 characters | 414 Error |
Sandbox App Limits (Sandbox-Enabled Accounts)
If your account supports Sandbox Apps, limits and usage are tracked by environment. See Production and Sandbox Apps for model details and UI behavior.
- Sandbox App capacity: 3 Sandbox Apps per Production App by default.
- Sandbox App add-ons: Additional capacity is available in account-level packs of 10.
- Monthly requests: 10,000 requests per Sandbox App.
- Rate limit: 5 requests per second per Sandbox App.
- Content items: Same as the Production App cap, up to 1M items, whichever is lower.
- Analytics retention: 30 days.
Service terms: Sandbox Apps don't include SLA or uptime commitments. Keep service terms separate from usage-limit planning when evaluating production readiness.
Security and Token Limits (Per App)
| Limit | Max Authentication Tokens and Keys |
|---|---|
| Search API | 10 |
| Discovery API | 10 |
| Analytics Tracking | 1 |
| Analytics Reporting | 1 |
| Profiles per App | 10 |
Other Technical Limits
| Feature | Limit |
|---|---|
| Custom Reports Conditions | 3 |
| Number of Facet Values | 50 |
| Number of Data Filters – Inclusions and Exclusion per Model | 20 |
| Number of Promoted Indexed Items per Promotion | 10 |
| Number of External Items | 100 |
| Max Upload File Size (Synonyms, Spellcheck, Auto-suggest, Related Searches) | 10MB |
Account-Level Administration Limits
Note: The App creation limit is 10 app creations per hour per account.
HTTP Status Codes and Error Handling (Limit Context)
| HTTP Code | When It Happens | Typical Response Body | What to Do |
|---|---|---|---|
429
|
Request-rate or plan-limit condition | Too-many-requests response | Retry with backoff and verify plan usage |
413
|
Payload exceeds limit | Content-length limit response | Reduce payload size |
414
|
Query, request line, or URL exceeds size limits | URI or request-too-large response | Reduce query or URL size |
500
|
Possible service-side impact during overage scenarios | Internal service error response | Verify subscription state and contact support if the issue persists |
For detailed troubleshooting, see 429 Error.
Tip: Monthly overage conditions can interrupt query service and surface 429 or 500 outcomes.
Pagination
Not applicable for this limits reference article.
Related Resources
Shared API Foundations
Use these shared references for authentication, request and response structure, and pagination behavior used across Site Search APIs: