Rate Limits
Truee enforces limits at the AI company account level.
Query costs
| Action | Cost |
|---|---|
| Natural language search | 2 query units |
| Structured search | 1 query unit |
| Full profile fetch | 1 query unit |
| Delta sync | 1 query unit |
| Public stats/categories | No private query cost |
Natural language search costs more because Truee first parses intent, category, and location before searching.
Limits
Limits are controlled by the AI company package and billing configuration.
When a limit is reached, the API returns 429 with an error code explaining whether the account hit a daily, monthly, or plan-level quota.
Production guidance
- Prefer structured search when your agent has already parsed the request.
- Cache full business profiles where your product can safely do so.
- Use delta sync instead of repeatedly fetching every profile.
- Monitor
429responses and alert before user-facing failures increase.