Documentation / Getting Started / Usage and Daily Limits

Usage and Daily Limits

Check how many calls your account has left today and who used them.

One count for the web app, MCP, and the API

  • Counted calls from the web app, MCP server, and API all use the same daily counts.
  • The counts belong to the account owner. Team members' calls count too.
  • The day runs from 04:00 to 04:00, New York time. The counts reset at 04:00.

The daily limits

  • Index searches: one shared count for all News Index and Prospect Index tools. OppAlerts 250: 300. OppAlerts 500: 1,000. OppAlerts 1000: 3,000. Free account: 10.
  • Backlink, PageRank, and Site Info tools: a count for each tool. OppAlerts 250: 300. OppAlerts 500: 1,000. OppAlerts 1000: 3,000. Free account: 10.
  • Campaign, account, LLM answer, taxonomy, and type tools: a count for each tool. OppAlerts 250: 300. OppAlerts 500: 1,000. OppAlerts 1000: 3,000. Free account: 10.
  • account_calls_left: a count of its own. OppAlerts 250: 3,000. OppAlerts 500: 10,000. OppAlerts 1000: 30,000. Free account: 100.
  • On a free account, one index search gives at most 100 results.

Each account can run only one index search at a time and only one change at a time. Another search sent during a search, or another change sent during a change, is rejected immediately with HTTP 429 and does not count toward the daily limit. Wait a few seconds and try again. See How the API Handles Requests.

Which calls count

  • Each API and MCP tool call counts. The calls that an MCP client makes to connect (initialize, tools/list, ping) do not count.
  • In the web app, searches, site lookups, and saves count. A page that only reads your account data does not count, for example the campaign list, the tabs of Edit Campaign, Usage, and Team.
  • Rejected calls do not count toward the daily limit. This includes calls with unknown fields or invalid values.
  • A search that is stopped at 10 seconds counts as 1 search. The search used server resources, and counting it prevents abuse.

When a count is used up

  • The call returns HTTP 429.
  • account_calls_left shows the calls left today for each count.

See who used the calls

The Usage page, https://oppalerts.com/app/account/usage, shows account usage by token and day for the last 14 days, along with recent calls and their status. In the profile menu, choose Usage. Usage explains the page. An agent reads the same data with account_usage.