Trawley meters API usage against your team's plan. Each plan includes a monthly allowance of API calls, counted per billing period.
How metering works
- Search calls (the hybrid endpoint) count against your monthly search allowance.
- Results calls (the results endpoint) count against a separate monthly results allowance.
- Exports are counted as a fractional call, so bulk downloads do not burn a full request each.
Allowances reset at the start of each billing period.
Hitting a limit
When you exceed an allowance, the API responds with 429 Too Many Requests and
a message naming the limit:
json
{
"statusCode": 429,
"statusMessage": "Monthly search API limit reached (1000). Upgrade your plan for more calls."
}
Handle 429 by backing off until the next billing period or upgrading the plan.
In an agent, catch it and return a graceful "search is temporarily unavailable"
message rather than failing the whole turn.
Raising your limits
Limits scale with your plan. See billing and plans for current allowances and how to upgrade. You can view current usage against your allowance in the dashboard.