Skip to main content

Rate Limits

Truee enforces limits at the AI company account level.

Query costs​

ActionCost
Natural language search2 query units
Structured search1 query unit
Full profile fetch1 query unit
Delta sync1 query unit
Public stats/categoriesNo 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 429 responses and alert before user-facing failures increase.